Changeset 39227 for trunk/src/wp-includes/class-wp-customize-manager.php

Timestamp:

11/14/2016 06:40:08 PM (4 years ago)

Author:

westonruter

Message:

Customize: Use selective refresh for custom header changes when possible.

• Use postMessage transport for header image settings by default when video headers are supported, and thus the_custom_header_markup() will necessarily be used (and thus a selective refresh partial will be available).
• Ensure that the_custom_header_markup() always outputs a container element in the customizer preview even if the header is empty.
• Ensure that edit shortcut appearing for custom header does not get positioned off-screen.

Props bradyvercher, westonruter.
See #38639.
Fixes #38737.

File:

• trunk/src/wp-includes/class-wp-customize-manager.php (modified) (1 diff)

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

@@ -3463 +3463 @@
         ) ) );
 
+        /*
+         * Switch image settings to postMessage when video support is enabled since
+         * it entails that the_custom_header_markup() will be used, and thus selective
+         * refresh can be utilized.
+         */
+        if ( current_theme_supports( 'custom-header', 'video' ) ) {
+            $this->get_setting( 'header_image' )->transport = 'postMessage';
+            $this->get_setting( 'header_image_data' )->transport = 'postMessage';
+        }
+
         $this->add_control( new WP_Customize_Media_Control( $this, 'header_video', array(
             'theme_supports' => array( 'custom-header', 'video' ),