<?php

[0] Fix | Delete

/**

[1] Fix | Delete

* Style Engine: WP_Style_Engine class

[2] Fix | Delete

*

[3] Fix | Delete

* @package WordPress

[4] Fix | Delete

* @subpackage StyleEngine

[5] Fix | Delete

* @since 6.1.0

[6] Fix | Delete

*/

[7] Fix | Delete

[8] Fix | Delete

/**

[9] Fix | Delete

* The main class integrating all other WP_Style_Engine_* classes.

[10] Fix | Delete

*

[11] Fix | Delete

* The Style Engine aims to provide a consistent API for rendering styling for blocks

[12] Fix | Delete

* across both client-side and server-side applications.

[13] Fix | Delete

*

[14] Fix | Delete

* This class is final and should not be extended.

[15] Fix | Delete

*

[16] Fix | Delete

* This class is for internal Core usage and is not supposed to be used by extenders

[17] Fix | Delete

* (plugins and/or themes). This is a low-level API that may need to do breaking changes.

[18] Fix | Delete

* Please, use wp_style_engine_get_styles() instead.

[19] Fix | Delete

*

[20] Fix | Delete

* @access private

[21] Fix | Delete

* @since 6.1.0

[22] Fix | Delete

* @since 6.3.0 Added support for text-columns.

[23] Fix | Delete

* @since 6.4.0 Added support for background.backgroundImage.

[24] Fix | Delete

* @since 6.5.0 Added support for background.backgroundPosition,

[25] Fix | Delete

* background.backgroundRepeat and dimensions.aspectRatio.

[26] Fix | Delete

*/

[27] Fix | Delete

#[AllowDynamicProperties]

[28] Fix | Delete

final class WP_Style_Engine {

[29] Fix | Delete

/**

[30] Fix | Delete

* Style definitions that contain the instructions to parse/output valid Gutenberg styles from a block's attributes.

[31] Fix | Delete

*

[32] Fix | Delete

* For every style definition, the following properties are valid:

[33] Fix | Delete

*

[34] Fix | Delete

* - classnames => (array) an array of classnames to be returned for block styles. The key is a classname or pattern.

[35] Fix | Delete

* A value of `true` means the classname should be applied always. Otherwise, a valid CSS property (string)

[36] Fix | Delete

* to match the incoming value, e.g., "color" to match var:preset|color|somePresetSlug.

[37] Fix | Delete

* - css_vars => (array) an array of key value pairs used to generate CSS var values.

[38] Fix | Delete

* The key should be the CSS property name that matches the second element of the preset string value,

[39] Fix | Delete

* i.e., "color" in var:preset|color|somePresetSlug. The value is a CSS var pattern (e.g. `--wp--preset--color--$slug`),

[40] Fix | Delete

* whose `$slug` fragment will be replaced with the preset slug, which is the third element of the preset string value,

[41] Fix | Delete

* i.e., `somePresetSlug` in var:preset|color|somePresetSlug.

[42] Fix | Delete

* - property_keys => (array) array of keys whose values represent a valid CSS property, e.g., "margin" or "border".

[43] Fix | Delete

* - path => (array) a path that accesses the corresponding style value in the block style object.

[44] Fix | Delete

* - value_func => (string) the name of a function to generate a CSS definition array for a particular style object. The output of this function should be `array( "$property" => "$value", ... )`.

[45] Fix | Delete

*

[46] Fix | Delete

* @since 6.1.0

[47] Fix | Delete

* @var array

[48] Fix | Delete

*/

[49] Fix | Delete

const BLOCK_STYLE_DEFINITIONS_METADATA = array(

[50] Fix | Delete

'background' => array(

[51] Fix | Delete

'backgroundImage' => array(

[52] Fix | Delete

'property_keys' => array(

[53] Fix | Delete

'default' => 'background-image',

[54] Fix | Delete

),

[55] Fix | Delete

'value_func' => array( self::class, 'get_url_or_value_css_declaration' ),

[56] Fix | Delete

'path' => array( 'background', 'backgroundImage' ),

[57] Fix | Delete

),

[58] Fix | Delete

'backgroundPosition' => array(

[59] Fix | Delete

'property_keys' => array(

[60] Fix | Delete

'default' => 'background-position',

[61] Fix | Delete

),

[62] Fix | Delete

'path' => array( 'background', 'backgroundPosition' ),

[63] Fix | Delete

),

[64] Fix | Delete

'backgroundRepeat' => array(

[65] Fix | Delete

'property_keys' => array(

[66] Fix | Delete

'default' => 'background-repeat',

[67] Fix | Delete

),

[68] Fix | Delete

'path' => array( 'background', 'backgroundRepeat' ),

[69] Fix | Delete

),

[70] Fix | Delete

'backgroundSize' => array(

[71] Fix | Delete

'property_keys' => array(

[72] Fix | Delete

'default' => 'background-size',

[73] Fix | Delete

),

[74] Fix | Delete

'path' => array( 'background', 'backgroundSize' ),

[75] Fix | Delete

),

[76] Fix | Delete

),

[77] Fix | Delete

'color' => array(

[78] Fix | Delete

'text' => array(

[79] Fix | Delete

'property_keys' => array(

[80] Fix | Delete

'default' => 'color',

[81] Fix | Delete

),

[82] Fix | Delete

'path' => array( 'color', 'text' ),

[83] Fix | Delete

'css_vars' => array(

[84] Fix | Delete

'color' => '--wp--preset--color--$slug',

[85] Fix | Delete

),

[86] Fix | Delete

'classnames' => array(

[87] Fix | Delete

'has-text-color' => true,

[88] Fix | Delete

'has-$slug-color' => 'color',

[89] Fix | Delete

),

[90] Fix | Delete

),

[91] Fix | Delete

'background' => array(

[92] Fix | Delete

'property_keys' => array(

[93] Fix | Delete

'default' => 'background-color',

[94] Fix | Delete

),

[95] Fix | Delete

'path' => array( 'color', 'background' ),

[96] Fix | Delete

'css_vars' => array(

[97] Fix | Delete

'color' => '--wp--preset--color--$slug',

[98] Fix | Delete

),

[99] Fix | Delete

'classnames' => array(

[100] Fix | Delete

'has-background' => true,

[101] Fix | Delete

'has-$slug-background-color' => 'color',

[102] Fix | Delete

),

[103] Fix | Delete

),

[104] Fix | Delete

'gradient' => array(

[105] Fix | Delete

'property_keys' => array(

[106] Fix | Delete

'default' => 'background',

[107] Fix | Delete

),

[108] Fix | Delete

'path' => array( 'color', 'gradient' ),

[109] Fix | Delete

'css_vars' => array(

[110] Fix | Delete

'gradient' => '--wp--preset--gradient--$slug',

[111] Fix | Delete

),

[112] Fix | Delete

'classnames' => array(

[113] Fix | Delete

'has-background' => true,

[114] Fix | Delete

'has-$slug-gradient-background' => 'gradient',

[115] Fix | Delete

),

[116] Fix | Delete

),

[117] Fix | Delete

),

[118] Fix | Delete

'border' => array(

[119] Fix | Delete

'color' => array(

[120] Fix | Delete

'property_keys' => array(

[121] Fix | Delete

'default' => 'border-color',

[122] Fix | Delete

'individual' => 'border-%s-color',

[123] Fix | Delete

),

[124] Fix | Delete

'path' => array( 'border', 'color' ),

[125] Fix | Delete

'classnames' => array(

[126] Fix | Delete

'has-border-color' => true,

[127] Fix | Delete

'has-$slug-border-color' => 'color',

[128] Fix | Delete

),

[129] Fix | Delete

),

[130] Fix | Delete

'radius' => array(

[131] Fix | Delete

'property_keys' => array(

[132] Fix | Delete

'default' => 'border-radius',

[133] Fix | Delete

'individual' => 'border-%s-radius',

[134] Fix | Delete

),

[135] Fix | Delete

'path' => array( 'border', 'radius' ),

[136] Fix | Delete

),

[137] Fix | Delete

'style' => array(

[138] Fix | Delete

'property_keys' => array(

[139] Fix | Delete

'default' => 'border-style',

[140] Fix | Delete

'individual' => 'border-%s-style',

[141] Fix | Delete

),

[142] Fix | Delete

'path' => array( 'border', 'style' ),

[143] Fix | Delete

),

[144] Fix | Delete

'width' => array(

[145] Fix | Delete

'property_keys' => array(

[146] Fix | Delete

'default' => 'border-width',

[147] Fix | Delete

'individual' => 'border-%s-width',

[148] Fix | Delete

),

[149] Fix | Delete

'path' => array( 'border', 'width' ),

[150] Fix | Delete

),

[151] Fix | Delete

'top' => array(

[152] Fix | Delete

'value_func' => array( self::class, 'get_individual_property_css_declarations' ),

[153] Fix | Delete

'path' => array( 'border', 'top' ),

[154] Fix | Delete

'css_vars' => array(

[155] Fix | Delete

'color' => '--wp--preset--color--$slug',

[156] Fix | Delete

),

[157] Fix | Delete

),

[158] Fix | Delete

'right' => array(

[159] Fix | Delete

'value_func' => array( self::class, 'get_individual_property_css_declarations' ),

[160] Fix | Delete

'path' => array( 'border', 'right' ),

[161] Fix | Delete

'css_vars' => array(

[162] Fix | Delete

'color' => '--wp--preset--color--$slug',

[163] Fix | Delete

),

[164] Fix | Delete

),

[165] Fix | Delete

'bottom' => array(

[166] Fix | Delete

'value_func' => array( self::class, 'get_individual_property_css_declarations' ),

[167] Fix | Delete

'path' => array( 'border', 'bottom' ),

[168] Fix | Delete

'css_vars' => array(

[169] Fix | Delete

'color' => '--wp--preset--color--$slug',

[170] Fix | Delete

),

[171] Fix | Delete

),

[172] Fix | Delete

'left' => array(

[173] Fix | Delete

'value_func' => array( self::class, 'get_individual_property_css_declarations' ),

[174] Fix | Delete

'path' => array( 'border', 'left' ),

[175] Fix | Delete

'css_vars' => array(

[176] Fix | Delete

'color' => '--wp--preset--color--$slug',

[177] Fix | Delete

),

[178] Fix | Delete

),

[179] Fix | Delete

),

[180] Fix | Delete

'shadow' => array(

[181] Fix | Delete

'shadow' => array(

[182] Fix | Delete

'property_keys' => array(

[183] Fix | Delete

'default' => 'box-shadow',

[184] Fix | Delete

),

[185] Fix | Delete

'path' => array( 'shadow' ),

[186] Fix | Delete

'css_vars' => array(

[187] Fix | Delete

'shadow' => '--wp--preset--shadow--$slug',

[188] Fix | Delete

),

[189] Fix | Delete

),

[190] Fix | Delete

),

[191] Fix | Delete

'dimensions' => array(

[192] Fix | Delete

'aspectRatio' => array(

[193] Fix | Delete

'property_keys' => array(

[194] Fix | Delete

'default' => 'aspect-ratio',

[195] Fix | Delete

),

[196] Fix | Delete

'path' => array( 'dimensions', 'aspectRatio' ),

[197] Fix | Delete

'classnames' => array(

[198] Fix | Delete

'has-aspect-ratio' => true,

[199] Fix | Delete

),

[200] Fix | Delete

),

[201] Fix | Delete

'minHeight' => array(

[202] Fix | Delete

'property_keys' => array(

[203] Fix | Delete

'default' => 'min-height',

[204] Fix | Delete

),

[205] Fix | Delete

'path' => array( 'dimensions', 'minHeight' ),

[206] Fix | Delete

'css_vars' => array(

[207] Fix | Delete

'spacing' => '--wp--preset--spacing--$slug',

[208] Fix | Delete

),

[209] Fix | Delete

),

[210] Fix | Delete

),

[211] Fix | Delete

'spacing' => array(

[212] Fix | Delete

'padding' => array(

[213] Fix | Delete

'property_keys' => array(

[214] Fix | Delete

'default' => 'padding',

[215] Fix | Delete

'individual' => 'padding-%s',

[216] Fix | Delete

),

[217] Fix | Delete

'path' => array( 'spacing', 'padding' ),

[218] Fix | Delete

'css_vars' => array(

[219] Fix | Delete

'spacing' => '--wp--preset--spacing--$slug',

[220] Fix | Delete

),

[221] Fix | Delete

),

[222] Fix | Delete

'margin' => array(

[223] Fix | Delete

'property_keys' => array(

[224] Fix | Delete

'default' => 'margin',

[225] Fix | Delete

'individual' => 'margin-%s',

[226] Fix | Delete

),

[227] Fix | Delete

'path' => array( 'spacing', 'margin' ),

[228] Fix | Delete

'css_vars' => array(

[229] Fix | Delete

'spacing' => '--wp--preset--spacing--$slug',

[230] Fix | Delete

),

[231] Fix | Delete

),

[232] Fix | Delete

),

[233] Fix | Delete

'typography' => array(

[234] Fix | Delete

'fontSize' => array(

[235] Fix | Delete

'property_keys' => array(

[236] Fix | Delete

'default' => 'font-size',

[237] Fix | Delete

),

[238] Fix | Delete

'path' => array( 'typography', 'fontSize' ),

[239] Fix | Delete

'css_vars' => array(

[240] Fix | Delete

'font-size' => '--wp--preset--font-size--$slug',

[241] Fix | Delete

),

[242] Fix | Delete

'classnames' => array(

[243] Fix | Delete

'has-$slug-font-size' => 'font-size',

[244] Fix | Delete

),

[245] Fix | Delete

),

[246] Fix | Delete

'fontFamily' => array(

[247] Fix | Delete

'property_keys' => array(

[248] Fix | Delete

'default' => 'font-family',

[249] Fix | Delete

),

[250] Fix | Delete

'css_vars' => array(

[251] Fix | Delete

'font-family' => '--wp--preset--font-family--$slug',

[252] Fix | Delete

),

[253] Fix | Delete

'path' => array( 'typography', 'fontFamily' ),

[254] Fix | Delete

'classnames' => array(

[255] Fix | Delete

'has-$slug-font-family' => 'font-family',

[256] Fix | Delete

),

[257] Fix | Delete

),

[258] Fix | Delete

'fontStyle' => array(

[259] Fix | Delete

'property_keys' => array(

[260] Fix | Delete

'default' => 'font-style',

[261] Fix | Delete

),

[262] Fix | Delete

'path' => array( 'typography', 'fontStyle' ),

[263] Fix | Delete

),

[264] Fix | Delete

'fontWeight' => array(

[265] Fix | Delete

'property_keys' => array(

[266] Fix | Delete

'default' => 'font-weight',

[267] Fix | Delete

),

[268] Fix | Delete

'path' => array( 'typography', 'fontWeight' ),

[269] Fix | Delete

),

[270] Fix | Delete

'lineHeight' => array(

[271] Fix | Delete

'property_keys' => array(

[272] Fix | Delete

'default' => 'line-height',

[273] Fix | Delete

),

[274] Fix | Delete

'path' => array( 'typography', 'lineHeight' ),

[275] Fix | Delete

),

[276] Fix | Delete

'textColumns' => array(

[277] Fix | Delete

'property_keys' => array(

[278] Fix | Delete

'default' => 'column-count',

[279] Fix | Delete

),

[280] Fix | Delete

'path' => array( 'typography', 'textColumns' ),

[281] Fix | Delete

),

[282] Fix | Delete

'textDecoration' => array(

[283] Fix | Delete

'property_keys' => array(

[284] Fix | Delete

'default' => 'text-decoration',

[285] Fix | Delete

),

[286] Fix | Delete

'path' => array( 'typography', 'textDecoration' ),

[287] Fix | Delete

),

[288] Fix | Delete

'textTransform' => array(

[289] Fix | Delete

'property_keys' => array(

[290] Fix | Delete

'default' => 'text-transform',

[291] Fix | Delete

),

[292] Fix | Delete

'path' => array( 'typography', 'textTransform' ),

[293] Fix | Delete

),

[294] Fix | Delete

'letterSpacing' => array(

[295] Fix | Delete

'property_keys' => array(

[296] Fix | Delete

'default' => 'letter-spacing',

[297] Fix | Delete

),

[298] Fix | Delete

'path' => array( 'typography', 'letterSpacing' ),

[299] Fix | Delete

),

[300] Fix | Delete

),

[301] Fix | Delete

);

[302] Fix | Delete

[303] Fix | Delete

/**

[304] Fix | Delete

* Util: Extracts the slug in kebab case from a preset string,

[305] Fix | Delete

* e.g. `heavenly-blue` from `var:preset|color|heavenlyBlue`.

[306] Fix | Delete

*

[307] Fix | Delete

* @since 6.1.0

[308] Fix | Delete

*

[309] Fix | Delete

* @param string $style_value A single CSS preset value.

[310] Fix | Delete

* @param string $property_key The CSS property that is the second element of the preset string.

[311] Fix | Delete

* Used for matching.

[312] Fix | Delete

* @return string The slug, or empty string if not found.

[313] Fix | Delete

*/

[314] Fix | Delete

protected static function get_slug_from_preset_value( $style_value, $property_key ) {

[315] Fix | Delete

if ( is_string( $style_value ) && is_string( $property_key )

[316] Fix | Delete

&& str_contains( $style_value, "var:preset|{$property_key}|" )

[317] Fix | Delete

) {

[318] Fix | Delete

$index_to_splice = strrpos( $style_value, '|' ) + 1;

[319] Fix | Delete

return _wp_to_kebab_case( substr( $style_value, $index_to_splice ) );

[320] Fix | Delete

}

[321] Fix | Delete

return '';

[322] Fix | Delete

}

[323] Fix | Delete

[324] Fix | Delete

/**

[325] Fix | Delete

* Util: Generates a CSS var string, e.g. `var(--wp--preset--color--background)`

[326] Fix | Delete

* from a preset string such as `var:preset|space|50`.

[327] Fix | Delete

*

[328] Fix | Delete

* @since 6.1.0

[329] Fix | Delete

*

[330] Fix | Delete

* @param string $style_value A single CSS preset value.

[331] Fix | Delete

* @param string[] $css_vars An associate array of CSS var patterns

[332] Fix | Delete

* used to generate the var string.

[333] Fix | Delete

* @return string The CSS var, or an empty string if no match for slug found.

[334] Fix | Delete

*/

[335] Fix | Delete

protected static function get_css_var_value( $style_value, $css_vars ) {

[336] Fix | Delete

foreach ( $css_vars as $property_key => $css_var_pattern ) {

[337] Fix | Delete

$slug = static::get_slug_from_preset_value( $style_value, $property_key );

[338] Fix | Delete

if ( static::is_valid_style_value( $slug ) ) {

[339] Fix | Delete

$var = strtr(

[340] Fix | Delete

$css_var_pattern,

[341] Fix | Delete

array( '$slug' => $slug )

[342] Fix | Delete

);

[343] Fix | Delete

return "var($var)";

[344] Fix | Delete

}

[345] Fix | Delete

}

[346] Fix | Delete

return '';

[347] Fix | Delete

}

[348] Fix | Delete

[349] Fix | Delete

/**

[350] Fix | Delete

* Util: Checks whether an incoming block style value is valid.

[351] Fix | Delete

*

[352] Fix | Delete

* @since 6.1.0

[353] Fix | Delete

*

[354] Fix | Delete

* @param string $style_value A single CSS preset value.

[355] Fix | Delete

* @return bool

[356] Fix | Delete

*/

[357] Fix | Delete

protected static function is_valid_style_value( $style_value ) {

[358] Fix | Delete

return '0' === $style_value || ! empty( $style_value );

[359] Fix | Delete

}

[360] Fix | Delete

[361] Fix | Delete

/**

[362] Fix | Delete

* Stores a CSS rule using the provided CSS selector and CSS declarations.

[363] Fix | Delete

*

[364] Fix | Delete

* @since 6.1.0

[365] Fix | Delete

* @since 6.6.0 Added the `$rules_group` parameter.

[366] Fix | Delete

*

[367] Fix | Delete

* @param string $store_name A valid store key.

[368] Fix | Delete

* @param string $css_selector When a selector is passed, the function will return

[369] Fix | Delete

* a full CSS rule `$selector { ...rules }`

[370] Fix | Delete

* otherwise a concatenated string of properties and values.

[371] Fix | Delete

* @param string[] $css_declarations An associative array of CSS definitions,

[372] Fix | Delete

* e.g. `array( "$property" => "$value", "$property" => "$value" )`.

[373] Fix | Delete

* @param string $rules_group Optional. A parent CSS selector in the case of nested CSS, or a CSS nested @rule,

[374] Fix | Delete

* such as `@media (min-width: 80rem)` or `@layer module`.

[375] Fix | Delete

*/

[376] Fix | Delete

public static function store_css_rule( $store_name, $css_selector, $css_declarations, $rules_group = '' ) {

[377] Fix | Delete

if ( empty( $store_name ) || empty( $css_selector ) || empty( $css_declarations ) ) {

[378] Fix | Delete

return;

[379] Fix | Delete

}

[380] Fix | Delete

static::get_store( $store_name )->add_rule( $css_selector, $rules_group )->add_declarations( $css_declarations );

[381] Fix | Delete

}

[382] Fix | Delete

[383] Fix | Delete

/**

[384] Fix | Delete

* Returns a store by store key.

[385] Fix | Delete

*

[386] Fix | Delete

* @since 6.1.0

[387] Fix | Delete

*

[388] Fix | Delete

* @param string $store_name A store key.

[389] Fix | Delete

* @return WP_Style_Engine_CSS_Rules_Store|null

[390] Fix | Delete

*/

[391] Fix | Delete

public static function get_store( $store_name ) {

[392] Fix | Delete

return WP_Style_Engine_CSS_Rules_Store::get_store( $store_name );

[393] Fix | Delete

}

[394] Fix | Delete

[395] Fix | Delete

/**

[396] Fix | Delete

* Returns classnames and CSS based on the values in a styles object.

[397] Fix | Delete

*

[398] Fix | Delete

* Return values are parsed based on the instructions in BLOCK_STYLE_DEFINITIONS_METADATA.

[399] Fix | Delete

*

[400] Fix | Delete

* @since 6.1.0

[401] Fix | Delete

*

[402] Fix | Delete

* @param array $block_styles The style object.

[403] Fix | Delete

* @param array $options {

[404] Fix | Delete

* Optional. An array of options. Default empty array.

[405] Fix | Delete

*

[406] Fix | Delete

* @type bool $convert_vars_to_classnames Whether to skip converting incoming CSS var patterns,

[407] Fix | Delete

* e.g. `var:preset|<PRESET_TYPE>|<PRESET_SLUG>`,

[408] Fix | Delete

* to `var( --wp--preset--* )` values. Default false.

[409] Fix | Delete

* @type string $selector Optional. When a selector is passed,

[410] Fix | Delete

* the value of `$css` in the return value will comprise

[411] Fix | Delete

* a full CSS rule `$selector { ...$css_declarations }`,

[412] Fix | Delete

* otherwise, the value will be a concatenated string

[413] Fix | Delete

* of CSS declarations.

[414] Fix | Delete

* }

[415] Fix | Delete

* @return array {

[416] Fix | Delete

* @type string[] $classnames Array of class names.

[417] Fix | Delete

* @type string[] $declarations An associative array of CSS definitions,

[418] Fix | Delete

* e.g. `array( "$property" => "$value", "$property" => "$value" )`.

[419] Fix | Delete

* }

[420] Fix | Delete

*/

[421] Fix | Delete

public static function parse_block_styles( $block_styles, $options ) {

[422] Fix | Delete

$parsed_styles = array(

[423] Fix | Delete

'classnames' => array(),

[424] Fix | Delete

'declarations' => array(),

[425] Fix | Delete

);

[426] Fix | Delete

if ( empty( $block_styles ) || ! is_array( $block_styles ) ) {

[427] Fix | Delete

return $parsed_styles;

[428] Fix | Delete

}

[429] Fix | Delete

[430] Fix | Delete

// Collect CSS and classnames.

[431] Fix | Delete

foreach ( static::BLOCK_STYLE_DEFINITIONS_METADATA as $definition_group_key => $definition_group_style ) {

[432] Fix | Delete

if ( empty( $block_styles[ $definition_group_key ] ) ) {

[433] Fix | Delete

continue;

[434] Fix | Delete

}

[435] Fix | Delete

foreach ( $definition_group_style as $style_definition ) {

[436] Fix | Delete

$style_value = _wp_array_get( $block_styles, $style_definition['path'], null );

[437] Fix | Delete

[438] Fix | Delete

if ( ! static::is_valid_style_value( $style_value ) ) {

[439] Fix | Delete

continue;

[440] Fix | Delete

}

[441] Fix | Delete

[442] Fix | Delete

$parsed_styles['classnames'] = array_merge( $parsed_styles['classnames'], static::get_classnames( $style_value, $style_definition ) );

[443] Fix | Delete

$parsed_styles['declarations'] = array_merge( $parsed_styles['declarations'], static::get_css_declarations( $style_value, $style_definition, $options ) );

[444] Fix | Delete

}

[445] Fix | Delete

}

[446] Fix | Delete

[447] Fix | Delete

return $parsed_styles;

[448] Fix | Delete

}

[449] Fix | Delete

[450] Fix | Delete

/**

[451] Fix | Delete

* Returns classnames, and generates classname(s) from a CSS preset property pattern,

[452] Fix | Delete

* e.g. `var:preset|<PRESET_TYPE>|<PRESET_SLUG>`.

[453] Fix | Delete

*

[454] Fix | Delete

* @since 6.1.0

[455] Fix | Delete

*

[456] Fix | Delete

* @param string $style_value A single raw style value or CSS preset property

[457] Fix | Delete

* from the `$block_styles` array.

[458] Fix | Delete

* @param array $style_definition A single style definition from BLOCK_STYLE_DEFINITIONS_METADATA.

[459] Fix | Delete

* @return string[] An array of CSS classnames, or empty array if there are none.

[460] Fix | Delete

*/

[461] Fix | Delete

protected static function get_classnames( $style_value, $style_definition ) {

[462] Fix | Delete

if ( empty( $style_value ) ) {

[463] Fix | Delete

return array();

[464] Fix | Delete

}

[465] Fix | Delete

[466] Fix | Delete

$classnames = array();

[467] Fix | Delete

if ( ! empty( $style_definition['classnames'] ) ) {

[468] Fix | Delete

foreach ( $style_definition['classnames'] as $classname => $property_key ) {

[469] Fix | Delete

if ( true === $property_key ) {

[470] Fix | Delete

$classnames[] = $classname;

[471] Fix | Delete

continue;

[472] Fix | Delete

}

[473] Fix | Delete

[474] Fix | Delete

$slug = static::get_slug_from_preset_value( $style_value, $property_key );

[475] Fix | Delete

[476] Fix | Delete

if ( $slug ) {

[477] Fix | Delete

/*

[478] Fix | Delete

* Right now we expect a classname pattern to be stored in BLOCK_STYLE_DEFINITIONS_METADATA.

[479] Fix | Delete

* One day, if there are no stored schemata, we could allow custom patterns or

[480] Fix | Delete

* generate classnames based on other properties

[481] Fix | Delete

* such as a path or a value or a prefix passed in options.

[482] Fix | Delete

*/

[483] Fix | Delete

$classnames[] = strtr( $classname, array( '$slug' => $slug ) );

[484] Fix | Delete

}

[485] Fix | Delete

}

[486] Fix | Delete

}

[487] Fix | Delete

[488] Fix | Delete

return $classnames;

[489] Fix | Delete

}

[490] Fix | Delete

[491] Fix | Delete

/**

[492] Fix | Delete

* Returns an array of CSS declarations based on valid block style values.

[493] Fix | Delete

*

[494] Fix | Delete

* @since 6.1.0

[495] Fix | Delete

*

[496] Fix | Delete

* @param mixed $style_value A single raw style value from $block_styles array.

[497] Fix | Delete

* @param array $style_definition A single style definition from BLOCK_STYLE_DEFINITIONS_METADATA.

[498] Fix | Delete

* @param array $options {

[499] Fix | Delete