WP_Theme_JSON::get_css_variables( array $nodes )

This function’s access is marked private. This means it is not intended for use by plugin or theme developers, only in other core functions. It is listed here for completeness.

Converts each styles section into a list of rulesets to be appended to the stylesheet.

Description

These rulesets contain all the css variables (custom variables and preset variables).

See glossary at https://developer.mozilla.org/en-US/docs/Web/CSS/Syntax

For each section this creates a new ruleset such as:

block-selector {
  --wp--preset--category--slug: value;
  --wp--custom--variable: value;
}

Parameters

$nodes

(array) (Required) Nodes with settings.

Return

(string) The new stylesheet.

Source

File: wp-includes/class-wp-theme-json.php 

private function get_css_variables( $nodes ) {
		$stylesheet = '';
		foreach ( $nodes as $metadata ) {
			if ( null === $metadata['selector'] ) {
				continue;
			}

			$selector = $metadata['selector'];

			$node         = _wp_array_get( $this->theme_json, $metadata['path'], array() );
			$declarations = array_merge( self::compute_preset_vars( $node ), self::compute_theme_vars( $node ) );

			$stylesheet .= self::to_ruleset( $selector, $declarations );
		}

		return $stylesheet;
	}

Uses

Uses Description
wp-includes/class-wp-theme-json.php: WP_Theme_JSON::compute_theme_vars()

Given an array of settings, it extracts the CSS Custom Properties for the custom values and adds them to the $declarations array following the format:
wp-includes/class-wp-theme-json.php: WP_Theme_JSON::compute_preset_vars()

Given the block settings, it extracts the CSS Custom Properties for the presets and adds them to the $declarations array following the format:
wp-includes/class-wp-theme-json.php: WP_Theme_JSON::to_ruleset()

Given a selector and a declaration list, creates the corresponding ruleset.
wp-includes/functions.php: _wp_array_get()

Accesses an array in depth based on a path of keys.

Used By

Used By Description
wp-includes/class-wp-theme-json.php: WP_Theme_JSON::get_stylesheet()

Returns the stylesheet that results of processing the theme.json structure this object represents.

Changelog

Version Description
5.8.0 Introduced.

© 2003–2021 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/classes/wp_theme_json/get_css_variables