A small library for creating marquees.

Features:

• You can change the rate on the fly.
• Direction can either be up/down or right/left.
• Width/height of items and container is allowed to change.
• Container width/height is updated correctly to match maximum size of current items.
• You can add an item at any time when space is available, and it will start off screen.

A loop() helper function is also provided which makes creating a carousel with looping content simple.

View the demo here.

View the code at "demo.html".

npm install --save dynamic-marquee

import { Marquee } from 'dynamic-marquee';

or

<script type="text/javascript" src="https://cdn.jsdelivr.net/npm/dynamic-marquee@1"></script>
<script type="text/javascript">
  const Marquee = dynamicMarquee.Marquee;
</script>

thanks to jsDelivr.

const marquee = new Marquee(document.getElementById('marquee'));

const marquee = new Marquee(document.getElementById('marquee'), {
  rate: 20, // 20 pixels/s downwards
  upDown: true // downwards instead of to the right
});

You can add DOM elements, or just a string (which will automatically be wrapped in a div).

Each DOM element is only allowed on the marquee at one time.

const $item = document.createElement('div');
$item.textContent = 'testing123';
marquee.appendItem($item);

You are only allowed to append an item when there is room. You can check this like so:

if (marquee.isWaitingForItem()) {
  marquee.appendItem($item);
}

You can be notified when an item is required with

marquee.onItemRequired(({ immediatelyFollowsPrevious }) => {
  // for convenience if you have an item ready to go you can just return it
  // in place of `marquee.appendItem($item);`

  // if `immediatelyFollowsPrevious` is `true`, this would be a good time to add
  // a seperator on the side that is entering the screen first. See loop.js
  // for an example.
  return $item;
});

Do not perform any long running tasks in this method as it will block rendering.

If you need to perform some work in this method consider wrapping it in a setTimeout with delay 0.

You can change the rate at any time, and set to 0 to pause.

marquee.setRate(-20);

To remove all items call

marquee.clear();

You can be notified when an item has been removed with:

marquee.onItemRemove(($el) => {
  // $el has just been removed
});

You can be notified when the scroller is empty with:

marquee.onAllItemsRemoved(() => {
  //
});

You can check at any time with:

marquee.getNumItems();

A loop() function is provided for making looping content simple.

You provide an array of functions which return a DOM element, or string for that item. You can update this on the fly by calling the provided update() method.

When returning DOM elements each function should build the element from scratch, as the same DOM element is not allowed to appear on the marquee multiple times.

const $marquee = document.getElementById('marquee');
const marquee = new Marquee($marquee);
const control = loop(marquee, [
  () => 'item 1',
  () => 'item 2'
]);

// later
control.update([
  () => 'new item 1',
  () => 'new item 2'
])