# Функция ESC_ATTR__() в WordPress
Функция esc_attr__() была введена в версии WordPress 2.8.0. Она используется для перевода текста и безопасного отображения его в атрибутах HTML.
## Описание функции
Функция esc_attr__() обрабатывает специальные символы, такие как <, >, &, ", ', которые могут повредить структуру HTML. Она также не выполняет двойное экранирование.
**Важно:** Всегда используйте эту функцию для обработки данных, введенных пользователями. Например:
```html
Возвращаемое значение
- Тип: Строка.
- Описание: Возвращает переведённый текст, если перевод был успешным; оригинальный текст в случае ошибки.
Как использовать
Функция используется следующим образом:
esc_attr__( $text, $domain );- $text (строка, обязательный): Текст для перевода.
- $domain (строка): Уникальный идентификатор для получения переведённых строк. По умолчанию:
'default'.
Примеры использования
Пример 1: Заголовок внутри цикла
В этом примере мы используем функцию для создания ссылки на статью с корректным экранированием:
Пример 2: Простой перевод строки
Если вы хотите сделать перевод строки, используйте следующий код:
echo esc_attr__( 'Welcome to my website', 'textdomain' );Изменения в версии
- С версии 2.8.0: Функция была введена в WordPress.
Код функции
Функция esc_attr__() выглядит следующим образом:
function esc_attr__( $text, $domain = 'default' ) {
return esc_attr( translate( $text, $domain ) );
}
Смежные функции
Хотите узнать о других функциях, связанных с экранированием и переводом текстов? Вот некоторые из них:
esc_attr()— экранирует атрибуты HTML.esc_html()— экранирует HTML.esc_js()— экранирует JavaScript.translate()— переводит строки на нужный язык.
Заключение
Функция esc_attr__() — важный инструмент для обеспечения безопасности данных, которые выводятся на веб-страницах WordPress. Правильное её использование помогает защитить ваш сайт от атак и обеспечить корректное отображение информации.