Cross domain iframe communication
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
build
src
.gitignore
LICENSE
README.md
gruntfile.js
package.json

README.md

Messager

Messager is a lightweight (1kb Gzipped) dependancy free wrapper for postMessage API. Messager allow you to send event to and from an iframe, cross domain or not.

Installation

Just include the minified version of MiniMasonry.js on your website :

<script src="messager/build/messager.min.js"></script>

Usage

Messager should be instanciated on both iframe and parent page.

On the host website :

var iframe = document.getElementById('myFrame');
var messager = new Messager({
    remoteWindow: iframe.contentWindow,
    local: "http://hostaddress.com/",
    remote: "http://iframeaddress.com/"
});

On the iframe's website :

var messager = new Messager({
    remoteWindow: window.parent,
    local: "http://iframeaddress.com/",
    remote: "http://hostaddress.com/"
});

Then, from the iframe or the host website, you can send event like this :

messager.send('eventName', {param: 'value'});

And listening to this event like that :

messager.on('eventName', callback);

The callback function will receveive the given parameters as argument.

Parameters

Here is the list of available parameters :

Name Default value Description
local null Hostname of the current website (iframe hostname or parent hostname). Required
remote null Hostname of the remote website (iframe hostname or parent hostname). Required
remoteWindow null Window object of the remote website. Required
window window Window object of the local website.

API

Here is the list of available APIs :

Name Description
send('eventName', parameters) Function to send event and parameters to the iframe / host.
on('eventName', callback) Callback to execute on the iframe or host to execute when receiving an event.

Example

See website

License

MIT

Made by Spope