Overview

Scatter is a JavaScript library for randomly arranging HTML elements within a containing element.

The main use case is an image gallery, but the library does not restrict what it can be used for - it can provide a scattered polaroid photo effect as easily as using decorative images to provide a randomized background, or any other reasons for scattering items your imagination can come up with.

Documentation • Repository

License:

LGPL v3

Latest Release:

v0.1.1, 23 Oct 2021 (announcement)

Requires:

Any modern browser *

* The browser must support Object.assign and Array.from methods, which have both been provided by all major browsers since 2015. Using polyfills allows Scatter to work with earlier browsers, including Internet Explorer 11.0.9600, and perhaps as early as Firefox 3.6. With a polyfill for Element.classList it might work as far back as IE9, but this has not been tested, and is not supported.

Features

• Scatter any elements with: new Scatter(selector,options)
• Multiple modes for control over how items are arranged.
• Optional item selection can be ad-hoc or iterated.
• Compatible with touch events on appropriate devices.
• Minimal restrictions on markup and styling.
• Zero dependencies - uses a single JS file.

See the documentation for further information, configuration options, and examples of use.

Download

• scatter-v0.1.1.zip (64KB)

Package includes scatter.js plus documentation and demo files.

$ sha256sum scatter-v0.1.1.zip
4ce635c037a7429150c8e50489d999f6b47a13c452e064b3d08a3e76c45dd9a3 *scatter-v0.1.1.zip