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

Description

$css_rules = array(
 array(
 'selector' => '.elephant-are-cool',
 'declarations' => array(
 'color' => 'gray',
 'width' => '3em',
 ),
 ),
);

$css = wp_style_engine_get_stylesheet_from_css_rules( $css_rules );

.elephant-are-cool{color:gray;width:3em}

Compatibility

Present in every tracked release (6.7.7 to 7.1.0), and compiles on PHP 7.4 through 8.6-dev.

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[]|WP_Style_Engine_CSS_Declarations

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

$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 value

string

A string of compiled CSS declarations, or empty string.

Performance profile

How much work a call to wp_style_engine_get_stylesheet_from_css_rules() does, and what it touches: the algorithmic scaling, the Zend instruction count per call across PHP versions, the hooks it hands control to, and the core code that calls it. Measured from the compiled opcodes, not a stopwatch, so every number is identical on any machine running the same PHP version, and every function in core is ranked by cost.

Cost class

Light

Touches nothing outside its own arguments.

Scaling

Scales with input

The body loops, so the work grows with what you pass in.

Instructions

5–20

Executed per call on PHP 8.5, depending on the branch taken. The body compiles to 60.

Plugin surface

None

Nothing here hands control to plugin code.

Called by

9

9 places in core call this, so the cost is paid more often than your own code shows.

What one call costs · 3 distinct outcomes

One number would be a lie: the work depends on which branch runs. These are every distinct cost wp_style_engine_get_stylesheet_from_css_rules() can have, taken from its control-flow graph on PHP 8.5.

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 · 9

• 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.
• block_core_navigation_add_support_classes_to_container()Adds Navigation block support classes to inner list containers.
• wp_get_layout_style()Generates the CSS corresponding to the provided layout.
• wp_render_block_states_support()Renders per-instance state styles on the frontend.
• wp_render_block_visibility_support()Render nothing if the block is hidden, or add viewport visibility styles.
• 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 code

View on Trac ↗View on GitHub ↗

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

Changelog

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 7.1.0 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.