Changeset 58925 for trunk/src/wp-includes/html-api/class-wp-html-processor.php

Timestamp:

08/23/2024 02:53:59 PM (18 months ago)

Author:

dmsnell

Message:

HTML API: Parse DOCTYPE tokens and set HTML parser mode accordingly.

This patch adds until-now missing code to parse the structure of HTML DOCTYPE declarations. The DOCTYPE is mostly unused but can dictate the document compatability mode, which governs whether CSS class names match in a ASCII-case-insensitive way or not, and whether TABLE elements close an open P element.

The DOCTYPE information is made available through a new method on the Tag Processor, get_doctype_info().

Developed in ​https://github.com/wordpress/wordpress-develop/pull/7195
Discussed in https://core.trac.wordpress.org/ticket/61576

Props dmsnell, jonsurrell.
See #61576.

File:

• trunk/src/wp-includes/html-api/class-wp-html-processor.php (modified) (3 diffs)

trunk/src/wp-includes/html-api/class-wp-html-processor.php

@@ -1077 +1077 @@
              */
             case 'html':
-                $contents = $this->get_modifiable_text();
-                if ( ' html' !== $contents ) {
-                    /*
-                     * @todo When the HTML Tag Processor fully parses the DOCTYPE declaration,
-                     *       this code should examine the contents to set the compatability mode.
-                     */
-                    $this->bail( 'Cannot process any DOCTYPE other than a normative HTML5 doctype.' );
+                $doctype = $this->get_doctype_info();
+                if ( null !== $doctype && 'quirks' === $doctype->indicated_compatability_mode ) {
+                    $this->state->document_mode = WP_HTML_Processor_State::QUIRKS_MODE;
                 }
 
@@ -1090 +1086 @@
                  */
                 $this->state->insertion_mode = WP_HTML_Processor_State::INSERTION_MODE_BEFORE_HTML;
+                $this->insert_html_element( $this->state->current_token );
                 return true;
         }
@@ -1097 +1094 @@
          */
         initial_anything_else:
+        $this->state->document_mode  = WP_HTML_Processor_State::QUIRKS_MODE;
         $this->state->insertion_mode = WP_HTML_Processor_State::INSERTION_MODE_BEFORE_HTML;
         return $this->step( self::REPROCESS_CURRENT_NODE );