wp_style_engine_get_stylesheet_from_css_rules( array $css_rules, array $options = array() ): string
Returns compiled CSS from a collection of selectors and declarations.
Description
Useful for returning a compiled stylesheet from any collection of CSS selector + declarations.
Example usage:
$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 );Returns:
.elephant-are-cool{color:gray;width:3em}Parameters
-
$css_rulesarray Required -
Required. A collection of CSS rules.
...$0arrayselectorstringA CSS selector.declarationsstring[]An associative array of CSS definitions, e.g.array( "$property" => "$value", "$property" => "$value" ).
$optionsarray OptionalAn array of options.
contextstring|nullAn identifier describing the origin of the style object, e.g.'block-supports'or'global-styles'. Default'block-supports'.
When set, the style engine will attempt to store the CSS rules.optimizeboolWhether to optimize the CSS output, e.g. combine rules.
Default true.prettifyboolWhether to add new lines and indents to output.
Defaults to whether theSCRIPT_DEBUGconstant is defined.
Default:
array()
Return
string A string of compiled CSS declarations, or empty string.
Source
File:
wp-includes/style-engine.php. View all referencesfunction wp_style_engine_get_stylesheet_from_css_rules( $css_rules, $options = array() ) { if ( empty( $css_rules ) ) { return ''; } $options = wp_parse_args( $options, array( 'context' => null, ) ); $css_rule_objects = array(); foreach ( $css_rules as $css_rule ) { if ( empty( $css_rule['selector'] ) || empty( $css_rule['declarations'] ) || ! is_array( $css_rule['declarations'] ) ) { continue; } if ( ! empty( $options['context'] ) ) { WP_Style_Engine::store_css_rule( $options['context'], $css_rule['selector'], $css_rule['declarations'] ); } $css_rule_objects[] = new WP_Style_Engine_CSS_Rule( $css_rule['selector'], $css_rule['declarations'] ); } if ( empty( $css_rule_objects ) ) { return ''; } return WP_Style_Engine::compile_stylesheet_from_css_rules( $css_rule_objects, $options ); }
Changelog
Changelog Version Description 6.1.0 Introduced.
User Contributed Notes