WP_HTML_Processor::set_attribute │ public │ WP 6.6.0

Updates or creates a new attribute on the currently matched tag with the passed value.

This function handles all necessary HTML encoding. Provide normal, unescaped string values. The HTML API will encode the strings appropriately so that the browser will interpret them as the intended value.

Example:

// Renders “Eggs & Milk” in a browser, encoded as `<abbr title="Eggs & Milk">`.
$processor->set_attribute( 'title', 'Eggs & Milk' );

// Renders “Eggs & Milk” in a browser, encoded as `<abbr title="Eggs &amp; Milk">`.
$processor->set_attribute( 'title', 'Eggs & Milk' );

// Renders `true` as `<abbr title>`.
$processor->set_attribute( 'title', true );

// Renders without the attribute for `false` as `<abbr>`.
$processor->set_attribute( 'title', false );

Special handling is provided for boolean attribute values:

• When true is passed as the value, then only the attribute name is added to the tag.
• When false is passed, the attribute gets removed if it existed before.

Метод класса: WP_HTML_Processor{}

Хуков нет.

Возвращает

true|false. Whether an attribute value was set.

Использование

$WP_HTML_Processor = new WP_HTML_Processor();
$WP_HTML_Processor->set_attribute( $name, $value ): bool;

$name(строка) (обязательный)

The attribute name to target.

$value(строка|true|false) (обязательный)

The new attribute value.

Список изменений

Код WP_HTML_Processor::set_attribute() WP HTML Processor::set attribute ^{WP 7.0.1}

public function set_attribute( $name, $value ): bool {
	return $this->is_virtual() ? false : parent::set_attribute( $name, $value );
}