acf_inline_toolbar_editing_attrs()

Описание

Вспомогательная функция, возвращающая в виде строки HTML-атрибуты, необходимые для встроенного редактирования с панелью инструментов, экранированные и готовые к выводу.

Она используется в шаблонах рендеринга блоков ACF, чтобы при нажатии на HTML-элемент отображалась всплывающая панель инструментов, позволяющая авторам редактировать несколько полей одновременно.

История изменений

Добавлена в версии 6.7

Параметры

acf_inline_toolbar_editing_attrs( $fields, $args = array() );

$fields

(array) Обязательный параметр. Список полей, каждое из которых будет отображаться во всплывающей панели инструментов.

Каждое поле можно передать в виде:

Строки (например, ‘my_field_name’)
Ассоциативного массива с определёнными ключами:
- field_name: (string) Имя поля, отображаемого на панели инструментов.
- field_icon: (string) (Необязательно) HTML-тег, в том числе SVG, используемый в качестве значка панели инструментов. Если не передан, будет использован значок первого поля.
- field_label: (string) (Необязательно) Строка, используемая в качестве подписи кнопки на панели инструментов.
- popover_min_width: (string) (Необязательно) Минимальная ширина всплывающего окна; по умолчанию — ‘300px’
- use_expanded_editor: (bool) (Необязательно) Если установлено значение true, редактирование поля открывается в расширенной панели редактора; значение false использует всплывающее окно. По умолчанию — false.

$args

(array) (Необязательно) Массив аргументов для настройки поведения встроенного редактирования текста. Доступны следующие ключи:

toolbar_icon
(string) (Необязательно) HTML-тег (например, SVG), используемый в качестве значка панели инструментов.
toolbar_title
(string) (Необязательно) Строка, используемая в качестве заголовка панели инструментов.
uid
(string) (Необязательно) Уникальный идентификатор, который не используется другими встроенными полями в этом блоке. Передайте его, если у вас есть 2 конфликтующих элемента.
render
(bool) (Необязательно) Значение true, если функция должна вернуть результат, и false, если она должна вернуть пустую строку.

Возвращаемое значение

(string) Строка, содержащая необходимые HTML-атрибуты, готовые для размещения внутри HTML-тега. Возвращаемый результат уже экранирован.

Примеры

Настройка значка панели инструментов для редактирования поля типа Image с пользовательской подписью поля (используемой в качестве всплывающей подсказки)

<img src=”some-image.png” <?php echo acf_inline_toolbar_editing_attrs( array(
    array(
                 ‘field_name’ => ‘my_image_field’,
                 ‘field_icon’   => ‘ваш SVG-код здесь’,
                 ‘field_label’ => ‘Моя пользовательская подпись поля’
            )
) ); ?> />

Вы также можете настроить заголовок и значок всей панели инструментов, передав второй массив. Например:

<img src=”some-image.png” <?php echo acf_inline_toolbar_editing_attrs( array(
    array(
                 ‘field_name’ => ‘my_image_field’,
                 ‘field_icon’   => ‘ваш SVG-код здесь’,
                 ‘field_label’ => ‘Моя пользовательская подпись поля’
            ),
),
            array(
                 ‘toolbar_icon’ => ‘ваш SVG-код здесь’,
                 ‘toolbar_title’ => ‘Мой пользовательский заголовок панели инструментов
            )
); ?> />

Вы можете указать, чтобы определённые поля открывались в расширенной панели редактирования:

<img src=”some-image.png” <?php echo acf_inline_toolbar_editing_attrs( array(
    array(
                 ‘field_name’ => ‘my_image_field’,
                 ‘use_expanded_editor’   => true,
            ),
) ); ?> />

Вы можете задать минимальную ширину всплывающего окна:

<img src=”some-image.png” <?php echo acf_inline_toolbar_editing_attrs( array(
    array(
                 ‘field_name’ => ‘my_image_field’,
                 ‘popover_min_width’   => ‘500px’,
            ),
) ); ?> />

Обновлено: 30.09.2026