Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Topic-based Javascript PubSub for vanilla, jQuery and Underscore
JavaScript
branch: master

README.txt

Subtopic provides topic-based PubSub for javascript. Originally based on Peter Higgins' port from Dojo to JQuery and updated with support for message chaining inspired by Morgan Roderik's PubSubJS.

Full documentation here: http://pmelander.github.com/Subtopic/

Vanilla javascrip:
subtopic.subscribe(topic, callback);
subtopic.unsubscribe(topic);
subtopic.publish(topic, [payload]);

Underscore:
_.subscribe(topic, callback);
_.unsubscribe(topic);
_.publish(topic, [payload]);

jQuery:
$.subscribe(topic, callback);
$.unsubscribe(topic);
$.publish(topic, [payload]);

Performance:
Check out the official performance comparison here:
http://jsperf.com/pubsubjs-vs-jquery-custom-events/50

Topic chaining:
To use topic chaining divide your topics using forward slashes e.g. app/region/module/event
A subscriber will execute the callback function for the subscribed topic and any sub-topics.

The following publications will each invoke the callback for a subscription to app/region:
_.publish("app/region", []);
_.publish("app/region/module", []);
_.publish("app/region/module/event", []);

Something went wrong with that request. Please try again.