esc_html_e()
Перекладає (локалізує) рядок і очищає його для виведення на екран – замінює в ньому спецсимволи на HTML сутності.
Виводить на екран текст, яким можна відображати HTML як HTML код.
Використовуйте esc_html__() , коли потрібно отримати такий рядок, а не виводити його на екран.
Працює на основі:
translate()
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.0.2
function esc_html_e( $text, $domain = 'default' ) {
echo esc_html(translate($text, $domain));
}