函数文档

wp_skip_dimensions_serialization()

💡 云策文档标注

概述

wp_skip_dimensions_serialization() 是一个已弃用的 WordPress 函数,用于检查当前区块的尺寸属性是否应序列化。自 WordPress 6.0.0 起,建议使用 wp_should_skip_block_supports_serialization() 替代。

关键要点

  • 该函数已弃用,自 6.0.0 版本起应使用 wp_should_skip_block_supports_serialization()
  • 函数检查区块类型是否支持 __experimentalDimensions 并跳过序列化
  • 返回布尔值,指示是否序列化间距支持样式和类

代码示例

function wp_skip_dimensions_serialization( $block_type ) {
    _deprecated_function( __FUNCTION__, '6.0.0', 'wp_should_skip_block_supports_serialization()' );

    $dimensions_support = isset( $block_type->supports['__experimentalDimensions'] )
        ? $block_type->supports['__experimentalDimensions']
        : false;

    return is_array( $dimensions_support ) &&
        array_key_exists( '__experimentalSkipSerialization', $dimensions_support ) &&
        $dimensions_support['__experimentalSkipSerialization'];
}

注意事项

  • 函数在 5.9.0 版本引入,6.0.0 版本弃用
  • 相关函数包括 _deprecated_function() 用于标记弃用

📄 原文内容

Checks whether serialization of the current block’s dimensions 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_dimensions_serialization( $block_type ) {
	_deprecated_function( __FUNCTION__, '6.0.0', 'wp_should_skip_block_supports_serialization()' );

	$dimensions_support = isset( $block_type->supports['__experimentalDimensions'] )
		? $block_type->supports['__experimentalDimensions']
		: false;

	return is_array( $dimensions_support ) &&
		array_key_exists( '__experimentalSkipSerialization', $dimensions_support ) &&
		$dimensions_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.