elm-pub-sub-ports

0.1.3 • Public • Published

Elm PubSub Ports Build Status

Cross-application communication between Elm apps via the publish-subscribe model.

Quick Start

1. Install via NPM

$ npm install --save elm-pub-sub-ports

2. In elm-package.json, import Ports/PubSub.elm

Add node_modules/elm-pub-sub-ports/lib/elm to your source-directories:

// elm-package.json
 
{
    // ...
 
    "source-directories": [
        "../../node_modules/elm-pub-sub-ports/lib/elm", // Exact path to node_modules may be different for you
        "./"
    ],
 
    // ...
}

3. Use it in your Elm code

-- Publish from an Elm app
 
 
update msg model =
  case msg of
    SendSomeMessage ->
      (model, Ports.PubSub.broadcast ("someEventHappened", Json.Encode.string "This is the payload")
-- Receive message in another Elm app
 
 
type Msg
  = ReceiveBroadcast (String, Json.Encode.Value)
 
 
subscriptions model =
  Ports.PubSub.receiveBroadcast ReceiveBroadcast
 
 
update msg model =
  case msg of
    ReceiveBroadcast ("someEventHappened", payload) ->
      case Json.Decode.decodeValue Json.Decode.string payload of
        Ok payload_ -> -- payload_ == "This is the payload"
          -- Do something with payload_

4. Register your Elm app in JavaScript

Using Elm Router

var pubSubPorts = require('elm-pub-sub-ports');
elmRouter.start(Elm, [pubSubPorts]);

Without Elm Router

var pubSubPorts = require("elm-pub-sub-ports");
var appSendingMessages = Elm.AppSendingMessages.embed(document.getElementById("app-sending-messages-container"));
var appReceivingMessages = Elm.AppReceivingMessages.embed(document.getElementById("app-receiving-messages-container"));
 
pubSubPorts.register(appSendingMessages.ports);
pubSubPorts.register(appReceivingMessages.ports);

API Reference

View the full API reference here.

Questions or Problems?

Feel free to create an issue in the GitHub issue tracker.

Package Sidebar

Install

npm i elm-pub-sub-ports

Weekly Downloads

1

Version

0.1.3

License

MIT

Unpacked Size

102 kB

Total Files

9

Last publish

Collaborators

  • paulstatezny