esc_html_e() WP 2.8.0

Translates specified string and replaces special characters in it with HTML entities. Displays text that can be used in HTML as HTML code.

No Hooks.

Return

Null. Nothing.

Usage

esc_html_e( $text, $domain );

$text(string) (required)

Text to translate.

$domain(string)

Text domain. Unique identifier for retrieving translated strings.
Default: 'default'

Examples

#1 Output in the tag

If the translation has HTML tags or characters that need to be shown as it is, for example in <textarea> tag, then it is smart to translate such a string with this function:

<textarea>
	<?php echo esc_html__('Any text with <span>HTML.</span>', 'kama'); ?>
</textarea>

#1.2 Same as in the first example but in a different way

<?php echo esc_html( __('Any text with <div>HTML.</div>', 'kama') );

// Or so
echo esc_html__('Any text with <div>HTML.</div>', 'kama');

Changelog

Code of esc html e: wp-includes/l10n.php ^{WP 5.2.4}

<?php
function esc_html_e( $text, $domain = 'default' ) {
	echo esc_html( translate( $text, $domain ) );
}

Related Functions

From tag: esc_ (clean validate sanitize)

More from tag: localize (l10n i18n Internationalization localization)

More from category: Localization