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

__( string $text, string $domain = 'default' )

检索$text的翻译

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值

描述

如果没有翻译,或者没有加载文本域,则返回原始文本。


参数

$text

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

$domain

(string) (可选) Text domain(文本域),用于检索翻译字符串的唯一标识符。

默认值: 'default'


返回

(string) 翻译文本。



源码

查看源码 官方文档


更新日志

版本描述
2.1.0开始引入

使用示例

  • 示例1

    对于包含链接的转义文本,请将__()与sprintf结合使用。像这样

    sprintf( __( 'You can visit the page by clicking <a href="%s">here</a>.', 'text_domain' ), 
    			'http://example.com'
    		);

    这将防止翻译更改链接。

  • 示例2

    使插件或主题中的字符串可翻译:

    $translated = __( 'Hello World!', 'mytextdomain' );
    

    “mytextdomain”需要是在整个插件/主题中使用的唯一文本域。如上所示,这应该始终作为字符串文字直接传递,而不是分配给变量或常量的字符串。例如这是不正确的:

    $text_domain = 'mytextdomain';
    $string = 'Hello World!';
    $translated = __( $string, $text_domain );
    

    这似乎是可行的,但它会干扰插件/主题文件的自动解析以进行翻译。

  • 示例3

    我们也有 _e,它们做同样的事情,但它们之间唯一的区别是
    _e 直接回显,而 __() 我们需要回显它们。

    例如:

    _e(‘this is some message’, ‘twentyfourteen’);

    等同于

    echo __(‘this is a some message’, ‘twentyfourteen’);