filter_block_kses_value()
最后更新于:2021-11-26 04:06:40
filter_block_kses_value( string[]|string$value, array[]|string$allowed_html, string[]$allowed_protocols=array())Filters and sanitizes a parsed block attribute value to remove non-allowable HTML.
参数
- $value
-
(string[]|string) (Required) The attribute value to filter.
- $allowed_html
-
(array[]|string) (Required) An array of allowed HTML elements and attributes, or a context name such as ‘post’.
- $allowed_protocols
-
(string[]) (Optional) Array of allowed URL protocols.
Default value: array()
响应
(string[]|string) The filtered and sanitized result.
源文件
文件: gc-includes/blocks.php
function filter_block_kses_value( $value, $allowed_html, $allowed_protocols = array() ) {
if ( is_array( $value ) ) {
foreach ( $value as $key => $inner_value ) {
$filtered_key = filter_block_kses_value( $key, $allowed_html, $allowed_protocols );
$filtered_value = filter_block_kses_value( $inner_value, $allowed_html, $allowed_protocols );
if ( $filtered_key !== $key ) {
unset( $value[ $key ] );
}
$value[ $filtered_key ] = $filtered_value;
}
} elseif ( is_string( $value ) ) {
return gc_kses( $value, $allowed_html, $allowed_protocols );
}
return $value;
}