acf_inline_toolbar_editing_attrs()

Описание

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

Она используется в шаблонах рендеринга ACF Block, чтобы элемент 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’   => ‘your svg html here’,
                 ‘field_label’ => ‘Моя пользовательская метка поля’
            )
) ); ?> />

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

<img src=”some-image.png” <?php echo acf_inline_toolbar_editing_attrs( array(
    array(
                 ‘field_name’ => ‘my_image_field’,
                 ‘field_icon’   => ‘your svg html here’,
                 ‘field_label’ => ‘Моя пользовательская метка поля’
            ),
),
            array(
                 ‘toolbar_icon’ => ‘your svg html here’,
                 ‘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’,
            ),
) ); ?> />

Обновлено: 01.06.2026