WP_HTML_Open_Elements::pop_until( string $html_tag_name ): bool

Pops nodes off of the stack of open elements until an HTML tag with the given name has been popped.

Description

Parameters

$html_tag_namestringrequired: Name of tag that needs to be popped off of the stack of open elements.

Return

bool Whether a tag of the given name was found and popped off of the stack of open elements.

Source

public function pop_until( string $html_tag_name ): bool {
	foreach ( $this->walk_up() as $item ) {
		$this->pop();

		if ( 'html' !== $item->namespace ) {
			continue;
		}

		if (
			'(internal: H1 through H6 - do not use)' === $html_tag_name &&
			in_array( $item->node_name, array( 'H1', 'H2', 'H3', 'H4', 'H5', 'H6' ), true )
		) {
			return true;
		}

		if ( $html_tag_name === $item->node_name ) {
			return true;
		}
	}

	return false;
}

View all references View on Trac View on GitHub

Uses	Description
WP_HTML_Open_Elements::walk_up()`wp-includes/html-api/class-wp-html-open-elements.php`	Steps through the stack of open elements, starting with the bottom element (added last) and walking upwards to the one added first.
WP_HTML_Open_Elements::pop()`wp-includes/html-api/class-wp-html-open-elements.php`	Pops a node off of the stack of open elements.

Changelog

Version	Description
6.4.0	Introduced.

User Contributed Notes

You must log in before being able to contribute a note or feedback.