WordPress как на ладони

esc_html_e()WP 2.8.0

Переводит (локализует) строку и очищает её для вывода на экран - заменяет в ней спецсимволы на HTML сущности.

Выводит на экран текст, которой можно отображать в HTML как HTML код.

Используйте esc_html__(), когда нужно получить такую строку, а не выводить её на экран.

Работает на основе: esc_html(), translate()

Хуков нет.

Возвращает

null. Выводит на экран переведенный и отформатированный текст.

Использование

<?php esc_html_e( $text, $domain ); ?>
$text(строка) (обязательный)
Строка для перевода.
$domain(строка) (обязательный)
Домен (идентификатор) по которому получать перевод.
По умолчанию: 'default'

Примеры

0

#1 Вывод HTML кода в HTML

Если в переводе строки используются HTML теги или символы, который нужно показать как есть, например в поле textarea, то такую строку удобно переводить функцией:

<textarea>
	<?php esc_html_e('Any text with <div>HTML.</div>', 'kama'); ?>
</textarea>
0

#2 То же самое что в первом примере, только другим способом:

<?php
echo esc_html( __( 'Any text with <div>HTML.</div>', 'kama' ) );

// или так

echo esc_html__( 'Any text with <div>HTML.</div>', 'kama' );
?>

Список изменений

С версии 2.8.0 Введена.

Код esc_html_e() WP 6.0

function esc_html_e( $text, $domain = 'default' ) {
	echo esc_html( translate( $text, $domain ) );
}
2 комментария
    Войти