функция since 2.8.0

esc_js()

Проверено на WordPress 6.9, обновлено Источник: WordPress Developer Resources.

Сигнатура

esc_js( string $text ): string

Описание

Экранирует текстовые строки для вывода в JS. Предназначена для встроенного JS (в атрибуте тега, например onclick="..."). Учтите, что строки должны быть заключены в одинарные кавычки. Здесь также применяется фильтр ‘js_escape’.

Оригинал (английский)

Escapes text strings for echoing in JS. It is intended to be used for inline JS (in a tag attribute, for example onclick="..."). Note that the strings have to be in single quotes. The ‘js_escape’ filter is also applied here.

Параметры

$text string обязательный
Текст, который нужно экранировать.

Возвращаемое значение

string

Исходный код

wp-includes/formatting.php:4652

function esc_js( $text ) {
	$safe_text = wp_check_invalid_utf8( $text );
	$safe_text = _wp_specialchars( $safe_text, ENT_COMPAT );
	$safe_text = preg_replace( '/&#(x)?0*(?(1)27|39);?/i', "'", stripslashes( $safe_text ) );
	$safe_text = str_replace( "\r", '', $safe_text );
	$safe_text = str_replace( "\n", '\\n', addslashes( $safe_text ) );
	/**
	 * Filters a string cleaned and escaped for output in JavaScript.
	 *
	 * Text passed to esc_js() is stripped of invalid or special characters,
	 * and properly slashed for output.
	 *
	 * @since 2.0.6
	 *
	 * @param string $safe_text The text after it has been escaped.
	 * @param string $text      The text prior to being escaped.
	 */
	return apply_filters( 'js_escape', $safe_text, $text );
}

История изменений

ВерсияОписание
2.8.0 Introduced.

Что будем искать? Например,Продвижение

Этот сайт использует куки-файлы. Оставаясь на сайте, Вы соглашаетесь на их использование. Для получения дополнительной информации, пожалуйста, ознакомьтесь с политикой в отношении персональных данных.