/** * Countable is a script to allow for live paragraph-, word- and character- * counting on an HTML element. * * @author Sacha Schmid () * @version 2.0.2 * @license MIT * @see */ /** * Note: For the purpose of this internal documentation, arguments of the type * {Nodes} are to be interpreted as either {NodeList} or {Element}. */ ;(function (global) { 'use strict' /** * @private * * `_liveElements` holds all elements that have the live-counting * functionality bound to them. * * `_event` holds the event to handle the live counting, based on the * browser's capabilities. */ var _liveElements = [], _event = 'oninput' in document ? 'input' : 'keyup' /** * `String.trim()` polyfill for non-supporting browsers. This is the * recommended polyfill on MDN. * * @see * @see * * @return {String} The original string with leading and trailing whitespace * removed. */ if (!String.prototype.trim) { String.prototype.trim = function () { return this.replace(/^\s+|\s+$/g, '') } } /** * `ucs2decode` function from the punycode.js library. * * Creates an array containing the decimal code points of each Unicode * character in the string. While JavaScript uses UCS-2 internally, this * function will convert a pair of surrogate halves (each of which UCS-2 * exposes as separate characters) into a single code point, matching * UTF-16. * * @see * @see * * @param {String} string The Unicode input string (UCS-2). * * @return {Array} The new array of code points. */ function _decode (string) { var output = [], counter = 0, length = string.length, value, extra while (counter < length) { value = string.charCodeAt(counter++) if ((value & 0xF800) == 0xD800 && counter < length) { // High surrogate, and there is a next character. extra = string.charCodeAt(counter++) if ((extra & 0xFC00) == 0xDC00) { // Low surrogate. output.push(((value & 0x3FF) << 10) + (extra & 0x3FF) + 0x10000) } else { output.push(value, extra) } } else { output.push(value) } } return output } /** * `_validateArguments` validates the arguments given to each function call. * Errors are logged to the console as warnings, but Countable fails silently. * * @private * * @param {Nodes} elements The (collection of) element(s) to * validate. * * @param {Function} callback The callback function to validate. * * @return {Boolean} Returns whether all arguments are vaild. */ function _validateArguments (elements, callback) { var elementsValid = elements && ((Object.prototype.toString.call(elements) === '[object NodeList]' && elements.length) || (elements.nodeType === 1)), callbackValid = callback && typeof callback === 'function' if ('console' in window && 'warn' in console) { if (!elementsValid) console.warn('Countable: No valid elements were found') if (!callbackValid) console.warn('Countable: "' + callback + '" is not a valid callback function') } return elementsValid && callbackValid } /** * `_extendDefaults` is a function to extend a set of default options with the * ones given in the function call. Available options are described below. * * {Boolean} hardReturns Use two returns to seperate a paragraph instead * of one. * {Boolean} stripTags Strip HTML tags before counting the values. * {Boolean} ignoreReturns Ignore returns when calculating the `all` * property. * * @private * * @param {Object} options Countable allows the options described above. * They can be used in a function call to override * the default behaviour. * * @return {Object} The new options object. */ function _extendDefaults (options) { var defaults = { hardReturns: false, stripTags: false, ignoreReturns: false } for (var prop in options) { if (defaults.hasOwnProperty(prop)) defaults[prop] = options[prop] } return defaults } /** * `_count` trims an element's value, optionally strips HTML tags and counts * paragraphs, words, characters and characters plus spaces. * * @private * * @param {Element} element The element whose value is to be counted. * * @param {Object} options The options to use for the counting. * * @return {Object} The object containing the number of paragraphs, * words, characters and characters plus spaces. */ function _count (element, options) { var original = 'value' in element ? element.value : element.innerText || element.textContent, trimmed /** * The initial implementation to allow for HTML tags stripping was created * @craniumslows while the current one was created by @Rob--W. * * @see * @see */ if (options.stripTags) original = original.replace(/<\/?[a-z][^>]*>/gi, '') trimmed = original.trim() /** * Most of the performance improvements are based on the works of @epmatsw. * * @see */ return { paragraphs: trimmed ? (trimmed.match(options.hardReturns ? /\n{2,}/g : /\n+/g) || []).length + 1 : 0, words: trimmed ? (trimmed.replace(/['";:,.?¿\-!¡]+/g, '').match(/\S+/g) || []).length : 0, characters: trimmed ? _decode(trimmed.replace(/\s/g, '')).length : 0, all: _decode(options.ignoreReturns ? original.replace(/[\n\r]/g, '') : original).length } } /** * `_loop` is a helper function to iterate over a collection, e.g. a NodeList * or an Array. The callback receives the current element as the single * parameter. * * @private * * @param {Array} which The collection to iterate over. * * @param {Function} callback The callback function to call on each * iteration. */ function _loop (which, callback) { var len = which.length if (typeof len !== 'undefined') { while (len--) { callback(which[len]) } } else { callback(which) } } /** * This is the main object that will later be exposed to other scripts. It * holds all the public methods that can be used to enable the Countable * functionality. */ var Countable = { /** * The `live` method binds the counting handler to all given elements. The * event is either `oninput` or `onkeydown`, based on the capabilities of * the browser. * * @param {Nodes} elements All elements that should receive the * Countable functionality. * * @param {Function} callback The callback to fire whenever the * element's value changes. The callback is * called with the relevant element bound to * `this` and the counted values as the * single parameter. * * @param {Object} [options] An object to modify Countable's * behaviour. Refer to `_extendDefaults` for * a list of available options. * * @return {Object} Returns the Countable object to allow for chaining. */ live: function (elements, callback, options) { var ops = _extendDefaults(options), bind = function (element) { var handler = function () { callback.call(element, _count(element, ops)) } _liveElements.push({ element: element, handler: handler }) handler() if (element.addEventListener) { element.addEventListener(_event, handler, false) } else if (element.attachEvent) { element.attachEvent('on' + _event, handler) } } if (!_validateArguments(elements, callback)) return if (elements.length) { _loop(elements, bind) } else { bind(elements) } return this }, /** * The `die` method removes the Countable functionality from all given * elements. * * @param {Nodes} elements All elements whose Countable functionality * should be unbound. * * @return {Object} Returns the Countable object to allow for chaining. */ die: function (elements) { if (!_validateArguments(elements, function () {})) return _loop(elements, function (element) { var liveElement _loop(_liveElements, function (live) { if (live.element === element) liveElement = live }) if (!liveElement) return if (element.removeEventListener) { element.removeEventListener(_event, liveElement.handler, false) } else if (element.detachEvent) { element.detachEvent('on' + _event, liveElement.handler) } _liveElements.splice(_liveElements.indexOf(liveElement), 1) }) return this }, /** * The `once` method works mostly like the `live` method, but no events are * bound, the functionality is only executed once. * * @param {Nodes} elements All elements that should receive the * Countable functionality. * * @param {Function} callback The callback to fire whenever the * element's value changes. The callback is * called with the relevant element bound to * `this` and the counted values as the * single parameter. * * @param {Object} [options] An object to modify Countable's * behaviour. Refer to `_extendDefaults` * for a list of available options. * * @return {Object} Returns the Countable object to allow for chaining. */ once: function (elements, callback, options) { if (!_validateArguments(elements, callback)) return _loop(elements, function (element) { callback.call(element, _count(element, _extendDefaults(options))) }) return this }, /** * The `enabled` method checks if the live-counting functionality is bound * to an element. * * @param {Element} element A single Element. * * @return {Boolean} A boolean value representing whether Countable * functionality is bound to the given element. */ enabled: function (element) { var isEnabled = false if (element && element.nodeType === 1) { _loop(_liveElements, function (live) { if (live.element === element) isEnabled = true }) } return isEnabled } } /** * Expose Countable depending on the module system used across the * application. (Node / CommonJS, AMD, global) */ if (typeof exports === 'object') { module.exports = Countable } else if (typeof define === 'function' && define.amd) { define(function () { return Countable }) } else { global.Countable = Countable } }(this))