postit-js

1.1.7 • Public • Published

PostIt

An elegant wrapper for postMessage.

Unit Test Coverage Known Vulnerabilities

Installation

Install postit-js as a dependency.

$ npm install --save postit-js

Run PostIt in a Browser

HTML Script Element

<script src="path/to/postit.js"></script>

CommonJS Browser Shimming (Browserify and Other Flavors)

var PostIt = require('postit');

API Documentation

.add(id) => object

Creates and manages a PostIt instance (id).

Param Type
id string
PostIt.add('baz');

.remove(id) => object

Removes a PostIt instance (id).

Param Type
id string
PostIt.remove('baz');

.removeAll() => object

Removes all PostIt instances.

PostIt.removeAll();

.size() => number

Returns the length of all PostIt instances.

PostIt.size();

.get(id) => object | void

Gets a PostIt instance (id).

Param Type
id string
PostIt.get('baz');

.getAll() => object

Gets all PostIt instances.

PostIt.getAll();

.on(id, event, listener) => object

Registers a listener to a PostIt instance (id), for a given event.

Param Type
id string
event string
listener function
PostIt.on('baz', 'bar', function(event) {
    // ...
});

.off(id, event[, listener]) => object

  • If a listener is not provided, then unregister all listeners from a PostIt instance (id), for a given event.
  • If a listener is provided, then unregister a listener from a PostIt instance (id), for a given event.
Param Type
id string
event string
[listener] function
PostIt.off('baz', 'bar');
 
function bazBar() {}
 
PostIt.off('baz', 'bar', bazBar);

.emit(id, event, target, message, origin) => object

  • If event is an asterisk (*), then emit an event to all listeners registered to a PostIt instance (id), for all given events.
  • If event is not an asterisk (*), then emit an event to all listeners registered to a PostIt instance (id), for a given event.
Param Type
id string
event string
target object
message string array object
origin string
PostIt.emit('baz', 'bar', window.parent.opener, { baz: 'bar' }, 'http://www.baz.com');

.openWindow(url, name, options) => object

Loads a resource into a new browsing context (window).

Param Type
url string
name string
options object
options.width number
options.height number

See: window.open for more options.

PostIt.openWindow('http://www.foo.com', 'foo', {
    width: 700,
    height: 500
});

Example

Example

Contributing

Contributing

Changelog

Changelog

License

MIT License

Package Sidebar

Install

npm i postit-js

Weekly Downloads

1

Version

1.1.7

License

MIT

Last publish

Collaborators

  • coopersemantics