generate_block_asset_handle

函数
generate_block_asset_handle ( $block_name, $field_name, $index = 0 )
参数
  • (string) $block_name Name of the block.
    Required:
  • (string) $field_name Name of the metadata field.
    Required:
  • (int) $index Optional. Index of the asset when multiple items passed. Default 0.
    Required:
返回值
  • (string) Generated asset name for the block's field.
定义位置
相关方法
register_block_style_handleregister_block_script_handlerender_block_core_filewp_generate_block_templates_export_filewp_enqueue_block_style
引入
5.5.0
弃用
-

generate_block_asset_handle: 这个函数用来为一个区块生成一个唯一的资产句柄。这个句柄用于识别与该块相关的资产,例如它的脚本和样式文件。

根据区块的名称和提供的字段名生成资产的名称。

function generate_block_asset_handle( $block_name, $field_name, $index = 0 ) {
	if ( 0 === strpos( $block_name, 'core/' ) ) {
		$asset_handle = str_replace( 'core/', 'wp-block-', $block_name );
		if ( 0 === strpos( $field_name, 'editor' ) ) {
			$asset_handle .= '-editor';
		}
		if ( 0 === strpos( $field_name, 'view' ) ) {
			$asset_handle .= '-view';
		}
		if ( $index > 0 ) {
			$asset_handle .= '-' . ( $index + 1 );
		}
		return $asset_handle;
	}

	$field_mappings = array(
		'editorScript' => 'editor-script',
		'script'       => 'script',
		'viewScript'   => 'view-script',
		'editorStyle'  => 'editor-style',
		'style'        => 'style',
	);
	$asset_handle   = str_replace( '/', '-', $block_name ) .
		'-' . $field_mappings[ $field_name ];
	if ( $index > 0 ) {
		$asset_handle .= '-' . ( $index + 1 );
	}
	return $asset_handle;
}

常见问题

FAQs
查看更多 >