Remember and restore form state using localStorage
JavaScript CSS Ruby
Switch branches/tags
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
source Update jquery.remember-state.js Aug 21, 2014
.gitignore Add selectors for confirm/cancel, redesign site Sep 28, 2013
.ruby-gemset Add selectors for confirm/cancel, redesign site Sep 28, 2013
.ruby-version
Gemfile
Gemfile.lock Add selectors for confirm/cancel, redesign site Sep 28, 2013
README.md Add ability to call restoreState manually Jul 24, 2014
config.rb Setup Middleman build config Sep 28, 2013
rememberState.jquery.json

README.md

jQuery form remember state plugin

Version: 1.4.1

When called on a form element, localStorage is used to remember the values that have been input up to the point of either saving or unloading. (closing window, navigating away, etc.) If localStorage isn't available, nothing is bound or stored.

By default, the plugin looks for an element with a class of remember_state within the form to show a note indicating there is stored data that can be repopulated by clicking on the anchor within the remember_state container. If the element doesn't exist, it is created and prepended to the form. You can override the selector and the HTML that is prepended in the options object you pass to the plugin.

Options

clearOnSubmit: true // Removes localStorage object when form submitted. Default is true
noticeDialog: $("<div />").html("<a href=\"#\">Restore</a>") // A newly created HTML element to represent the notice box prepended to the form. Must include an anchor for the user to choose to restore state
noticeSelector: ".remember_state" // If your noticeDialog already exists in the form, pass its selector here and clear out the noticeDialog option by setting it to false.
noticeConfirmSelector: "a" // Selector to use relative to the notice dialog to bind the confirm action to.
noticeCancelSelector: "" // Selector to use relative to the notice dialog to bind the cancel action to.
objName: "unique_form_name" // Specify a name for the localStorage object. If none is supplied, the form's ID will be used. If no ID is available, the plugin will fail, issuing a log explaining why.
ignore: null // Supply an array of name attributes for form controls that you'd like to ignore.

Usage

$("form").rememberState("my_object_name");

To restore the saved form state manually rather than use a notice dialog:

$("form").rememberState("restoreState");

If you'd like to save the form's state manually, call the rememberState method on the form after you've initialized it and pass it a string of save, like this:

$("form").rememberState("save");

There is also a teardown method for removing the bound events for a particular form. Passing a second argument of true will also destroy the localStorage object for that form.

$("form").rememberState("destroy", true);

Notes

To trigger the deletion of a form's localStorage object from outside the plugin, trigger the reset_state event on the form element by using $("form").trigger("reset_state");

Latest site design by Daniel Ariza