ui-message-queue AKA User Message Queue Javascript implementation
Description
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:
- Add messages to queue; displayed in FIFO order.
- Select the DOM element to update, falling back to Javascript Alert if not found.
- No jQuery! Whilst fantastic as it is, can be a pain to have to include jQuery just for one library so we're jQuery free zone.
Contents
This repository contains the following sections:
src
- this contains the source Coffeescript.lib/UiMessageQueue-release.js
- the source is then compiled into this Javascript file (copy this to use!).test/spec/*_spec.coffee
- the tests implemented in Jasmine.test/html/index.html
- some real life html with proper Javascript to test this project.- A working demo is available here - check it out to see what UiMessageQueue can do.
Getting started
How to use:
-
Copy Javascript source from
lib/UiMessageQueue-release.js
to project -
Import source file
<script type="text/javascript" src="UiMessageQueue-release.js"></script>
- Options
Takes options in the form of an object literal:
options = {
outputElementId: "output-id",
delay: TIME_IN_MSECS,
emptyDisplayString: "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 box
- delay [OPTIONAL] - Time in milisecs to display each message for. Throws "Invalid argument" Error if not numeric. Default val is 1000
- emptyDisplayString [OPTIONAL] - This is message displayed when no messages are in the queue. Default val is "..."
If no options passed then it throws "Missing arguments" Error.
- Create instance of object passing options
var messageQueue = new UiMessageQueue(options);
- 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 FIFO method with each message for that set period of time.
See the demo for a cool, super useful example.
Contributions
Please use the GitHub pull-request mechanism to submit contributions.
Edit the coffeescript source and then compile to js - Do not edit UiMessageQueue-release.js
Testing
Checkout the Cakefile
for build and test commands.
# do a build for the test suite
cake build.test
# run tests
cake test
Code style
Run CoffeeLint over the source:
cake test.quality
# or the indentical call
coffeelint src/
Build
To produce a release build, run the build script; this compiles to JS and merges into one file to produce src/UiMessageQueue-release.js
.
cake build.release
License
This project is available for use under the MIT software license. See LICENSE