Docs: Correct DocBlock formatting in wp-includes/class-wp-theme-json.php.

Follow-up to [52049], [54118], [54162], [55008], [55349], [55959], [55986], [56058], [57496], [58354], [58413].

Props mukesh27, ramonopoly.
See #62279.
Built from https://develop.svn.wordpress.org/trunk@59328


git-svn-id: http://core.svn.wordpress.org/trunk@58714 1a063a9b-81f0-0310-95a4-ce76da25c4cd
This commit is contained in:
Sergey Biryukov 2024-10-30 23:52:17 +00:00
parent f17b845a78
commit 2a96d5f4e3
2 changed files with 21 additions and 25 deletions

View File

@ -227,7 +227,6 @@ class WP_Theme_JSON {
* @since 6.5.0 Added `aspect-ratio` property. * @since 6.5.0 Added `aspect-ratio` property.
* @since 6.6.0 Added `background-[image|position|repeat|size]` properties. * @since 6.6.0 Added `background-[image|position|repeat|size]` properties.
* @since 6.7.0 Added `background-attachment` property. * @since 6.7.0 Added `background-attachment` property.
*
* @var array * @var array
*/ */
const PROPERTIES_METADATA = array( const PROPERTIES_METADATA = array(
@ -307,7 +306,6 @@ class WP_Theme_JSON {
* *
* @since 6.2.0 * @since 6.2.0
* @since 6.6.0 Added background-image properties. * @since 6.6.0 Added background-image properties.
*
* @var array * @var array
*/ */
const INDIRECT_PROPERTIES_METADATA = array( const INDIRECT_PROPERTIES_METADATA = array(
@ -339,6 +337,7 @@ class WP_Theme_JSON {
* setting key. * setting key.
* *
* @since 5.9.0 * @since 5.9.0
* @var array
*/ */
const PROTECTED_PROPERTIES = array( const PROTECTED_PROPERTIES = array(
'spacing.blockGap' => array( 'spacing', 'blockGap' ), 'spacing.blockGap' => array( 'spacing', 'blockGap' ),
@ -475,7 +474,6 @@ class WP_Theme_JSON {
* The valid properties for fontFamilies under settings key. * The valid properties for fontFamilies under settings key.
* *
* @since 6.5.0 * @since 6.5.0
*
* @var array * @var array
*/ */
const FONT_FAMILY_SCHEMA = array( const FONT_FAMILY_SCHEMA = array(
@ -517,7 +515,6 @@ class WP_Theme_JSON {
* @since 6.3.0 Added support for `typography.textColumns`. * @since 6.3.0 Added support for `typography.textColumns`.
* @since 6.5.0 Added support for `dimensions.aspectRatio`. * @since 6.5.0 Added support for `dimensions.aspectRatio`.
* @since 6.6.0 Added `background` sub properties to top-level only. * @since 6.6.0 Added `background` sub properties to top-level only.
*
* @var array * @var array
*/ */
const VALID_STYLES = array( const VALID_STYLES = array(
@ -591,6 +588,7 @@ class WP_Theme_JSON {
* *
* @since 6.1.0 * @since 6.1.0
* @since 6.2.0 Added support for ':link' and ':any-link'. * @since 6.2.0 Added support for ':link' and ':any-link'.
* @var array
*/ */
const VALID_ELEMENT_PSEUDO_SELECTORS = array( const VALID_ELEMENT_PSEUDO_SELECTORS = array(
'link' => array( ':link', ':any-link', ':visited', ':hover', ':focus', ':active' ), 'link' => array( ':link', ':any-link', ':visited', ':hover', ':focus', ':active' ),
@ -938,7 +936,6 @@ class WP_Theme_JSON {
* @return array The sanitized output. * @return array The sanitized output.
*/ */
protected static function sanitize( $input, $valid_block_names, $valid_element_names, $valid_variations ) { protected static function sanitize( $input, $valid_block_names, $valid_element_names, $valid_variations ) {
$output = array(); $output = array();
if ( ! is_array( $input ) ) { if ( ! is_array( $input ) ) {
@ -2815,7 +2812,6 @@ class WP_Theme_JSON {
* Fixed custom CSS output in block style variations. * Fixed custom CSS output in block style variations.
* *
* @param array $block_metadata Metadata about the block to get styles for. * @param array $block_metadata Metadata about the block to get styles for.
*
* @return string Styles for the block. * @return string Styles for the block.
*/ */
public function get_styles_for_block( $block_metadata ) { public function get_styles_for_block( $block_metadata ) {
@ -4202,6 +4198,7 @@ class WP_Theme_JSON {
* For example, `var:preset|color|vivid-green-cyan` becomes `var(--wp--preset--color--vivid-green-cyan)`. * For example, `var:preset|color|vivid-green-cyan` becomes `var(--wp--preset--color--vivid-green-cyan)`.
* *
* @since 6.3.0 * @since 6.3.0
*
* @param string $value The variable such as var:preset|color|vivid-green-cyan to convert. * @param string $value The variable such as var:preset|color|vivid-green-cyan to convert.
* @return string The converted variable. * @return string The converted variable.
*/ */
@ -4227,6 +4224,7 @@ class WP_Theme_JSON {
* It is recursive and modifies the input in-place. * It is recursive and modifies the input in-place.
* *
* @since 6.3.0 * @since 6.3.0
*
* @param array $tree Input to process. * @param array $tree Input to process.
* @return array The modified $tree. * @return array The modified $tree.
*/ */
@ -4251,7 +4249,6 @@ class WP_Theme_JSON {
* *
* @param object $block_type The block type. * @param object $block_type The block type.
* @param string $root_selector The block's root selector. * @param string $root_selector The block's root selector.
*
* @return array The custom selectors set by the block. * @return array The custom selectors set by the block.
*/ */
protected static function get_block_selectors( $block_type, $root_selector ) { protected static function get_block_selectors( $block_type, $root_selector ) {
@ -4310,7 +4307,6 @@ class WP_Theme_JSON {
* *
* @param object $metadata The related block metadata containing selectors. * @param object $metadata The related block metadata containing selectors.
* @param object $node A merged theme.json node for block or variation. * @param object $node A merged theme.json node for block or variation.
*
* @return array The style declarations for the node's features with custom * @return array The style declarations for the node's features with custom
* selectors. * selectors.
*/ */
@ -4470,8 +4466,8 @@ class WP_Theme_JSON {
* Resolves the values of CSS variables in the given styles. * Resolves the values of CSS variables in the given styles.
* *
* @since 6.3.0 * @since 6.3.0
* @param WP_Theme_JSON $theme_json The theme json resolver.
* *
* @param WP_Theme_JSON $theme_json The theme json resolver.
* @return WP_Theme_JSON The $theme_json with resolved variables. * @return WP_Theme_JSON The $theme_json with resolved variables.
*/ */
public static function resolve_variables( $theme_json ) { public static function resolve_variables( $theme_json ) {

View File

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