acf/blocks/top_toolbar_fields

Описание

Этот фильтр позволяет добавлять поля на верхнюю панель инструментов определённого блока ACF, обеспечивая прямое редактирование из заголовка блока в редакторе.

После добавления поля на панель инструментов оно отображается в виде кнопки. При нажатии на эту кнопку открывается всплывающее окно с элементом ввода поля, что обеспечивает более удобное и интегрированное редактирование.

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

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

Параметры

apply_filters( 'acf/blocks/top_toolbar_fields', $fields, $block, $content, $is_preview, $post_id, $wp_block, $context );

$fields (array) Массив полей, которые будут отображаться на панели инструментов.
По умолчанию — пустой массив.
$block (array) Массив свойств блока.
$content (string) Внутреннее содержимое блока.
$is_preview (bool) Логическое значение, равное true, когда блок отображается в режиме предварительного просмотра для редактирования.
$post_id (int) ID редактируемой записи.
$wp_block (WP_Block|null) Экземпляр WP_Block или null.
$context (array) Контекст блока.

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

(array) Изменённый массив полей.

Пример

В этом примере показано, как добавить поле изображения на панель инструментов блока ACF:

function my_block_top_toolbar_fields($block_top_toolbar_field_names, $block) { 
    // Если рассматриваемый блок — наш блок.
    if ( 'acf/my-acf-block' === $block['name'] ) {
        // Отображаем некоторые поля ACF на основной панели инструментов блока.
        return array( 'my_background_image_field', 'my_background_color_field');
    }


    // Если рассматриваемый блок — не наш блок, просто возвращаем переменную без изменений.
    return $block_top_toolbar_field_names;
}
add_filter( 'acf/blocks/top_toolbar_fields', 'my_block_top_toolbar_fields', 10, 2 );

Обновлено: 30.09.2026