/** * Word or character counting functionality. Count words or characters in a * provided text string. * * @namespace wp.utils * * @since 2.6.0 * @output wp-admin/js/word-count.js */ ( function() { /** * Word counting utility * * @namespace wp.utils.wordcounter * @memberof wp.utils * * @class * * @param {Object} settings Optional. Key-value object containing overrides for * settings. * @param {RegExp} settings.HTMLRegExp Optional. Regular expression to find HTML elements. * @param {RegExp} settings.HTMLcommentRegExp Optional. Regular expression to find HTML comments. * @param {RegExp} settings.spaceRegExp Optional. Regular expression to find irregular space * characters. * @param {RegExp} settings.HTMLEntityRegExp Optional. Regular expression to find HTML entities. * @param {RegExp} settings.connectorRegExp Optional. Regular expression to find connectors that * split words. * @param {RegExp} settings.removeRegExp Optional. Regular expression to find remove unwanted * characters to reduce false-positives. * @param {RegExp} settings.astralRegExp Optional. Regular expression to find unwanted * characters when searching for non-words. * @param {RegExp} settings.wordsRegExp Optional. Regular expression to find words by spaces. * @param {RegExp} settings.characters_excluding_spacesRegExp Optional. Regular expression to find characters which * are non-spaces. * @param {RegExp} settings.characters_including_spacesRegExp Optional. Regular expression to find characters * including spaces. * @param {RegExp} settings.shortcodesRegExp Optional. Regular expression to find shortcodes. * @param {Object} settings.l10n Optional. Localization object containing specific * configuration for the current localization. * @param {string} settings.l10n.type Optional. Method of finding words to count. * @param {Array} settings.l10n.shortcodes Optional. Array of shortcodes that should be removed * from the text. * * @return {void} */ function WordCounter( settings ) { var key, shortcodes; // Apply provided settings to object settings. if ( settings ) { for ( key in settings ) { // Only apply valid settings. if ( settings.hasOwnProperty( key ) ) { this.settings[ key ] = settings[ key ]; } } } shortcodes = this.settings.l10n.shortcodes; // If there are any localization shortcodes, add this as type in the settings. if ( shortcodes && shortcodes.length ) { this.settings.shortcodesRegExp = new RegExp( '\\[\\/?(?:' + shortcodes.join( '|' ) + ')[^\\]]*?\\]', 'g' ); } } // Default settings. WordCounter.prototype.settings = { HTMLRegExp: /<\/?[a-z][^>]*?>/gi, HTMLcommentRegExp: /<!--[\s\S]*?-->/g, spaceRegExp: / | /gi, HTMLEntityRegExp: /&\S+?;/g, // \u2014 = em-dash. connectorRegExp: /--|\u2014/g, // Characters to be removed from input text. removeRegExp: new RegExp( [ '[', // Basic Latin (extract). '\u0021-\u0040\u005B-\u0060\u007B-\u007E', // Latin-1 Supplement (extract). '\u0080-\u00BF\u00D7\u00F7', /* * The following range consists of: * General Punctuation * Superscripts and Subscripts * Currency Symbols * Combining Diacritical Marks for Symbols * Letterlike Symbols * Number Forms * Arrows * Mathematical Operators * Miscellaneous Technical * Control Pictures * Optical Character Recognition * Enclosed Alphanumerics * Box Drawing * Block Elements * Geometric Shapes * Miscellaneous Symbols * Dingbats * Miscellaneous Mathematical Symbols-A * Supplemental Arrows-A * Braille Patterns * Supplemental Arrows-B * Miscellaneous Mathematical Symbols-B * Supplemental Mathematical Operators * Miscellaneous Symbols and Arrows */ '\u2000-\u2BFF', // Supplemental Punctuation. '\u2E00-\u2E7F', ']' ].join( '' ), 'g' ), // Remove UTF-16 surrogate points, see https://en.wikipedia.org/wiki/UTF-16#U.2BD800_to_U.2BDFFF astralRegExp: /[\uD800-\uDBFF][\uDC00-\uDFFF]/g, wordsRegExp: /\S\s+/g, characters_excluding_spacesRegExp: /\S/g, /* * Match anything that is not a formatting character, excluding: * \f = form feed * \n = new line * \r = carriage return * \t = tab * \v = vertical tab * \u00AD = soft hyphen * \u2028 = line separator * \u2029 = paragraph separator */ characters_including_spacesRegExp: /[^\f\n\r\t\v\u00AD\u2028\u2029]/g, l10n: window.wordCountL10n || {} }; /** * Counts the number of words (or other specified type) in the specified text. * * @since 2.6.0 * * @memberof wp.utils.wordcounter * * @param {string} text Text to count elements in. * @param {string} type Optional. Specify type to use. * * @return {number} The number of items counted. */ WordCounter.prototype.count = function( text, type ) { var count = 0; // Use default type if none was provided. type = type || this.settings.l10n.type; // Sanitize type to one of three possibilities: 'words', 'characters_excluding_spaces' or 'characters_including_spaces'. if ( type !== 'characters_excluding_spaces' && type !== 'characters_including_spaces' ) { type = 'words'; } // If we have any text at all. if ( text ) { text = text + '\n'; // Replace all HTML with a new-line. text = text.replace( this.settings.HTMLRegExp, '\n' ); // Remove all HTML comments. text = text.replace( this.settings.HTMLcommentRegExp, '' ); // If a shortcode regular expression has been provided use it to remove shortcodes. if ( this.settings.shortcodesRegExp ) { text = text.replace( this.settings.shortcodesRegExp, '\n' ); } // Normalize non-breaking space to a normal space. text = text.replace( this.settings.spaceRegExp, ' ' ); if ( type === 'words' ) { // Remove HTML Entities. text = text.replace( this.settings.HTMLEntityRegExp, '' ); // Convert connectors to spaces to count attached text as words. text = text.replace( this.settings.connectorRegExp, ' ' ); // Remove unwanted characters. text = text.replace( this.settings.removeRegExp, '' ); } else { // Convert HTML Entities to "a". text = text.replace( this.settings.HTMLEntityRegExp, 'a' ); // Remove surrogate points. text = text.replace( this.settings.astralRegExp, 'a' ); } // Match with the selected type regular expression to count the items. text = text.match( this.settings[ type + 'RegExp' ] ); // If we have any matches, set the count to the number of items found. if ( text ) { count = text.length; } } return count; }; // Add the WordCounter to the WP Utils. window.wp = window.wp || {}; window.wp.utils = window.wp.utils || {}; window.wp.utils.WordCounter = WordCounter; } )();
Name | Type | Size | Permission | Actions |
---|---|---|---|---|
widgets | Folder | 0755 |
|
|
accordion.js | File | 2.87 KB | 0644 |
|
accordion.min.js | File | 849 B | 0644 |
|
application-passwords.js | File | 6.24 KB | 0644 |
|
application-passwords.min.js | File | 2.95 KB | 0644 |
|
auth-app.js | File | 5.66 KB | 0644 |
|
auth-app.min.js | File | 2.04 KB | 0644 |
|
code-editor.js | File | 11.32 KB | 0644 |
|
code-editor.min.js | File | 3.01 KB | 0644 |
|
color-picker.js | File | 9.54 KB | 0644 |
|
color-picker.min.js | File | 3.4 KB | 0644 |
|
comment.js | File | 2.85 KB | 0644 |
|
comment.min.js | File | 1.28 KB | 0644 |
|
common.js | File | 58.63 KB | 0644 |
|
common.min.js | File | 21.93 KB | 0644 |
|
custom-background.js | File | 3.35 KB | 0644 |
|
custom-background.min.js | File | 1.18 KB | 0644 |
|
custom-header.js | File | 1.98 KB | 0644 |
|
customize-controls.js | File | 286.52 KB | 0644 |
|
customize-controls.min.js | File | 109.03 KB | 0644 |
|
customize-nav-menus.js | File | 109.69 KB | 0644 |
|
customize-nav-menus.min.js | File | 46.19 KB | 0644 |
|
customize-widgets.js | File | 70.05 KB | 0644 |
|
customize-widgets.min.js | File | 27.41 KB | 0644 |
|
dashboard.js | File | 26.92 KB | 0644 |
|
dashboard.min.js | File | 8.59 KB | 0644 |
|
edit-comments.js | File | 36.65 KB | 0644 |
|
edit-comments.min.js | File | 14.99 KB | 0644 |
|
editor-expand.js | File | 41.61 KB | 0644 |
|
editor-expand.min.js | File | 13.14 KB | 0644 |
|
editor.js | File | 44.25 KB | 0644 |
|
editor.min.js | File | 12.87 KB | 0644 |
|
farbtastic.js | File | 7.67 KB | 0644 |
|
gallery.js | File | 5.41 KB | 0644 |
|
gallery.min.js | File | 3.65 KB | 0644 |
|
image-edit.js | File | 38.21 KB | 0644 |
|
image-edit.min.js | File | 14.3 KB | 0644 |
|
inline-edit-post.js | File | 19.8 KB | 0644 |
|
inline-edit-post.min.js | File | 9.27 KB | 0644 |
|
inline-edit-tax.js | File | 7.61 KB | 0644 |
|
inline-edit-tax.min.js | File | 2.93 KB | 0644 |
|
iris.min.js | File | 23.09 KB | 0644 |
|
language-chooser.js | File | 890 B | 0644 |
|
language-chooser.min.js | File | 423 B | 0644 |
|
link.js | File | 3.89 KB | 0644 |
|
link.min.js | File | 1.7 KB | 0644 |
|
media-gallery.js | File | 1.27 KB | 0644 |
|
media-gallery.min.js | File | 611 B | 0644 |
|
media-upload.js | File | 3.38 KB | 0644 |
|
media-upload.min.js | File | 1.13 KB | 0644 |
|
media.js | File | 6.26 KB | 0644 |
|
media.min.js | File | 2.34 KB | 0644 |
|
nav-menu.js | File | 50.68 KB | 0644 |
|
nav-menu.min.js | File | 25.69 KB | 0644 |
|
password-strength-meter.js | File | 4.14 KB | 0644 |
|
password-strength-meter.min.js | File | 1.1 KB | 0644 |
|
password-toggle.js | File | 1.31 KB | 0644 |
|
password-toggle.min.js | File | 847 B | 0644 |
|
plugin-install.js | File | 6.92 KB | 0644 |
|
plugin-install.min.js | File | 2.35 KB | 0644 |
|
post.js | File | 39.08 KB | 0644 |
|
post.min.js | File | 18.59 KB | 0644 |
|
postbox.js | File | 18.4 KB | 0644 |
|
postbox.min.js | File | 6.55 KB | 0644 |
|
privacy-tools.js | File | 10.67 KB | 0644 |
|
privacy-tools.min.js | File | 5.03 KB | 0644 |
|
revisions.js | File | 33.13 KB | 0644 |
|
revisions.min.js | File | 17.45 KB | 0644 |
|
set-post-thumbnail.js | File | 876 B | 0644 |
|
set-post-thumbnail.min.js | File | 620 B | 0644 |
|
site-health.js | File | 13.15 KB | 0644 |
|
site-health.min.js | File | 6.13 KB | 0644 |
|
site-icon.js | File | 5.91 KB | 0644 |
|
site-icon.min.js | File | 2.12 KB | 0644 |
|
svg-painter.js | File | 5.39 KB | 0644 |
|
svg-painter.min.js | File | 2.33 KB | 0644 |
|
tags-box.js | File | 10.88 KB | 0644 |
|
tags-box.min.js | File | 3 KB | 0644 |
|
tags-suggest.js | File | 5.64 KB | 0644 |
|
tags-suggest.min.js | File | 2.22 KB | 0644 |
|
tags.js | File | 4.77 KB | 0644 |
|
tags.min.js | File | 1.96 KB | 0644 |
|
theme-plugin-editor.js | File | 24.79 KB | 0644 |
|
theme-plugin-editor.min.js | File | 11.46 KB | 0644 |
|
theme.js | File | 54.65 KB | 0644 |
|
theme.min.js | File | 26.4 KB | 0644 |
|
updates.js | File | 108.36 KB | 0644 |
|
updates.min.js | File | 47.1 KB | 0644 |
|
user-profile.js | File | 14.2 KB | 0644 |
|
user-profile.min.js | File | 6.35 KB | 0644 |
|
user-suggest.js | File | 2.25 KB | 0644 |
|
user-suggest.min.js | File | 676 B | 0644 |
|
widgets.js | File | 22.56 KB | 0644 |
|
widgets.min.js | File | 12.31 KB | 0644 |
|
word-count.js | File | 7.52 KB | 0644 |
|
word-count.min.js | File | 1.49 KB | 0644 |
|
xfn.js | File | 740 B | 0644 |
|
xfn.min.js | File | 458 B | 0644 |
|