Описание
Вспомогательная функция, возвращающая 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' => 'здесь находится ваш HTML-код SVG',
'toolbar_title' => 'Мой пользовательский заголовок панели инструментов',
'placeholder' => 'Введите текст для редактирования...'
)
); ?>
Обновлено: 30.09.2026