Bricks 中文文档：bricks/handle_no_results_children_elements

📄 原始资料  |  展开查看原始 JSON（bricks-handle_no_results_children_elements.json）{ “name”: “bricks/handle_no_results_children_elements”, “kind”: “filter”, “url”: “https://academy.bricksbuilder.io/developer/hooks/filters/bricks-handle_no_results_children_elements/”, “scraped_at”: “2026-08-29”, “hook_…

📄 原始资料  |  展开查看原始 JSON（bricks-handle_no_results_children_elements.json） 
{
  "name": "bricks/handle_no_results_children_elements",
  "kind": "filter",
  "url": "https://academy.bricksbuilder.io/developer/hooks/filters/bricks-handle_no_results_children_elements/",
  "scraped_at": "2026-08-29",
  "hook_name": "bricks/handle_no_results_children_elements",
  "description": {
    "en": "Determines whether Bricks should run logic to handle children elements displayed when a query loop returns no results (e.g., ensuring scripts/styles are enqueued for “No results” content).",
    "zh": "此筛选器允许你控制在 Bricks 中元数据框的显示顺序。"
  },
  "parameters": [
    {
      "name": "run",
      "type": "bool",
      "type_zh": null,
      "description": {
        "en": "Whether to handle “No results” children logic. Defaults to true if Query Filters are enabled.",
        "zh": "是否处理“无结果”子元素逻辑。如果启用 Query Filters，则默认为 true。"
      }
    }
  ],
  "example_usage": "add_filter( 'bricks/handle_no_results_children_elements', function( $run ) {\n    // Example: Always enable this logic, even if native Query Filters are disabled\n    return true;\n} );"
}

前言

此筛选器允许你控制在 Bricks 中元数据框的显示顺序。

用法

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

add_filter( 'bricks/handle_no_results_children_elements', function( $run ) {
    // Example: Always enable this logic, even if native Query Filters are disabled
    return true;
} );

参数

  • $run (bool)：是否处理“无结果”子元素逻辑。如果启用 Query Filters，则默认为 true。

示例代码

筛选返回值

add_filter( 'bricks/handle_no_results_children_elements', function( $run ) {
    // Example: Always enable this logic, even if native Query Filters are disabled
    return true;
} );

根据条件短路返回原值

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

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

补充说明

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