Upstream
/
WordPress
mirror of https://github.com/WordPress/WordPress.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity

Editor: update docs for `css_var`. 

Updates inline doc for the `css_var` key value pair in WP_Style_Engine.

Props ramonopoly.
Fixes #59401.

Built from https://develop.svn.wordpress.org/trunk@56630


git-svn-id: http://core.svn.wordpress.org/trunk@56142 1a063a9b-81f0-0310-95a4-ce76da25c4cd
This commit is contained in:
isabel_brison 2023-09-20 07:06:20 +00:00
parent 9699ef2e41
commit d761ed56ca
2 changed files with 14 additions and 19 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

31
wp-includes/style-engine/class-wp-style-engine.php
View File

@ -27,26 +27,21 @@
#[AllowDynamicProperties]
final class WP_Style_Engine {
/**
* Style definitions that contain the instructions to
* parse/output valid Gutenberg styles from a block's attributes.
* Style definitions that contain the instructions to parse/output valid Gutenberg styles from a block's attributes.
*
* For every style definition, the following properties are valid:
* For every style definition, the follow properties are valid:
*
* - classnames => (array) An array of classnames to be returned for block styles.
* The key is a classname or pattern.
* A value of `true` means the classname should be applied always.
* Otherwise, a valid CSS property (string) to match the incoming value,
* e.g. "color" to match var:preset|color|somePresetSlug.
* - css_vars => (array) An array of key value pairs used to generate CSS var values.
* The key is a CSS var pattern, whose `$slug` fragment will be replaced with a preset slug.
* The value should be a valid CSS property (string) to match the incoming value,
* e.g. "color" to match var:preset|color|somePresetSlug.
* - property_keys => (array) An array of keys whose values represent a valid CSS property,
* e.g. "margin" or "border".
* - path => (array) A path that accesses the corresponding style value in the block style object.
* - 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", ... )`.
* - classnames => (array) an array of classnames to be returned for block styles. The key is a classname or pattern.
* A value of `true` means the classname should be applied always. Otherwise, a valid CSS property (string)
* to match the incoming value, e.g., "color" to match var:preset|color|somePresetSlug.
* - css_vars => (array) an array of key value pairs used to generate CSS var values.
* The key should be the CSS property name that matches the second element of the preset string value,
* i.e., "color" in var:preset|color|somePresetSlug. The value is a CSS var pattern (e.g. `--wp--preset--color--$slug`),
* whose `$slug` fragment will be replaced with the preset slug, which is the third element of the preset string value,
* i.e., `somePresetSlug` in var:preset|color|somePresetSlug.
* - property_keys => (array) array of keys whose values represent a valid CSS property, e.g., "margin" or "border".
* - path => (array) a path that accesses the corresponding style value in the block style object.
* - 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", ... )`.
*
* @since 6.1.0
* @var array

2
wp-includes/version.php
View File

@ -16,7 +16,7 @@
*
* @global string $wp_version
*/
$wp_version = '6.4-alpha-56629';
$wp_version = '6.4-alpha-56630';
/**
* Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema.