Changeset 55986 for trunk/src/wp-includes/global-styles-and-settings.php

Timestamp:

06/22/2023 08:42:42 AM (3 years ago)

Author:

oandregal

Message:

wp_get_global_styles: allow transforming the CSS Custom Properties into the values they represent.

Props samnajian, ramonopoly, isabel_brison.
Fixes #58588.

File:

• trunk/src/wp-includes/global-styles-and-settings.php (modified) (3 diffs)

trunk/src/wp-includes/global-styles-and-settings.php

@@ -93 +93 @@
  *
  * @since 5.9.0
- * @since 6.3.0 the internal format "var:preset|color|secondary" is always resolved
- *              to the standard form "var(--wp--preset--font-size--small)".
+ * @since 6.3.0 the internal link format "var:preset|color|secondary" is resolved
+ *              to "var(--wp--preset--font-size--small)" so consumers don't have to.
+ * @since 6.3.0 `transforms` is now usable in the `context` parameter. In case [`transforms`]['resolve_variables']
+ *              is defined, variables are resolved to their value in the styles.
  *
  * @param array $path    Path to the specific style to retrieve. Optional.
@@ -106 +108 @@
  *                              Valid values are 'all' (core, theme, and user) or 'base' (core and theme).
  *                              If empty or unknown, 'all' is used.
+ *     @type array $transforms Which transformation(s) to apply.
+ *                              Valid value is array( 'resolve-variables' ).
+ *                              If defined, variables are resolved to their value in the styles.
  * }
  * @return mixed The styles array or individual style value to retrieve.
@@ -118 +123 @@
         $origin = 'theme';
     }
-    $styles = WP_Theme_JSON_Resolver::get_merged_data( $origin )->get_raw_data()['styles'];
-
+
+    $resolve_variables = isset( $context['transforms'] )
+    && is_array( $context['transforms'] )
+    && in_array( 'resolve-variables', $context['transforms'], true );
+
+    $merged_data = WP_Theme_JSON_Resolver::get_merged_data( $origin );
+    if ( $resolve_variables ) {
+        $merged_data = WP_Theme_JSON::resolve_variables( $merged_data );
+    }
+    $styles = $merged_data->get_raw_data()['styles'];
     return _wp_array_get( $styles, $path, $styles );
 }
+
 
 /**