当前浏览:首页 / WordPress函数 / _x()

_x( string $text, string $context, string $domain = 'default' )

使用gettext上下文检索已翻译的字符串

e 翻译more...

  • __() 检索$text的翻译
  • _e() 显示翻译文本
  • _ex() 使用gettext上下文显示翻译后的字符串
  • _n_noop() 在POT文件中注册多个字符串,但不翻译它们
  • _n() 基于提供的数字翻译和检索单数或复数形式
  • _nx_noop() 在POT文件中使用gettext上下文注册多个字符串,但不翻译它们
  • _nx() 使用gettext上下文,根据提供的数字检索单/复数形式进行翻译
  • _x() 使用gettext上下文检索已翻译的字符串
  • esc_attr__() 检索$text的翻译并将其转义,以便在属性中安全使用
  • esc_attr_e() 显示为在属性中安全使用而转义的翻译文本

esc 转义more...

  • esc_attr__() 检索$text的翻译并将其转义,以便在属性中安全使用
  • esc_attr_e() 显示为在属性中安全使用而转义的翻译文本
  • esc_attr_x() 使用gettext上下文翻译字符串,并将其转义以在属性中安全使用。
  • esc_attr() 转义HTML属性
  • esc_html__() 检索$text的翻译并将其转义,以便在HTML输出中安全使用。
  • esc_html_e() 显示为在HTML输出中安全使用而转义的翻译文本。
  • esc_html_x() 使用gettext上下文翻译字符串,并将其转义,以便在HTML输出中安全使用
  • esc_html() 转义HTML块
  • esc_js() 转义单引号、"、 、&,并修复行尾。
  • esc_textarea() 转义textarea值

描述

很多时候,在两个以上的地方发现的类似可翻译文本会发生冲突,但翻译上下文不同。

通过在pot文件中包含上下文,翻译人员可以不同地翻译这两个字符串。


参数

$text

(string)(必填) 要翻译的文本。

$context

(string)(必填) 翻译人员的上下文信息。

$domain

(string)(可选) 文本域。检索已翻译字符串的唯一标识符。

默认值: 'default'


返回

(string) 翻译后的上下文字符串。



源码

查看源码 官方文档


更新日志

版本描述
2.8.0开始引入

使用示例

  • 示例1

    实例

    $translated = _x( 'Read', 'past participle: books I have read', 'textdomain' );
    

    由于字符串“Read”本身在英语中可能有几种不同的含义,因此给出了上下文,以便译者知道他们应该提供一个简短的术语,意思是“我读过的书”