WP_HTML_Processor::next_tag( array|string|null $query = null ): bool

Source

 *
 *     └─#text Inside TD?
 *
 * Notice that the `<td>` tags are completely ignored.
 *
 * Compare that with an SVG context node that produces the following tree:
 *
 *     ├─svg:td
 *     └─#text Inside TD?
 *
 * Here, a `td` node in the `svg` namespace is created, and its self-closing flag is respected.
 * This is a peculiarity of parsing HTML in foreign content like SVG.
 *
 * Finally, consider the tree produced with a TABLE context node:
 *
 *     └─TBODY
 *       └─TR
 *         └─TD
 *           └─#text Inside TD?
 *
 * These examples demonstrate how important the context node may be when processing an HTML
 * fragment. Special care must be taken when processing fragments that are expected to appear
 * in specific contexts. SVG and TABLE are good examples, but there are others.
 *
 * @see https://html.spec.whatwg.org/multipage/parsing.html#html-fragment-parsing-algorithm
 *
 * @since 6.8.0
 *
 * @param string $html Input HTML fragment to process.
 * @return static|null The created processor if successful, otherwise null.
 */
private function create_fragment_at_current_node( string $html ) {
	if ( $this->get_token_type() !== '#tag' || $this->is_tag_closer() ) {
		_doing_it_wrong(
			__METHOD__,
			__( 'The context element must be a start tag.' ),
			'6.8.0'
		);
		return null;
	}

	$tag_name  = $this->current_element->token->node_name;
	$namespace = $this->current_element->token->namespace;

	if ( 'html' === $namespace && self::is_void( $tag_name ) ) {
		_doing_it_wrong(
			__METHOD__,
			sprintf(
				// translators: %s: A tag name like INPUT or BR.
				__( 'The context element cannot be a void element, found "%s".' ),
				$tag_name
			),
			'6.8.0'
		);
		return null;
	}

	/*
	 * Prevent creating fragments at nodes that require a special tokenizer state.
	 * This is unsupported by the HTML Processor.
	 */
	if (
		'html' === $namespace &&
		in_array( $tag_name, array( 'IFRAME', 'NOEMBED', 'NOFRAMES', 'SCRIPT', 'STYLE', 'TEXTAREA', 'TITLE', 'XMP', 'PLAINTEXT' ), true )
	) {
		_doing_it_wrong(
			__METHOD__,
			sprintf(
				// translators: %s: A tag name like IFRAME or TEXTAREA.
				__( 'The context element "%s" is not supported.' ),
				$tag_name

View all references View on Trac View on GitHub