hooked_block

💡 云策文档标注

概述

本文档介绍了 WordPress 中的 hooked_block 过滤器，用于过滤特定 hooked block 的解析块数组。开发者可以通过此过滤器修改或抑制 hooked block 的输出。

$parsed_hooked_block = apply_filters( 'hooked_block', $parsed_hooked_block, $hooked_block_type, $relative_position, $parsed_anchor_block, $context );

过滤器可以返回 null 来抑制 hooked block 的显示。
相关函数包括 set_ignored_hooked_blocks_metadata() 和 insert_hooked_blocks()，用于管理 hooked block 的元数据和插入逻辑。

📄 原文内容

Filters the parsed block array for a given hooked block.

$parsed_hooked_blockarray|null: The parsed block array for the given hooked block type, or null to suppress the block.
$hooked_block_typestring: The hooked block type name.
$relative_positionstring: The relative position of the hooked block.
$parsed_anchor_blockarray: The anchor block, in parsed block array format.
$contextWP_Block_Template|WP_Post|array: The block template, template part, post object, or pattern that the anchor block belongs to.

$parsed_hooked_block = apply_filters( 'hooked_block', $parsed_hooked_block, $hooked_block_type, $relative_position, $parsed_anchor_block, $context );

Used by	Description
set_ignored_hooked_blocks_metadata()`wp-includes/blocks.php`	Adds a list of hooked block types to an anchor block’s ignored hooked block types.
insert_hooked_blocks()`wp-includes/blocks.php`	Returns the markup for blocks hooked to the given anchor block in a specific relative position.

Version	Description
6.5.0	Introduced.