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

Parameters

$patharrayoptional

Path to the specific style to retrieve. Optional. If empty, will return all styles.Default: array()

$contextarrayoptional

Metadata to know where to retrieve the $path from. Optional.Default: array()

• $block_namestring

  Which block to retrieve the styles from. If empty, it'll return the styles for the global context.

• $originstring

  Which origin to take data from. Valid values are 'all' (core, theme, and user) or 'base' (core and theme). If empty or unknown, 'all' is used.

• $transformsarray

  Which transformation(s) to apply. Valid value is array( 'resolve-variables' ). If defined, variables are resolved to their value in the styles.

Return

mixed

The styles array or individual style value to retrieve.

Uses · 3

• _wp_array_get()Accesses an array in depth based on a path of keys.
• WP_Theme_JSON_Resolver::get_merged_data()Returns the data merged from multiple origins.
• WP_Theme_JSON::resolve_variables()Resolves the values of CSS variables in the given styles.

Used by · 1

• block_core_image_print_lightbox_overlay()

Source

View on Trac ↗View on GitHub ↗

114function wp_get_global_styles( $path = array(), $context = array() ) {115	if ( ! empty( $context['block_name'] ) ) {116		$path = array_merge( array( 'blocks', $context['block_name'] ), $path );117	}118 119	$origin = 'custom';120	if ( isset( $context['origin'] ) && 'base' === $context['origin'] ) {121		$origin = 'theme';122	}123 124	$resolve_variables = isset( $context['transforms'] )125	&& is_array( $context['transforms'] )126	&& in_array( 'resolve-variables', $context['transforms'], true );127 128	$merged_data = WP_Theme_JSON_Resolver::get_merged_data( $origin );129	if ( $resolve_variables ) {130		$merged_data = WP_Theme_JSON::resolve_variables( $merged_data );131	}132	$styles = $merged_data->get_raw_data()['styles'];133	return _wp_array_get( $styles, $path, $styles );134}

History

Introduced in 5.9.0. Unchanged from 6.7.7 through 7.1.0.

1. 6.7.7
2. 6.8.8
3. 6.9.7
4. 7.0.4
5. 7.1.0

Signature, return type and hooks compared across 5 parsed releases.

About this page

Parsed data

Generated from the wordpress-develop 6.8.8 tag, from src/wp-includes/global-styles-and-settings.php, and regenerated for each WordPress release so it tracks the code rather than a snapshot of it.

Corrections

Something wrong on this page? Report it and it gets fixed in the next regeneration.