函数原型
filter_block_kses( WP_Block_Parser_Block $block, array[]|string $allowed_html, string[] $allowed_protocols = array() ): array
函数描述
Filters and sanitizes a parsed block to remove non-allowable HTML from block attribute values.
是否弃用
未弃用
函数参数
-
$block
WP_Block_Parser_Block
Required - The parsed block object.
-
$allowed_html
array[]|string
Required - An array of allowed HTML elements and attributes, or a context name such as
'post'. See wp_kses_allowed_html() for the list of accepted context names. -
$allowed_protocols
string[]
Optional - Array of allowed URL protocols.
Defaults to the result of wp_allowed_protocols() .Default:
array()
函数返回值
array The filtered and sanitized block object result.
函数位置
File: wp-includes/blocks.php.
函数源码
function filter_block_kses( $block, $allowed_html, $allowed_protocols = array() ) {
$block['attrs'] = filter_block_kses_value( $block['attrs'], $allowed_html, $allowed_protocols );
if ( is_array( $block['innerBlocks'] ) ) {
foreach ( $block['innerBlocks'] as $i => $inner_block ) {
$block['innerBlocks'][ $i ] = filter_block_kses( $inner_block, $allowed_html, $allowed_protocols );
}
}
return $block;
}
源码链接
变更日志
| Version | Description |
|---|---|
| 5.3.1 | Introduced. |
