Important changes to Tiny Cloud pricing > Find out more

NOTE: TinyMCE 5 reached End of Support in April 2023. No more bug fixes, security updates, or new features will be introduced to TinyMCE 5. We recommend you upgrade to TinyMCE 6 or consider TinyMCE 5 Long Term Support (LTS) if you need more time.

Noneditable plugin

Prevent users from changing content within elements. Ideal for templates.

Contribute to this page

The noneditable plugin has been rewritten from scratch to use stability improvements to the TinyMCE core. It is now more reliable and has fewer browser-specific quirks.

This plugin enables you to prevent users from being able to edit content within elements assigned the mceNonEditable class.

Basic setup

tinymce.init({
  selector: 'textarea',  // change this value according to your HTML
  plugins: 'noneditable'
});

When you have existing classes that cannot be removed, you may combine MCE classes with the existing class in the following manner:

Non-editable div example

<div class="myclass mceNonEditable">Contents</div>

Editable div example

<div class="myclass mceEditable">Contents</div>

Options

These settings affect the execution of the noneditable plugin. These settings help determine which areas of the editor’s editable area will remain editable and which will be converted to non-editable status.

noneditable_editable_class

This option allows you to specify the class name that TinyMCE will use to determine which areas of content are editable when using the noneditable plugin. This would be the the same as contenteditable=true, forcing an element to be editable.

Note that classes with the mceItem prefix are invisible within TinyMCE.

Type: String

Default Value: 'mceEditable'

Example: Using noneditable_editable_class

tinymce.init({
  selector: 'textarea',  // change this value according to your HTML
  plugins: 'noneditable',
  noneditable_editable_class: 'mceEditable'
});

noneditable_noneditable_class

This option allows you to specify the class name that TinyMCE will use to determine which areas of content are editable when using the noneditable plugin. This would be the same as contenteditable=false.

Note that classes with the mceItem prefix are invisible within TinyMCE.

Type: String

Default Value: 'mceNonEditable'

Example: Using noneditable_noneditable_class

tinymce.init({
  selector: 'textarea',  // change this value according to your HTML
  plugins: 'noneditable',
  noneditable_noneditable_class: 'mceNonEditable'
});

noneditable_regexp

This option is used to specify a regular expression or array of regular expressions that TinyMCE will use to determine which areas of content are non-editable when using the noneditable plugin. The regular expressions needs to be global so that all instances within the document are matched. The text content of the matches will be wrapped in spans, hiding the structure and styling while editing.

Note: If elements are matched by the regular expression, the elements will be replaced with spans. Use noneditable_noneditable_class for elements.

Type: String

Example: Using noneditable_regexp

tinymce.init({
  selector: 'textarea',  // change this value according to your HTML
  plugins: 'noneditable',
  noneditable_regexp: /\d{3}-\d{3}-\d{3}/g // matches 123-456-789
});

Making Content Non-editable

Procedure

  1. Add noneditable to plugins. For example:

     tinymce.init({
       selector: 'textarea',  // change this value according to your HTML
       plugins: 'code noneditable'
     });
    
  2. Configure the noneditable_noneditable_class option, or the others as necessary in your tinymce.init. For example:

     tinymce.init({
       selector: 'textarea',  // change this value according to your HTML
       plugins: 'noneditable',
       noneditable_noneditable_class: 'mceNonEditable'
     });
    

    Note: Replace mceNonEditable with the class name you want for your non-editable elements.

  3. Select the desired editor content.
  4. From the menu bar, select View > Source code.
  5. Add the non-editable class to the desired editor content. For example:
<div class="myclass mceNonEditable">Contents</div>

Can't find what you're looking for? Let us know.

Except as otherwise noted, the content of this page is licensed under the Creative Commons BY-NC-SA 3.0 License, and code samples are licensed under the Apache 2.0 License.