Bricks 中文文档:bricks/dynamic_tags_list

📎 原始资料  |  下载原始 JSON 文件 (bricks-dynamic_tags_list.json) 前言 此筛选器允许你以编程方式将自定义 HTML 属性添加到 Bricks 中的任何元素。 用法 将代码加入子主题的 functions.php: add_filter( ‘bricks/dynamic_tags_list’, function( $tags ) { $tags[] = [ ‘name’ => ‘{my_custom_tag}’, ‘label’ => esc_html__( ‘My Custom Tag’, ‘my-plugin’ ), ‘gro…

前言

此筛选器允许你以编程方式将自定义 HTML 属性添加到 Bricks 中的任何元素。

用法

将代码加入子主题的 functions.php

add_filter( 'bricks/dynamic_tags_list', function( $tags ) {
    $tags[] = [
        'name'  => '{my_custom_tag}',
        'label' => esc_html__( 'My Custom Tag', 'my-plugin' ),
        'group' => 'My Plugin Group',
    ];


    return $tags;
} );

参数

  • $tags (array):动态数据标签定义数组。

示例代码

筛选返回值

add_filter( 'bricks/dynamic_tags_list', function( $tags ) {
    $tags[] = [
        'name'  => '{my_custom_tag}',
        'label' => esc_html__( 'My Custom Tag', 'my-plugin' ),
        'group' => 'My Plugin Group',
    ];


    return $tags;
} );

根据条件短路返回原值

根据条件跳过或修改返回值:

add_filter( 'bricks/dynamic_tags_list', function( $value, $tags ) {
    if ( is_admin() ) { return $value; }
    // TODO: custom logic here
    return $value;
} );

补充说明

更多细节可参考 官方文档