函数文档

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.

Return

bool Whether to serialize spacing support styles & classes.

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'];
}

Changelog

Version Description
6.0.0 Deprecated. Use wp_should_skip_block_supports_serialization() introduced in 6.0.0.
5.9.0 Introduced.