esc_html_e()
Переводит (локализует) строку и очищает её для вывода на экран - заменяет в ней спецсимволы на HTML сущности.
Выводит на экран текст, которой можно отображать в HTML как HTML код.
Используйте esc_html__(), когда нужно получить такую строку, а не выводить её на экран.
Работает на основе: esc_html(), translate()
Хуков нет.
Возвращает
null. Выводит на экран переведенный и отформатированный текст.
Использование
<?php esc_html_e( $text, $domain ); ?>
- $text(строка) (обязательный)
- Строка для перевода.
- $domain(строка) (обязательный)
- Домен (идентификатор) по которому получать перевод.
По умолчанию: 'default'
Примеры
#1 Вывод HTML кода в HTML
Если в переводе строки используются HTML теги или символы, который нужно показать как есть, например в поле textarea, то такую строку удобно переводить функцией:
<textarea>
<?php esc_html_e('Any text with <div>HTML.</div>', 'kama'); ?>
</textarea> #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() esc html e WP 6.7.2
function esc_html_e( $text, $domain = 'default' ) {
echo esc_html( translate( $text, $domain ) );
}