Changeset 34563 for trunk/src/wp-includes/class-wp-customize-widgets.php

Timestamp:

09/25/2015 09:01:46 PM (8 years ago)

Author:

westonruter

Message:

Customizer: Defer embedding widget controls to improve DOM performance and initial load time.

The Menu Customizer feature includes a performance technique whereby the controls for nav menu items are only embedded into the DOM once the containing menu section is expanded. This commit implements the same DOM deferral for widgets but goes a step further than just embedding the controls once the widget area's Customizer section is expanded: it also defers the embedding of the widget control's form until the widget is expanded, at which point the widget-added event also fires to allow any additional widget initialization to be done. The deferred DOM embedding can speed up initial load time by 10x or more. This DOM deferral also yields a reduction in overall memory usage in the browser process.

Includes changes to wp_widget_control() to facilitate separating out the widget form from the surrounding accordion container; also includes unit tests for this previously-untested function. Also included are initial QUnit tests (finally) for widgets in the Customizer.

Fixes #33901.

File:

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

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

@@ -899 +899 @@
      */
     public function get_widget_control( $args ) {
+        $args[0]['before_form'] = '<div class="form">';
+        $args[0]['after_form'] = '</div><!-- .form -->';
+        $args[0]['before_widget_content'] = '<div class="widget-content">';
+        $args[0]['after_widget_content'] = '</div><!-- .widget-content -->';
         ob_start();
-
         call_user_func_array( 'wp_widget_control', $args );
-        $replacements = array(
-            '<form method="post">' => '<div class="form">',
-            '</form>' => '</div><!-- .form -->',
-        );
-
         $control_tpl = ob_get_clean();
-
-        $control_tpl = str_replace( array_keys( $replacements ), array_values( $replacements ), $control_tpl );
-
         return $control_tpl;
+    }
+
+    /**
+     * Get the widget control markup parts.
+     *
+     * @since 4.4.0
+     * @access public
+     *
+     * @param array $args Widget control arguments.
+     * @return array {
+     *     @type string $control  Markup for widget control wrapping form.
+     *     @type string $content  The contents of the widget form itself.
+     * }
+     */
+    public function get_widget_control_parts( $args ) {
+        $args[0]['before_widget_content'] = '<div class="widget-content">';
+        $args[0]['after_widget_content'] = '</div><!-- .widget-content -->';
+        $control_markup = $this->get_widget_control( $args );
+
+        $content_start_pos = strpos( $control_markup, $args[0]['before_widget_content'] );
+        $content_end_pos = strrpos( $control_markup, $args[0]['after_widget_content'] );
+
+        $control = substr( $control_markup, 0, $content_start_pos + strlen( $args[0]['before_widget_content'] ) );
+        $control .= substr( $control_markup, $content_end_pos );
+        $content = trim( substr(
+            $control_markup,
+            $content_start_pos + strlen( $args[0]['before_widget_content'] ),
+            $content_end_pos - $content_start_pos - strlen( $args[0]['before_widget_content'] )
+        ) );
+
+        return compact( 'control', 'content' );
     }