jquery.dirtyforms.helpers.alwaysdirty

jquery.dirtyforms.helpers.alwaysdirty

This is a helper module for the jQuery Dirty Forms project.

Purpose

This helper causes Dirty Forms to always show a dirty status, effectively overriding the logic that causes the form to be dirty when one of the input or select HTML controls is updated. It was primarily written to demonstrate how to write a custom helper, but may also be helpful in real-world scenarios where you don't want the user to navigate from the page without their explicit consent.

Prerequisites

Prerequesites must be included in this order:

• jQuery (>= 1.4.2)
• jquery.dirtyforms

If you are using a Package Manager, these dependencies will be installed automatically, but depending on your environment you may still need to add references to them manually.

Download & Installation

There are several different ways to get the code. Some examples below:

CDN

The Always Dirty helper is available over jsDelivr CDN and can directly be included on every page.

<script type="text/javascript" src="//cdn.jsdelivr.net/jquery.dirtyforms/2.0.0/jquery.dirtyforms.helpers.alwaysdirty.min.js"></script>

jsDelivr also supports on-the-fly concatenation of files, so you can reference only 1 URL to get jQuery, jquery.dirtyforms, and jquery.dirtyforms.helpers.alwaysdirty in one request.

<script type="text/javascript" src="//cdn.jsdelivr.net/g/jquery@1.11.3,jquery.dirtyforms@2.0.0(jquery.dirtyforms.min.js+jquery.dirtyforms.helpers.alwaysdirty.min.js)"></script>

Self-Hosted

Download and save one of two available files to include the Always Dirty helper to your page, either the latest distribution or the latest minified version.

<script type="text/javascript" src="jquery.dirtyforms.helpers.alwaysdirty.min.js"></script>

You can also conveniently get all of the latest Dirty Forms files in one Zip Download.

Package Managers

The Always Dirty helper is even available through NPM, Bower, and NuGet. Just use one of the following commands below to install the helper, including all dependencies.

// NPM
$ npm install jquery.dirtyforms.helpers.alwaysdirty

// Bower
$ bower install jquery.dirtyforms.helpers.alwaysdirty

// NuGet
PM> Install-Package jquery.dirtyforms.helpers.alwaysdirty

SourceMaps

A SourceMap file is also available via CDN or your favorite package manager.

CDN

<script type="text/javascript" src="//cdn.jsdelivr.net/jquery.dirtyforms/2.0.0/jquery.dirtyforms.helpers.alwaysdirty.min.js.map"></script>

Package Managers

NPM, Bower, and NuGet will install the SourceMap file into the destination directory.

jquery.dirtyforms.helpers.alwaysdirty.min.js.map

Usage

This helper is completely automatic - there are no properties or methods to interact with. Simply include the reference to the helper after the prerequisites.

<script src="//ajax.googleapis.com/ajax/libs/jquery/1.11.2/jquery.min.js" type="text/javascript"></script>
<script src="//cdn.jsdelivr.net/jquery.dirtyforms/2.0.0/jquery.dirtyforms.min.js" type="text/javascript"></script>
<script src="//cdn.jsdelivr.net/jquery.dirtyforms/2.0.0/jquery.dirtyforms.helpers.alwaysdirty.min.js" type="text/javascript"></script>

If not using a CDN, you need to apply the dependencies in the same order as in the example above.

Support

For help or to report a bug please open an issue at the Dirty Forms development site.