PageHasFormChanges

A jQuery plugin to check if anything has changed in any form on a page, and warn the user before leaving the page.

⚠️ This project has been archived

No future updates are planned. Feel free to continue using it, but expect no support.

Description

Any form elements that trigger a .change() jQuery event will also trigger showing the warning, when the user tries to navigate away from the page. Navigation in this case includes clicking a link, the browser’s back button, reloading the page etcetera, using the window.onbeforeunload event. It does not include submitting any of the forms, as submitting the form is assumed to save the changes the user has made.

Not covered

This simple plugin does not distinguish between multiple forms on a page. If the user changes fields in multiple forms and then submits one, there will be no warning shown for the other forms.

Usage

Basic usage

Just load the script, and you’re all set!

Options

JoelPurra.PageHasFormChanges.setOptions({
		// Change the message shown to the user.
		// Default: "Changes have been detected in the form. Leaving the page will discard all form input."
		leavingPageWarningMessage: "y u no save changes?",

		// Don't reset if for example form validation wasn't successful.
		// Change to true if you prevent the default browser form submit and use ajax instead.
		// Default: false
		resetWarningOnPreventedSubmit: true
	});

Runtime dependencies

jQuery
Ben Alman’s JavaScript Debug, a simple wrapper for console.log

License

When using PageHasFormChanges, comply to at least one of the three available licenses: BSD, MIT, GPL. Please see the LICENSE file for details.