WP_HTML_Processor::get_attribute_names_with_prefix() – Method

WP_HTML_Processor::get_attribute_names_with_prefix( string $prefix ): array|null

Gets lowercase names of all attributes matching a given prefix in the current tag.

Description

Note that matching is case-insensitive. This is in accordance with the spec:

There must never be two or more attributes on the same start tag whose names are an ASCII case-insensitive match for each other.

HTML 5 spec

Example:

$p = new WP_HTML_Tag_Processor( '<div data-ENABLED class="test" DATA-test-id="14">Test</div>' );
$p->next_tag( array( 'class_name' => 'test' ) ) === true;
$p->get_attribute_names_with_prefix( 'data-' ) === array( 'data-enabled', 'data-test-id' );

$p->next_tag() === false;
$p->get_attribute_names_with_prefix( 'data-' ) === null;

Parameters

$prefixstringrequired: Prefix of requested attribute names.

Return

array|null List of attribute names, or null when no tag opener is matched.

Source

*
* @see https://html.spec.whatwg.org/multipage/parsing.html#parsing-main-inhead
* @see WP_HTML_Processor::step

View all references View on Trac View on GitHub

Changelog

Version	Description
6.6.0	Introduced.

User Contributed Notes

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