WordPress.org
Get WordPress
WordPress.org

WordPress Developer Resources

WP_HTML_Processor::insert_virtual_node()

WP_HTML_Processor::insert_virtual_node( string $token_name, string|null $bookmark_name = null ): WP_HTML_Token

In this article

Back to top

This function’s access is marked private. This means it is not intended for use by plugin or theme developers, only in other core functions. It is listed here for completeness.

Inserts a virtual element on the stack of open elements.

Parameters

$token_namestringrequired
Name of token to create and insert into the stack of open elements.
$bookmark_namestring|nulloptional
Name to give bookmark for created virtual node.
Defaults to auto-creating a bookmark name.

Default:null

Return

WP_HTML_Token Newly-created virtual token.

Source

private function insert_virtual_node( $token_name, $bookmark_name = null ): WP_HTML_Token {
	$here = $this->bookmarks[ $this->state->current_token->bookmark_name ];
	$name = $bookmark_name ?? $this->bookmark_token();

	$this->bookmarks[ $name ] = new WP_HTML_Span( $here->start, 0 );

	$token = new WP_HTML_Token( $name, $token_name, false );
	$this->insert_html_element( $token );
	return $token;
}

View all references View on Trac View on GitHub

UsesDescription
WP_HTML_Processor::bookmark_token()wp-includes/html-api/class-wp-html-processor.php

Creates a new bookmark for the currently-matched token and returns the generated name.

WP_HTML_Processor::insert_html_element()wp-includes/html-api/class-wp-html-processor.php

Inserts an HTML element on the stack of open elements.

WP_HTML_Token::__construct()wp-includes/html-api/class-wp-html-token.php

Constructor – creates a reference to a token in some external HTML string.

WP_HTML_Span::__construct()wp-includes/html-api/class-wp-html-span.php

Constructor.

Used byDescription
WP_HTML_Processor::step_after_head()wp-includes/html-api/class-wp-html-processor.php

Parses next element in the ‘after head’ insertion mode.

WP_HTML_Processor::step_in_table()wp-includes/html-api/class-wp-html-processor.php

Parses next element in the ‘in table’ insertion mode.

WP_HTML_Processor::step_in_table_body()wp-includes/html-api/class-wp-html-processor.php

Parses next element in the ‘in table body’ insertion mode.

WP_HTML_Processor::step_before_html()wp-includes/html-api/class-wp-html-processor.php

Parses next element in the ‘before html’ insertion mode.

WP_HTML_Processor::step_before_head()wp-includes/html-api/class-wp-html-processor.php

Parses next element in the ‘before head’ insertion mode.

Changelog

VersionDescription
6.7.0Introduced.

User Contributed Notes

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