wp_get_global_styles() — описание функции WordPress на русском

Сигнатура

wp_get_global_styles( array $path = array(), array $context = array() ): mixed

Описание

Возвращает стили, полученные в результате объединения данных ядра, темы и пользователя.

Параметры

$path array необязательный = array()

Путь к конкретному стилю, который нужно получить. Необязательный. Если пусто, будут возвращены все стили.

$context array необязательный = array()

Метаданные о том, откуда извлекать $path. Необязательный. block_name string Из какого блока извлекать стили. Если пусто, будут возвращены стили для глобального контекста. origin string Из какого источника брать данные. Допустимые значения — 'all' (ядро, тема и пользователь) или 'base' (ядро и тема). Если пусто или значение неизвестно, используется 'all'. transforms array Какие преобразования применять. Допустимое значение — array( 'resolve-variables' ). Если задано, переменные в стилях заменяются их значениями.

Возвращаемое значение

mixed

Исходный код

wp-includes/global-styles-and-settings.php:111

function wp_get_global_styles( $path = array(), $context = array() ) {
	if ( ! empty( $context['block_name'] ) ) {
		$path = array_merge( array( 'blocks', $context['block_name'] ), $path );
	}

	$origin = 'custom';
	if ( isset( $context['origin'] ) && 'base' === $context['origin'] ) {
		$origin = 'theme';
	}

	$resolve_variables = isset( $context['transforms'] )
	&& is_array( $context['transforms'] )
	&& in_array( 'resolve-variables', $context['transforms'], true );

	$merged_data = WP_Theme_JSON_Resolver::get_merged_data( $origin );
	if ( $resolve_variables ) {
		$merged_data = WP_Theme_JSON::resolve_variables( $merged_data );
	}
	$styles = $merged_data->get_raw_data()['styles'];
	return _wp_array_get( $styles, $path, $styles );
}

История изменений

Версия	Описание
6.3.0	transforms is now usable in the context parameter. In case [transforms]['resolve_variables'] is defined, variables are resolved to their value in the styles.
5.9.0	Introduced.