Changeset 31030

Timestamp:

01/03/2015 03:53:30 AM (10 years ago)

Author:

wonderboymusic

Message:

Allow the 3rd argument to wp_localize_script()/WP_Scripts->localize() to be a callable, allowing data to be lazy-loaded when the script is actually enqueued.

Props jtsternberg.
Fixes #26111.

Location:

trunk/src/wp-includes

Files:

• class.wp-scripts.php (modified) (2 diffs)
• functions.wp-scripts.php (modified) (1 diff)

trunk/src/wp-includes/class.wp-scripts.php

@@ -143 +143 @@
         $tag = "<script type='text/javascript' src='$src'></script>\n";
 
-        /** 
+        /**
          * Filter the HTML script tag of an enqueued script.
          *
@@ -172 +172 @@
             $handle = 'jquery-core';
 
+        if ( is_callable( $l10n ) ) {
+            $l10n = call_user_func( $l10n );
+        }
+
         if ( is_array($l10n) && isset($l10n['l10n_print_after']) ) { // back compat, preserve the code in 'l10n_print_after' if present
             $after = $l10n['l10n_print_after'];

trunk/src/wp-includes/functions.wp-scripts.php

@@ -107 +107 @@
  * @todo Documentation cleanup
  *
- * @param string $handle      Script handle the data will be attached to.
- * @param string $object_name Name for the JavaScript object. Passed directly, so it should be qualified JS variable.
- *                            Example: '/[a-zA-Z0-9_]+/'.
- * @param array $l10n         The data itself. The data can be either a single or multi-dimensional array.
+ * @param string         $handle       Script handle the data will be attached to.
+ * @param string         $object_name  Name for the JavaScript object. Passed directly, so it should be qualified JS variable.
+ *                                     Example: '/[a-zA-Z0-9_]+/'.
+ * @param array|callable $l10n         The data itself. The data can be either a single or multi-dimensional array. If a callable
+ *                                     is passed, it will be invoked at runtime.
  * @return bool True if the script was successfully localized, false otherwise.
  */