WP_Theme_JSON::get_stylesheet( string[] $types = array('variables', 'styles', 'presets'), string[] $origins = null, array $options = array() ): string

Parameters

$typesstring[]optional

Types of styles to load. Will load all by default. It accepts: - variables: only the CSS Custom Properties for presets & custom ones. - styles: only the styles section in theme.json. - presets: only the classes for the presets. - base-layout-styles: only the base layout styles. - custom-css: only the custom CSS.Default: array('variables', 'styles', 'presets')

$originsstring[]optional

A list of origins to include. By default it includes VALID_ORIGINS.Default: null

$optionsarrayoptional

An array of options for now used for internal purposes only (may change without notice).Default: array()

• $scopestringdefault: false

  Makes sure all style are scoped to a given selector @type string $root_selector Overwrites and forces a given selector to be used on the root node @type bool $skip_root_layout_styles Omits root layout styles from the generated stylesheet.

• $include_block_style_variationsbooldefault: false

  Includes styles for block style variations in the generated stylesheet.

Return

string

The resulting stylesheet.

Uses · 12

• _deprecated_argument()Marks a function argument as deprecated and inform when it has been used.
• _wp_array_get()Accesses an array in depth based on a path of keys.
• static::get_blocks_metadata()
• static::get_style_nodes()
• static::get_setting_nodes()
• static::scope_selector()
• static::scope_style_node_selectors()
• WP_Theme_JSON::get_css_variables()Converts each styles section into a list of rulesets to be appended to the stylesheet.
• WP_Theme_JSON::get_root_layout_rules()Outputs the CSS for layout rules on the root.
• WP_Theme_JSON::get_block_classes()Converts each style section into a list of rulesets containing the block styles to be appended to the stylesheet.
• WP_Theme_JSON::get_layout_styles()Gets the CSS layout rules for a particular block from theme.json layout definitions.
• WP_Theme_JSON::get_preset_classes()Creates new rulesets as classes for each preset value such as:

Source

View on Trac ↗View on GitHub ↗

1334	public function get_stylesheet( $types = array( 'variables', 'styles', 'presets' ), $origins = null, $options = array() ) {1335		if ( null === $origins ) {1336			$origins = static::VALID_ORIGINS;1337		}1338 1339		if ( is_string( $types ) ) {1340			// Dispatch error and map old arguments to new ones.1341			_deprecated_argument( __FUNCTION__, '5.9.0' );1342			if ( 'block_styles' === $types ) {1343				$types = array( 'styles', 'presets' );1344			} elseif ( 'css_variables' === $types ) {1345				$types = array( 'variables' );1346			} else {1347				$types = array( 'variables', 'styles', 'presets' );1348			}1349		}1350 1351		$blocks_metadata = static::get_blocks_metadata();1352		$style_nodes     = static::get_style_nodes( $this->theme_json, $blocks_metadata, $options );1353		$setting_nodes   = static::get_setting_nodes( $this->theme_json, $blocks_metadata );1354 1355		$root_style_key    = array_search( static::ROOT_BLOCK_SELECTOR, array_column( $style_nodes, 'selector' ), true );1356		$root_settings_key = array_search( static::ROOT_BLOCK_SELECTOR, array_column( $setting_nodes, 'selector' ), true );1357 1358		if ( ! empty( $options['scope'] ) ) {1359			foreach ( $setting_nodes as &$node ) {1360				$node['selector'] = static::scope_selector( $options['scope'], $node['selector'] );1361			}1362			foreach ( $style_nodes as &$node ) {1363				$node = static::scope_style_node_selectors( $options['scope'], $node );1364			}1365			unset( $node );1366		}1367 1368		if ( ! empty( $options['root_selector'] ) ) {1369			if ( false !== $root_settings_key ) {1370				$setting_nodes[ $root_settings_key ]['selector'] = $options['root_selector'];1371			}1372			if ( false !== $root_style_key ) {1373				$style_nodes[ $root_style_key ]['selector'] = $options['root_selector'];1374			}1375		}1376 1377		$stylesheet = '';1378 1379		if ( in_array( 'variables', $types, true ) ) {1380			$stylesheet .= $this->get_css_variables( $setting_nodes, $origins );1381		}1382 1383		if ( in_array( 'styles', $types, true ) ) {1384			if ( false !== $root_style_key && empty( $options['skip_root_layout_styles'] ) ) {1385				$stylesheet .= $this->get_root_layout_rules( $style_nodes[ $root_style_key ]['selector'], $style_nodes[ $root_style_key ] );1386			}1387			$stylesheet .= $this->get_block_classes( $style_nodes );1388		} elseif ( in_array( 'base-layout-styles', $types, true ) ) {1389			$root_selector          = static::ROOT_BLOCK_SELECTOR;1390			$columns_selector       = '.wp-block-columns';1391			$post_template_selector = '.wp-block-post-template';1392			if ( ! empty( $options['scope'] ) ) {1393				$root_selector          = static::scope_selector( $options['scope'], $root_selector );1394				$columns_selector       = static::scope_selector( $options['scope'], $columns_selector );1395				$post_template_selector = static::scope_selector( $options['scope'], $post_template_selector );1396			}1397			if ( ! empty( $options['root_selector'] ) ) {1398				$root_selector = $options['root_selector'];1399			}1400			/*1401			 * Base layout styles are provided as part of `styles`, so only output separately if explicitly requested.1402			 * For backwards compatibility, the Columns block is explicitly included, to support a different default gap value.1403			 */1404			$base_styles_nodes = array(1405				array(1406					'path'     => array( 'styles' ),1407					'selector' => $root_selector,1408				),1409				array(1410					'path'     => array( 'styles', 'blocks', 'core/columns' ),1411					'selector' => $columns_selector,1412					'name'     => 'core/columns',1413				),

History

Introduced in 5.8.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/class-wp-theme-json.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.