wp_get_block_name_from_theme_json_path() │ WP 6.3.0

Gets the block name from a given theme.json path.

Внутренняя функция — эта функция рассчитана на использование самим ядром. Не рекомендуется использовать эту функцию в своем коде.

Хуков нет.

Возвращает

Строку. Identified block name, or empty string if none found.

Использование

wp_get_block_name_from_theme_json_path( $path );
$path(массив) (обязательный)
An array of keys describing the path to a property in theme.json.

Список изменений

С версии 6.3.0 Введена.

Код wp_get_block_name_from_theme_json_path() WP 6.6.2

wp-includes/global-styles-and-settings.php 
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 '';
}