ui-message-queue is a Javascript implementation of a message queue allowing you to push messages (simple Strings) to the queue and display in a DOM element via a First In First Out (FIFO) method. This means that you can load up messages and they each have a defined display time after which will be overwritten with the next message or cleared.
The goal is to be as simple as possible to include and use, it's meant for displaying messages to website users rather than queuing backend type tasks.
Check out a demo here.
Features:
1) Get hold of the library:
Install from bower.io
$ bower install ui-message-queue --save
Copy Javascript source from lib/ui-message-queue.min.js
or lib/ui-message-queue.js
to your project.
2) Import source file.
<script type="text/javascript" src="https://github.com/rob-murray/ui-message-queue/raw/master/ui-message-queue.min.js"></script>
Or however you require libraries.
3) Configuration
Takes options in the form of an object literal:
options = {
outputElementId: "output-id",
delay: 2000,
emptyDisplayString: "A String"
};
These are as follows:
outputElementId
- [OPTIONAL] - The ID of the element in the DOM to add messages to. If this is not found then ui-message-queue falls back to using the alert popup boxdelay
- [OPTIONAL] - Time in milisecs to display each message for. Throws "Invalid argument" Error if not numeric. Default value is 1000 or 1 second.emptyDisplayString
- [OPTIONAL] - This is message displayed when no messages are in the queue. Default val is "..."4) Create instance of object passing options.
var messageQueue = new UiMessageQueue(options);
5) Add messages to the queue.
messageQueue.push("Here is a message");
messageQueue.push("Here is another one");
messageQueue.push("Finally, one more message");
These will be displayed in a first in-first out manner with each message displayed for the set period of time.
See the demo for a cool, super useful example.
Please use the GitHub pull-request mechanism to submit contributions.
Edit the coffeescript source and then compile to js - Do not edit ui-message-queue.js
This repository contains the following sections:
src
- this contains the source Coffeescript.lib/ui-message-queue{.min}.js
- the source is then compiled into Javascript and minified (copy this to use!).test/*_spec.coffee
- the tests implemented in Mocha and Chai.example/index.html
- some real life html with proper Javascript to test this project.Run all tests.
$ grunt test
Run CoffeeLint over the source:
$ grunt coffeelint
To produce a release build, run the build script; this compiles to JS and merges into one file to produce src/ui-message-queue.js
and lib/ui-message-queue.min.js
.
$ grunt build
This project is available for use under the MIT software license. See LICENSE