Changeset 58806 for trunk/src/wp-includes/html-api/class-wp-html-open-elements.php

Timestamp:

07/24/2024 06:39:46 PM (11 months ago)

Author:

dmsnell

Message:

HTML API: Add TABLE support in HTML Processor.

As part of work to add more spec support to the HTML API, this patch adds
support for various table-related insertion modes. This includes support
for tables, table rows, table cells, table column groups, etc...

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

Props: dmsnell, jonsurrell.
See #61576.

File:

• trunk/src/wp-includes/html-api/class-wp-html-open-elements.php (modified) (1 diff)

trunk/src/wp-includes/html-api/class-wp-html-open-elements.php

@@ -722 +722 @@
 
     /**
+     * Clear the stack back to a table context.
+     *
+     * > When the steps above require the UA to clear the stack back to a table context, it means
+     * > that the UA must, while the current node is not a table, template, or html element, pop
+     * > elements from the stack of open elements.
+     *
+     * @see https://html.spec.whatwg.org/multipage/parsing.html#clear-the-stack-back-to-a-table-context
+     *
+     * @since 6.7.0
+     */
+    public function clear_to_table_context(): void {
+        foreach ( $this->walk_up() as $item ) {
+            if (
+                'TABLE' === $item->node_name ||
+                'TEMPLATE' === $item->node_name ||
+                'HTML' === $item->node_name
+            ) {
+                break;
+            }
+            $this->pop();
+        }
+    }
+
+    /**
+     * Clear the stack back to a table body context.
+     *
+     * > When the steps above require the UA to clear the stack back to a table body context, it
+     * > means that the UA must, while the current node is not a tbody, tfoot, thead, template, or
+     * > html element, pop elements from the stack of open elements.
+     *
+     * @see https://html.spec.whatwg.org/multipage/parsing.html#clear-the-stack-back-to-a-table-body-context
+     *
+     * @since 6.7.0
+     */
+    public function clear_to_table_body_context(): void {
+        foreach ( $this->walk_up() as $item ) {
+            if (
+                'TBODY' === $item->node_name ||
+                'TFOOT' === $item->node_name ||
+                'THEAD' === $item->node_name ||
+                'TEMPLATE' === $item->node_name ||
+                'HTML' === $item->node_name
+            ) {
+                break;
+            }
+            $this->pop();
+        }
+    }
+
+    /**
+     * Clear the stack back to a table row context.
+     *
+     * > When the steps above require the UA to clear the stack back to a table row context, it
+     * > means that the UA must, while the current node is not a tr, template, or html element, pop
+     * > elements from the stack of open elements.
+     *
+     * @see https://html.spec.whatwg.org/multipage/parsing.html#clear-the-stack-back-to-a-table-row-context
+     *
+     * @since 6.7.0
+     */
+    public function clear_to_table_row_context(): void {
+        foreach ( $this->walk_up() as $item ) {
+            if (
+                'TR' === $item->node_name ||
+                'TEMPLATE' === $item->node_name ||
+                'HTML' === $item->node_name
+            ) {
+                break;
+            }
+            $this->pop();
+        }
+    }
+
+    /**
      * Wakeup magic method.
      *