esc_html__()
Перекладає рядок, замінюючи в ньому спецсимволи на HTML сутності. Повертає текст, яким можна відображати HTML як HTML код.
Працює на основі:
translate() ,
Хуків немає.
translate() ,
Хуків немає.
Повертає
Строку. Оригінальний чи відформатований текст.
Використання
$text = esc_html__( $text, $domain );
-
$text
(рядок) (обов’язковий) - Рядок для перекладу.
-
$domain
(рядок) (обов’язковий) -
Домен (ідентифікатор) за яким отримуватиме переклад.
За замовчуванням: ‘default’
Приклади
#1 Виведення всередину HTML тега
Якщо в перекладі рядка використовуються HTML теги або символи, які потрібно показати як є, наприклад, у полі textarea, то такий рядок зручно перекладати функцією:
<textarea>
<?php echo esc_html__('Any text with <span>HTML.</span>', 'kama'); ?>
</textarea>#2 Те ж саме, що в першому прикладі, але іншим способом
<?php echo esc_html( __('Any text with <span>HTML.</span>', 'kama') );
список змін
| З версії 2.8.0 | Введено. |
код esc_html__() esc html WP 6.0.2
function esc_html__( $text, $domain = 'default' ) {
return esc_html(translate($text, $domain));
}