WP_Interactivity_API::data_wp_text_processor │ private │ WP 6.5.0

Processes the data-wp-text directive.

It updates the inner content of the current HTML element based on the evaluation of its associated reference.

Method of the class: WP_Interactivity_API{}

No Hooks.

Returns

null. Nothing (null).

Usage

// private - for code of main (parent) class only
$result = $this->data_wp_text_processor( $p, $mode );

$p(WP_Interactivity_API_Directives_Processor) (required)

The directives processor instance.

$mode(string) (required)

Whether the processing is entering or exiting the tag.

Changelog

WP_Interactivity_API::data_wp_text_processor() WP Interactivity API::data wp text processor code ^{WP 6.9.1}

private function data_wp_text_processor( WP_Interactivity_API_Directives_Processor $p, string $mode ) {
	if ( 'enter' === $mode ) {
		$entries     = $this->get_directive_entries( $p, 'text' );
		$valid_entry = null;
		// Get the first valid `data-wp-text` entry without suffix or unique ID.
		foreach ( $entries as $entry ) {
			if ( null === $entry['suffix'] && null === $entry['unique_id'] && ! empty( $entry['value'] ) ) {
				$valid_entry = $entry;
				break;
			}
		}
		if ( null === $valid_entry ) {
			return;
		}
		$result = $this->evaluate( $valid_entry );

		/*
		 * Follows the same logic as Preact in the client and only changes the
		 * content if the value is a string or a number. Otherwise, it removes the
		 * content.
		 */
		if ( is_string( $result ) || is_numeric( $result ) ) {
			$p->set_content_between_balanced_tags( esc_html( $result ) );
		} else {
			$p->set_content_between_balanced_tags( '' );
		}
	}
}