Changeset 31030 for trunk/src/wp-includes/functions.wp-scripts.php

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.

File:

• trunk/src/wp-includes/functions.wp-scripts.php (modified) (1 diff)

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.
  */