wp_skip_spacing_serialization()
云策文档标注
概述
wp_skip_spacing_serialization() 是一个已弃用的 WordPress 函数,用于检查当前区块的间距属性是否应跳过序列化。自 WordPress 6.0.0 起,建议使用 wp_should_skip_block_supports_serialization() 替代。
关键要点
- 函数 wp_skip_spacing_serialization() 已弃用,自 6.0.0 版本起应改用 wp_should_skip_block_supports_serialization()。
- 该函数接受一个 WP_Block_Type 参数,返回布尔值,指示是否序列化间距支持的样式和类。
- 函数内部检查区块类型支持中的 spacing 数组是否包含 __experimentalSkipSerialization 键,并返回其值。
代码示例
function wp_skip_spacing_serialization( $block_type ) {
_deprecated_function( __FUNCTION__, '6.0.0', 'wp_should_skip_block_supports_serialization()' );
$spacing_support = isset( $block_type->supports['spacing'] )
? $block_type->supports['spacing']
: false;
return is_array( $spacing_support ) &&
array_key_exists( '__experimentalSkipSerialization', $spacing_support ) &&
$spacing_support['__experimentalSkipSerialization'];
}注意事项
- 使用此函数会触发弃用警告,建议开发者更新代码以避免未来兼容性问题。
- 相关函数 _deprecated_function() 用于标记函数为弃用状态。
原文内容
Checks whether serialization of the current block’s spacing properties should occur.
Description
See also
Parameters
$block_typeWP_Block_Typerequired-
Block type.
Source
function wp_skip_spacing_serialization( $block_type ) {
_deprecated_function( __FUNCTION__, '6.0.0', 'wp_should_skip_block_supports_serialization()' );
$spacing_support = isset( $block_type->supports['spacing'] )
? $block_type->supports['spacing']
: false;
return is_array( $spacing_support ) &&
array_key_exists( '__experimentalSkipSerialization', $spacing_support ) &&
$spacing_support['__experimentalSkipSerialization'];
}