jquery.dirtyforms.helpers.tinymce

jquery.dirtyforms.helpers.tinymce

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

Purpose

This helper causes Dirty Forms to read and/or update the dirty status from TinyMCE instances on the form. This will ensure that when a user edits a TinyMCE field, Dirty Forms will be notified of the event in order to mark the form dirty.

Prerequisites

Prerequesites must be included in this order:

• jQuery (>= 1.4.2)
• jquery.dirtyforms
• tinymce
• jquery.tinymce

Both of the TinyMCE files are included in the TinyMCE jQuery package.

Note: There are known compatibility issues between jQuery 1.7.2 and higher and TinyMCE versions lower than 3.5b3. These issues can cause the dialog continue function to fail in 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 TinyMCE helper is available over jsDelivr CDN and can directly included to every page.

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

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

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

Self-Hosted

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

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

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

Package Managers

The TinyMCE 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.tinymce

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

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

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/latest/jquery.dirtyforms.helpers.tinymce.min.js.map"></script>

Package Managers

NPM or Bower will install the file into the destination directory.

jquery.dirtyforms.helpers.tinymce.min.js.map

For NuGet, this file is not included in the package, but you can get it from here if you really need it.

##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 and use Dirty Forms as per the documentation and TinyMCE as per the documentation.

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

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