描述
如果没有翻译,或者没有加载文本域,则转义并返回原始文本。
参数
- $text
-
(string) (必填) 要翻译的文本。
- $context
-
(string) (必填) 为译者提供语境信息。
- $domain
-
(string) (可选) Text domain(文本域),用于检索翻译字符串的唯一标识符。
默认值: 'default'
返回
(string) 翻译文本。
源码
更新日志
版本 | 描述 |
---|---|
2.9.0 | 开始引入 |
使用示例
_x 函数(类似 esc_html_x)与它们的 _e 对应函数基本相同,但增加了一个 "context" 参数,以解释一个词或短语的使用环境。对有多种含义的词很有用:
<!-- Here, we're asking the user to comment (verb): --> <a href="#comment"> <?php echo esc_html_x( 'Comment', 'Verb: To leave a comment', // Here's the contextual help 'wpdocs_my_theme' ); ?> </a> <!-- Here, we're simply adding a heading with the text "Comment" (noun) --> <h3> <?php echo esc_html_x( 'Comment', 'Noun: An individual comment', // Here's the contextual help 'wpdocs_my_theme' ); ?> </h3>