wp_get_block_name_from_theme_json_path

函数


wp_get_block_name_from_theme_json_path ( $path )
Access
Private
参数
  • (array)
    $path
    An array of keys describing the path to a property in theme.json.
    Required:
返回值
  • (string) Identified block name, or empty string if none found.
定义位置
  • wp-includes/global-styles-and-settings.php
    , line 344
引入
6.3.0
弃用

从给定的 theme.json 路径中获取区块名称。

function wp_get_block_name_from_theme_json_path( $path ) {
	// Block name is expected to be the third item after 'styles' and 'blocks'.
	if (
		count( $path ) >= 3
		&& 'styles' === $path[0]
		&& 'blocks' === $path[1]
		&& str_contains( $path[2], '/' )
	) {
		return $path[2];
	}

	/*
	 * As fallback and for backward compatibility, allow any core block to be
	 * at any position.
	 */
	$result = array_values(
		array_filter(
			$path,
			static function ( $item ) {
				if ( str_contains( $item, 'core/' ) ) {
					return true;
				}
				return false;
			}
		)
	);
	if ( isset( $result[0] ) ) {
		return $result[0];
	}
	return '';
}