WP_HTML_Tag_Processor::get_token_name(): string|null

Returns the node name represented by the token.

Description

This matches the DOM API value nodeName. Some values are static, such as #text for a text node, while others are dynamically generated from the token itself.

Dynamic names:

Uppercase tag name for tag matches.
html for DOCTYPE declarations.

Note that if the Tag Processor is not matched on a token then this function will return null, either because it hasn’t yet found a token or because it reached the end of the document without matching a token.

Return

string|null Name of the matched token.

Source

public function get_token_name(): ?string {
	switch ( $this->parser_state ) {
		case self::STATE_MATCHED_TAG:
			return $this->get_tag();

		case self::STATE_TEXT_NODE:
			return '#text';

		case self::STATE_CDATA_NODE:
			return '#cdata-section';

		case self::STATE_COMMENT:
			return '#comment';

		case self::STATE_DOCTYPE:
			return 'html';

		case self::STATE_PRESUMPTUOUS_TAG:
			return '#presumptuous-tag';

		case self::STATE_FUNKY_COMMENT:
			return '#funky-comment';
	}

	return null;
}

View all references View on Trac View on GitHub

Uses	Description
WP_HTML_Tag_Processor::get_tag()`wp-includes/html-api/class-wp-html-tag-processor.php`	Returns the uppercase name of the matched tag.

Used by	Description
WP_HTML_Processor::get_token_name()`wp-includes/html-api/class-wp-html-processor.php`	Returns the node name represented by the token.
WP_HTML_Tag_Processor::get_token_type()`wp-includes/html-api/class-wp-html-tag-processor.php`	Indicates the kind of matched token, if any.
WP_HTML_Tag_Processor::get_modifiable_text()`wp-includes/html-api/class-wp-html-tag-processor.php`	Returns the modifiable text for a matched token, or an empty string.

Changelog

Version	Description
6.5.0	Introduced.

User Contributed Notes

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