Upgrade Guide

Formstone started life as a stop-gap between what developers wanted from the web and the current state of browser technology (at the time). Formstone 2.x represents a full rewrite following modern development and accessibility practices with a focus on core UI patterns like Background, Lightbox, Navigation, Swap, and Tabs. Many legacy components have been removed in favor of widely supported native features or alternative solutions.

Dependencies

Formstone is now written in ES6 with zero dependencies. jQuery adaptors are still available.

Usage

Formstone is now module-based, with multiple installation methods supported.

Import only what you need from formstone
Initialize via component methods (for example Background.construct(...))
Use Utils.ready(...) for setup timing

import { Background, Utils } from 'formstone';

Utils.ready(() =&gt; {
  Background.construct('.js-background', {
    source: '...'
  });
});

Removed

Many of these have been superseded by native browser support, others may return as needed.

Grid
Analytics
ASAP
Carousel
Checkbox
Dropdown
Equalize
Number
Pagination
Range
Scrollbar
Sticky
Tooltip
Touch
Transition
Upload