Question

wp_replace_in_html_tags( string $haystack,  array $replace_pairs )

Replace characters or phrases within HTML elements only.

---

description

---

参数

$haystack

(string) (Required) The text which has to be formatted.

$replace_pairs

(array) (Required) In the form array('from' => 'to', ...).

---

返回值

(string) The formatted text.

---

源代码

File: wp-includes/formatting.php

function wp_replace_in_html_tags( $haystack, $replace_pairs ) {
	// Find all elements.
	$textarr = wp_html_split( $haystack );
	$changed = false;

	// Optimize when searching for one item.
	if ( 1 === count( $replace_pairs ) ) {
		// Extract $needle and $replace.
		foreach ( $replace_pairs as $needle => $replace );

		// Loop through delimiters (elements) only.
		for ( $i = 1, $c = count( $textarr ); $i < $c; $i += 2 ) {
			if ( false !== strpos( $textarr[$i], $needle ) ) {
				$textarr[$i] = str_replace( $needle, $replace, $textarr[$i] );
				$changed = true;
			}
		}
	} else {
		// Extract all $needles.
		$needles = array_keys( $replace_pairs );

		// Loop through delimiters (elements) only.
		for ( $i = 1, $c = count( $textarr ); $i < $c; $i += 2 ) {
			foreach ( $needles as $needle ) {
				if ( false !== strpos( $textarr[$i], $needle ) ) {
					$textarr[$i] = strtr( $textarr[$i], $replace_pairs );
					$changed = true;
					// After one strtr() break out of the foreach loop and look at next element.
					break;
				}
			}
		}
	}

	if ( $changed ) {
		$haystack = implode( $textarr );
	}

	return $haystack;
}

---

更新日志

Version	description
4.2.3	Introduced.

---

相关函数

Uses

• wp-includes/formatting.php: wp_html_split()

---

Used By

• wp-includes/formatting.php: wpautop()
• wp-includes/class-wp-embed.php: WP_Embed::autoembed()

---

User Contributed Notes