Описание
Вспомогательная функция, которая возвращает HTML-атрибуты, необходимые для встроенного редактирования текста, в виде строки, экранированной и готовой к выводу.
Она используется внутри шаблонов рендера блоков ACF, чтобы сделать HTML-элемент напрямую редактируемым, в первую очередь для полей Text и Text Area, позволяя авторам вводить контент прямо в области предпросмотра блока.
Журнал изменений
- Добавлено в версии 6.7
Параметры
acf_inline_text_editing_attrs( $field_name, $args = array() );
$field_name
(string) Имя поля ACF, которое будет обновляться, когда пользователь вводит текст в HTML-элемент.
$args
(array) (Необязательно) Массив аргументов для настройки поведения встроенного редактирования текста. Доступные ключи:
- toolbar_icon
(string) (Необязательно) HTML-тег (например, SVG), который будет использован как значок панели инструментов. - toolbar_title
(string) (Необязательно) Строка, которая будет использована как заголовок панели инструментов. - placeholder
(string) (Необязательно) Строка, которая будет использована как текст-заполнитель, когда поле пустое.
Возвращаемое значение
(string) Строка, содержащая необходимые HTML-атрибуты, готовые для вставки внутрь HTML-тега. Возвращаемый результат уже экранирован.
Примеры
Сделать текстовое поле, используемое в элементе h3, редактируемым:
<h3 <?php echo acf_inline_text_editing_attrs( 'my_text_field' ); ?>>
<?php echo esc_html( get_field( 'my_text_field' ) ); ?>
</h3>
Чтобы ещё больше настроить поведение, вы можете управлять значками, используемыми в панели инструментов, или текстом-заполнителем, который показывается, когда поле пустое. Например:
<?php echo acf_inline_text_editing_attrs(
'my_text_field',
array(
'toolbar_icon' => 'здесь ваш SVG HTML',
'toolbar_title' => 'Мой собственный заголовок панели инструментов',
'placeholder' => 'Введите текст для редактирования...'
)
); ?>
Обновлено: 01.06.2026