has_translation()
云策文档标注
概述
has_translation() 函数用于检查指定字符串是否存在翻译，支持可选的文本域和区域设置参数，返回布尔值。
关键要点
- 函数签名：has_translation( string $singular, string $textdomain = 'default', ?string $locale = null ): bool
- 参数：$singular（必需，要检查的翻译字符串），$textdomain（可选，文本域，默认 'default'），$locale（可选，区域设置，默认当前区域或 null）
- 返回值：如果翻译存在返回 true，否则返回 false
- 内部调用 WP_Translation_Controller::get_instance()->has_translation() 实现
- 自 WordPress 6.7.0 版本引入
代码示例
has_translation( string $singular, string $textdomain = 'default', ?string $locale = null ): bool {
return WP_Translation_Controller::get_instance()->has_translation( $singular, $textdomain, $locale );
}
原文内容
Returns a boolean to indicate whether a translation exists for a given string with optional text domain and locale.
Parameters
$singularstringrequired-
Singular translation to check.
$textdomainstringoptional-
Text domain. Default
'default'. $locale?stringoptional-
Locale. Default current locale.
Default:
null
Source
function has_translation( string $singular, string $textdomain = 'default', ?string $locale = null ): bool {
return WP_Translation_Controller::get_instance()->has_translation( $singular, $textdomain, $locale );
}
Changelog
| Version | Description |
|---|---|
| 6.7.0 | Introduced. |