Bricks 中文文档：bricks/dynamic_data/text_separator

前言

通过此筛选器，可对元素执行自定义 PHP 逻辑，进而可以控制元素是否被渲染。

用法

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

add_filter( 'bricks/dynamic_data/text_separator', function( $sep, $tag, $post_id, $filters ) {
    // Example: Use a line break separator for a specific custom field
    if ( $tag === 'my_repeater_field' ) {
        return '
';
    }


    return $sep;
}, 10, 4 );

参数

• $sep (string)：分隔符字符串。
• $tag (string)：动态数据标签。
• $post_id (int)：文章上下文的 ID。
• $filters (array)：应用于标签的修饰符数组。

示例代码

筛选返回值

add_filter( 'bricks/dynamic_data/text_separator', function( $sep, $tag, $post_id, $filters ) {
    // Example: Use a line break separator for a specific custom field
    if ( $tag === 'my_repeater_field' ) {
        return '
';
    }


    return $sep;
}, 10, 4 );

根据条件短路返回原值

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

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

补充说明

更多细节可参考 官方文档。