Bricks 中文文档：bricks/dynamic_data/tag_value_parsed

标签TAGS:

2026年8月30日

📄 原始资料 | 展开查看原始 JSON（bricks-dynamic_data-tag_value_parsed.json）{ “name”: “bricks/dynamic_data/tag_value_parsed”, “kind”: “action”, “url”: “https://academy.bricksbuilder.io/developer/hooks/actions/bricks-dynamic_data-tag_value_parsed/”, “scraped_at”: “2026-08-29”, “hook_name”: “bricks/dyn…

📄 原始资料 | 展开查看原始 JSON（bricks-dynamic_data-tag_value_parsed.json）

{
  "name": "bricks/dynamic_data/tag_value_parsed",
  "kind": "action",
  "url": "https://academy.bricksbuilder.io/developer/hooks/actions/bricks-dynamic_data-tag_value_parsed/",
  "scraped_at": "2026-08-29",
  "hook_name": "bricks/dynamic_data/tag_value_parsed",
  "description": {
    "en": "Runs after Bricks parses a dynamic data tag value. This action is for observing or reacting to the parsed value; it does not change the returned value.",
    "zh": "Bricks 解析完某个动态数据标签的值之后触发。此动作用于观察或响应解析后的值，不会改变返回值。"
  },
  "parameters": [
    {
      "name": "value",
      "type": "mixed",
      "type_zh": null,
      "description": {
        "en": "The parsed dynamic data value.",
        "zh": "已解析的动态数据值。"
      }
    },
    {
      "name": "tag",
      "type": "string",
      "type_zh": null,
      "description": {
        "en": "The parsed tag name.",
        "zh": "已解析的标签名称。"
      }
    },
    {
      "name": "original_tag",
      "type": "string",
      "type_zh": null,
      "description": {
        "en": "The original dynamic data tag before parsing.",
        "zh": "解析之前的原始动态数据标签。"
      }
    },
    {
      "name": "args",
      "type": "array",
      "type_zh": null,
      "description": {
        "en": "Parsed tag arguments.",
        "zh": "已解析的标签参数。"
      }
    },
    {
      "name": "post",
      "type": "WP_Post|int|null",
      "type_zh": null,
      "description": {
        "en": "The post context used while parsing.",
        "zh": "解析时使用的文章上下文。"
      }
    },
    {
      "name": "context",
      "type": "string",
      "type_zh": null,
      "description": {
        "en": "The render context, such as text, link, or image.",
        "zh": "渲染上下文，例如 text、link 或 image。"
      }
    },
    {
      "name": "provider",
      "type": "string|null",
      "type_zh": null,
      "description": {
        "en": "The provider that resolved the tag, when available.",
        "zh": "解析该标签的 provider（如可用）。"
      }
    }
  ],
  "example_usage": "add_action( 'bricks/dynamic_data/tag_value_parsed', function( $value, $tag, $original_tag, $args, $post, $context, $provider ) {\n    // Log or inspect parsed dynamic data values.\n}, 10, 7 );"
}

前言

Bricks 解析完某个动态数据标签的值之后触发。此动作用于观察或响应解析后的值，不会改变返回值。

用法

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

add_action( 'bricks/dynamic_data/tag_value_parsed', function( $value, $tag, $original_tag, $args, $post, $context, $provider ) {
    // Log or inspect parsed dynamic data values.
}, 10, 7 );

参数

$value (mixed)：已解析的动态数据值。
$tag (string)：已解析的标签名称。
$original_tag (string)：解析之前的原始动态数据标签。
$args (array)：已解析的标签参数。
$post (WP_Post|int|null)：解析时使用的文章上下文。
$context (string)：渲染上下文，例如 text、link 或 image。
$provider (string|null)：解析该标签的 provider（如可用）。

示例代码

官方示例用法

add_action( 'bricks/dynamic_data/tag_value_parsed', function( $value, $tag, $original_tag, $args, $post, $context, $provider ) {
    // Log or inspect parsed dynamic data values.
}, 10, 7 );

根据条件短路返回原值

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

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

补充说明

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