Changeset 47385 for trunk/src/wp-includes/class-wp-customize-setting.php

Timestamp:

02/27/2020 08:21:35 PM (7 years ago)

Author:

SergeyBiryukov

Message:

Docs: Clarify the type of theme_supports argument in various Customizer classes.

Props marekdedic.
See #48347.

File:

• trunk/src/wp-includes/class-wp-customize-setting.php (modified) (2 diffs)

trunk/src/wp-includes/class-wp-customize-setting.php

@@ -52 +52 @@
 
         /**
-         * Feature a theme is required to support to enable this setting.
-         *
-         * @since 3.4.0
-         * @var string
+         * Theme features required to support the setting.
+         *
+         * @since 3.4.0
+         * @var string|string[]
          */
         public $theme_supports = '';
@@ -158 +158 @@
          *                                      Can be a theme mod or option name.
          * @param array                $args    {
-         *  Optional. Array of properties for the new Setting object. Default empty array.
-         *
-         *  @type string       $type                  Type of the setting. Default 'theme_mod'.
-         *  @type string       $capability            Capability required for the setting. Default 'edit_theme_options'
-         *  @type string|array $theme_supports        Theme features required to support the panel. Default is none.
-         *  @type string       $default               Default value for the setting. Default is empty string.
-         *  @type string       $transport             Options for rendering the live preview of changes in Customizer.
-         *                                            Using 'refresh' makes the change visible by reloading the whole preview.
-         *                                            Using 'postMessage' allows a custom JavaScript to handle live changes.
-         *                                            Default is 'refresh'.
-         *  @type callable     $validate_callback     Server-side validation callback for the setting's value.
-         *  @type callable     $sanitize_callback     Callback to filter a Customize setting value in un-slashed form.
-         *  @type callable     $sanitize_js_callback  Callback to convert a Customize PHP setting value to a value that is
-         *                                            JSON serializable.
-         *  @type bool         $dirty                 Whether or not the setting is initially dirty when created.
+         *     Optional. Array of properties for the new Setting object. Default empty array.
+         *
+         *     @type string          $type                 Type of the setting. Default 'theme_mod'.
+         *     @type string          $capability           Capability required for the setting. Default 'edit_theme_options'
+         *     @type string|string[] $theme_supports       Theme features required to support the panel. Default is none.
+         *     @type string          $default              Default value for the setting. Default is empty string.
+         *     @type string          $transport            Options for rendering the live preview of changes in Customizer.
+         *                                                 Using 'refresh' makes the change visible by reloading the whole preview.
+         *                                                 Using 'postMessage' allows a custom JavaScript to handle live changes.
+         *                                                 Default is 'refresh'.
+         *     @type callable        $validate_callback    Server-side validation callback for the setting's value.
+         *     @type callable        $sanitize_callback    Callback to filter a Customize setting value in un-slashed form.
+         *     @type callable        $sanitize_js_callback Callback to convert a Customize PHP setting value to a value that is
+         *                                                 JSON serializable.
+         *     @type bool            $dirty                Whether or not the setting is initially dirty when created.
          * }
          */