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

Timestamp:

07/04/2024 11:14:44 PM (10 months ago)

Author:

dmsnell

Message:

HTML API: Add current_node_is() helper method to stack of open elements.

As part of work to add more spec support to the HTML API, this new method
will make it easier to implement the logic when in the SELECT and TABLE
insertion modes.

Developed in ​https://github.com/WordPress/wordpress-develop/pull/6968
Discussed in https://core.trac.wordpress.org/ticket/51576

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

@@ -146 +146 @@
 
     /**
+     * Indicates if the current node is of a given type or name.
+     *
+     * It's possible to pass either a node type or a node name to this function.
+     * In the case there is no current element it will always return `false`.
+     *
+     * Example:
+     *
+     *     // Is the current node a text node?
+     *     $stack->current_node_is( '#text' );
+     *
+     *     // Is the current node a DIV element?
+     *     $stack->current_node_is( 'DIV' );
+     *
+     *     // Is the current node any element/tag?
+     *     $stack->current_node_is( '#tag' );
+     *
+     * @see WP_HTML_Tag_Processor::get_token_type
+     * @see WP_HTML_Tag_Processor::get_token_name
+     *
+     * @since 6.7.0
+     *
+     * @access private
+     *
+     * @param string $identity Check if the current node has this name or type (depending on what is provided).
+     * @return bool Whether there is a current element that matches the given identity, whether a token name or type.
+     */
+    public function current_node_is( string $identity ): bool {
+        $current_node = end( $this->stack );
+        if ( false === $current_node ) {
+            return false;
+        }
+
+        $current_node_name = $current_node->node_name;
+
+        return (
+            $current_node_name === $identity ||
+            ( '#doctype' === $identity && 'html' === $current_node_name ) ||
+            ( '#tag' === $identity && ctype_upper( $current_node_name ) )
+        );
+    }
+
+    /**
      * Returns whether an element is in a specific scope.
      *