Changeset 58834 for trunk/src/wp-includes/class-wp-theme-json.php

Timestamp:

07/31/2024 02:39:46 AM (2 years ago)

Author:

ramonopoly

Message:

Background: add background attachment support to theme.json styles

Introduces the ability to specify a value for background.backgroundAttachment in theme.json styles.

The theme.json value determines the CSS value for the background-attachment property.

This feature was introduced into the Gutenberg plugin in version 18.9.

Props andrewserong, mukesh27, noisysocks, ramonopoly.

Fixes #61720

File:

• trunk/src/wp-includes/class-wp-theme-json.php (modified) (3 diffs)

trunk/src/wp-includes/class-wp-theme-json.php

@@ -227 +227 @@
          * @since 6.5.0 Added `aspect-ratio` property.
          * @since 6.6.0 Added `background-[image|position|repeat|size]` properties.
+         * @since 6.7.0 Added `background-attachment` property.
          *
          * @var array
@@ -238 +239 @@
                 'background-repeat'                 => array( 'background', 'backgroundRepeat' ),
                 'background-size'                   => array( 'background', 'backgroundSize' ),
+                'background-attachment'             => array( 'background', 'backgroundAttachment' ),
                 'border-radius'                     => array( 'border', 'radius' ),
                 'border-top-left-radius'            => array( 'border', 'radius', 'topLeft' ),
@@ -521 +523 @@
         const VALID_STYLES = array(
                 'background' => array(
-                        'backgroundImage'    => null,
-                        'backgroundPosition' => null,
-                        'backgroundRepeat'   => null,
-                        'backgroundSize'     => null,
+                        'backgroundImage'      => null,
+                        'backgroundPosition'   => null,
+                        'backgroundRepeat'     => null,
+                        'backgroundSize'       => null,
+                        'backgroundAttachment' => null,
                 ),
                 'border'     => array(