Word Count plugin
The Word Count plugin adds the functionality for counting words to the TinyMCE editor by placing a counter on the right edge of the status bar. Clicking Word Count in the status bar switches between counting words and characters. A dialog box with both word and character counts can be opened using the menu item situated in the Tools drop-down, or the toolbar button.
Basic setup
tinymce.init({
selector: 'textarea', // change this value according to your HTML
plugins: 'wordcount',
toolbar: 'wordcount'
});
Toolbar buttons
The Word Count plugin provides the following toolbar buttons:
Toolbar button identifier | Description |
---|---|
|
Opens a word count dialog showing word and character counts. |
These toolbar buttons can be added to the editor using:
-
The
toolbar
configuration option. -
The
quickbars_insert_toolbar
configuration option.
Menu items
The Word Count plugin provides the following menu items:
Menu item identifier | Default Menu Location | Description |
---|---|---|
|
Tools |
Opens a word count dialog showing word and character counts. |
These menu items can be added to the editor using:
-
The
menu
configuration option. -
The
contextmenu
configuration option.
Commands
The Word Count plugin provides the following TinyMCE command.
Command | Description |
---|---|
mceWordCount |
Opens the Word Count summary dialog. |
tinymce.activeEditor.execCommand('mceWordCount');
API
The Word Count plugin exposes an API for retrieving the word and character count of either the whole document or the current editor selection. Following is an example of how to retrieve each property.
Example: using the wordcount
plugin APIs
const wordcount = tinymce.activeEditor.plugins.wordcount;
console.log(wordcount.body.getWordCount());
console.log(wordcount.body.getCharacterCount());
console.log(wordcount.body.getCharacterCountWithoutSpaces());
console.log(wordcount.selection.getWordCount());
console.log(wordcount.selection.getCharacterCount());
console.log(wordcount.selection.getCharacterCountWithoutSpaces());