: str_replace(): Passing null to parameter #2 ($replace) of type array|string is deprecated in
/* global wpforms_settings */
* Predefine hint text to display.
* @since 1.6.4 Added a new macros - {remaining}.
* @param {string} hintText Hint text.
* @param {number} count Current count.
* @param {number} limit Limit to.
* @return {string} Predefined hint text.
function renderHint( hintText, count, limit ) {
return hintText.replace( '{count}', count ).replace( '{limit}', limit ).replace( '{remaining}', limit - count );
* Create HTMLElement hint element with text.
* @param {number|string} formId Form id.
* @param {number|string} fieldId Form field id.
* @param {string} text Hint text.
* @return {Object} HTMLElement hint element with text.
function createHint( formId, fieldId, text ) {
const hint = document.createElement( 'div' );
formId = typeof formId === 'object' ? '' : formId;
fieldId = typeof fieldId === 'object' ? '' : fieldId;
hint.classList.add( 'wpforms-field-limit-text' );
hint.id = 'wpforms-field-limit-text-' + formId + '-' + fieldId;
hint.setAttribute( 'aria-live', 'polite' );
* Keyup/Keydown event higher order function for characters limit.
* @param {Object} hint HTMLElement hint element.
* @param {number} limit Max allowed number of characters.
* @return {Function} Handler function.
function checkCharacters( hint, limit ) {
// noinspection JSUnusedLocalSymbols
return function( e ) { // eslint-disable-line no-unused-vars
hint.textContent = renderHint(
window.wpforms_settings.val_limit_characters,
* Count words in the string.
* @param {string} string String value.
* @return {number} Words count.
function countWords( string ) {
if ( typeof string !== 'string' ) {
].forEach( function( pattern ) {
string = string.replace( pattern, '$1, $2' );
return string.split( /\s+/ ).length;
* Keyup/Keydown event higher order function for words limit.
* @param {Object} hint HTMLElement hint element.
* @param {number} limit Max allowed number of characters.
* @return {Function} Handler function.
function checkWords( hint, limit ) {
const value = this.value.trim(),
words = countWords( value );
hint.textContent = renderHint(
window.wpforms_settings.val_limit_words,
// We should prevent the keys: Enter, Space, Comma.
if ( [ 13, 32, 188 ].indexOf( e.keyCode ) > -1 && words >= limit ) {
* Get passed text from the clipboard.
* @param {ClipboardEvent} e Clipboard event.
* @return {string} Text from clipboard.
function getPastedText( e ) {
if ( window.clipboardData && window.clipboardData.getData ) { // IE
return window.clipboardData.getData( 'Text' );
} else if ( e.clipboardData && e.clipboardData.getData ) {
return e.clipboardData.getData( 'text/plain' );
* Paste event higher order function for character limit.
* @param {number} limit Max allowed number of characters.
* @return {Function} Event handler.
function pasteText( limit ) {
const pastedText = getPastedText( e ),
newPosition = this.selectionStart + pastedText.length,
newText = this.value.substring( 0, this.selectionStart ) + pastedText + this.value.substring( this.selectionStart );
this.value = newText.substring( 0, limit );
this.setSelectionRange( newPosition, newPosition );
* Limit string length to a certain number of words, preserving line breaks.
* @param {string} text Text.
* @param {number} limit Max allowed number of words.
* @return {string} Text with the limited number of words.
function limitWords( text, limit ) {
// Regular expression pattern: match any space character.
// Store separators for further join.
const separators = text.trim().match( regEx ) || [];
// Split the new text by regular expression.
const newTextArray = text.split( regEx );
// Limit the number of words.
newTextArray.splice( limit, newTextArray.length );
// Join the words together using stored separators.
for ( let i = 0; i < newTextArray.length; i++ ) {
result += newTextArray[ i ] + ( separators[ i ] || '' );
* Paste event higher order function for words limit.
* @param {number} limit Max allowed number of words.
* @return {Function} Event handler.
function pasteWords( limit ) {
const pastedText = getPastedText( e ),
newPosition = this.selectionStart + pastedText.length,
newText = this.value.substring( 0, this.selectionStart ) + pastedText + this.value.substring( this.selectionStart );
this.value = limitWords( newText, limit );
this.setSelectionRange( newPosition, newPosition );
* @param {Object} el Iterator.
* @return {Object} Array.
return [].slice.call( el );
* Public functions and properties.
* @param {string} context Context selector.
arrFrom( document.querySelectorAll( context + ' .wpforms-limit-characters-enabled' ) )
function( e ) { // eslint-disable-line array-callback-return
const limit = parseInt( e.dataset.textLimit, 10 ) || 0;
e.value = e.value.slice( 0, limit );
wpforms_settings.val_limit_characters,
const fn = checkCharacters( hint, limit );
e.parentNode.appendChild( hint );
e.addEventListener( 'keydown', fn );
e.addEventListener( 'keyup', fn );
e.addEventListener( 'paste', pasteText( limit ) );
arrFrom( document.querySelectorAll( context + ' .wpforms-limit-words-enabled' ) )
function( e ) { // eslint-disable-line array-callback-return
const limit = parseInt( e.dataset.textLimit, 10 ) || 0;
e.value = limitWords( e.value, limit );
wpforms_settings.val_limit_words,
countWords( e.value.trim() ),
const fn = checkWords( hint, limit );
e.parentNode.appendChild( hint );
e.addEventListener( 'keydown', fn );
e.addEventListener( 'keyup', fn );
e.addEventListener( 'paste', pasteWords( limit ) );
* DOMContentLoaded handler.
window.WPFormsTextLimit = app;
if ( document.readyState === 'loading' ) {
document.addEventListener( 'DOMContentLoaded', ready );
It is recommended that you Edit text format, this type of Fix handles quite a lot in one request
