wp_style_engine_get_stylesheet_from_css_rules( array $css_rules, array $options = array() ): string

Description

Parameters

$css_rulesarray

Required. A collection of CSS rules. @type array ...$0 { @type string $rules_group A parent CSS selector in the case of nested CSS, or a CSS nested @rule, such as @media (min-width: 80rem) or @layer module.

• $selectorstring

  A CSS selector.

• $declarationsstring[]

  An associative array of CSS definitions, e.g. array( "$property" => "$value", "$property" => "$value" ). }

$optionsarrayoptional

An array of options. Default empty array.Default: array()

• $contextstring|nulldefault: 'block-supports'. When set, the style engine will attempt to store the CSS rules

  An identifier describing the origin of the style object, e.g. 'block-supports' or 'global-styles'.

• $optimizebooldefault: false

  Whether to optimize the CSS output, e.g. combine rules.

• $prettifybool

  Whether to add new lines and indents to output. Defaults to whether the SCRIPT_DEBUG constant is defined.

Return

string

A string of compiled CSS declarations, or empty string.

Uses · 4

• wp_parse_args()Merges user defined arguments into defaults array.
• WP_Style_Engine::store_css_rule()Stores a CSS rule using the provided CSS selector and CSS declarations.
• WP_Style_Engine_CSS_Rule::__construct()Constructor.
• WP_Style_Engine::compile_stylesheet_from_css_rules()Returns a compiled stylesheet from stored CSS rules.

Used by · 6

• WP_Duotone::output_block_styles()Appends the used block duotone filter declarations to the inline block supports CSS.
• WP_Duotone::output_footer_assets()Outputs all necessary SVG for duotone filters, CSS for classic themes.
• block_core_gallery_render()Renders the `core/gallery` block on the server.
• wp_get_layout_style()Generates the CSS corresponding to the provided layout.
• wp_render_layout_support_flag()Renders the layout config to the block wrapper.
• wp_render_position_support()Renders position styles to the block wrapper.

Source

View on Trac ↗View on GitHub ↗

142function wp_style_engine_get_stylesheet_from_css_rules( $css_rules, $options = array() ) {143	if ( empty( $css_rules ) ) {144		return '';145	}146 147	$options = wp_parse_args(148		$options,149		array(150			'context' => null,151		)152	);153 154	$css_rule_objects = array();155	foreach ( $css_rules as $css_rule ) {156		if ( empty( $css_rule['selector'] ) || empty( $css_rule['declarations'] ) || ! is_array( $css_rule['declarations'] ) ) {157			continue;158		}159 160		$rules_group = $css_rule['rules_group'] ?? null;161		if ( ! empty( $options['context'] ) ) {162			WP_Style_Engine::store_css_rule( $options['context'], $css_rule['selector'], $css_rule['declarations'], $rules_group );163		}164 165		$css_rule_objects[] = new WP_Style_Engine_CSS_Rule( $css_rule['selector'], $css_rule['declarations'], $rules_group );166	}167 168	if ( empty( $css_rule_objects ) ) {169		return '';170	}171 172	return WP_Style_Engine::compile_stylesheet_from_css_rules( $css_rule_objects, $options );173}

History

Introduced in 6.1.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.9.7 tag, from src/wp-includes/style-engine.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.