函数文档

wp_create_block_style_variation_instance_name()

💡 云策文档标注

概述

此函数用于生成块样式变体的唯一实例名称,基于块对象和变体slug。自WordPress 6.7.0起已弃用,建议使用wp_unique_id()替代。

关键要点

  • 函数wp_create_block_style_variation_instance_name()接受块对象和变体slug作为参数,返回唯一变体名称。
  • 返回值格式为变体slug后跟连字符和块对象的MD5哈希值。
  • 该函数在WordPress 6.7.0中被弃用,推荐使用wp_unique_id()函数来生成唯一标识符。

代码示例

function wp_create_block_style_variation_instance_name( $block, $variation ) {
    _deprecated_function( __FUNCTION__, '6.7.0', 'wp_unique_id' );
    return $variation . '--' . md5( serialize( $block ) );
}

注意事项

  • 此函数已弃用,新代码应避免使用,转而使用wp_unique_id()。
  • 使用_deprecated_function()标记弃用,并在调用时显示警告信息。

📄 原文内容

Generate block style variation instance name.

Parameters

$blockarrayrequired
Block object.
$variationstringrequired
Slug for the block style variation.

Return

string The unique variation name.

Source

function wp_create_block_style_variation_instance_name( $block, $variation ) {
	_deprecated_function( __FUNCTION__, '6.7.0', 'wp_unique_id' );
	return $variation . '--' . md5( serialize( $block ) );
}

Changelog

Version Description
6.7.0 Deprecated. Use wp_unique_id( $variation . '--' ) instead.
6.6.0 Introduced.