云策 WordPress 开发者社区

函数文档

_ex()

查看官方原文 ↗
💡 云策文档标注

概述

_ex() 是一个 WordPress 函数，用于显示带有 gettext 上下文的翻译字符串。它直接输出翻译后的文本，适用于需要即时显示的场景。

关键要点

  • 函数作用：输出翻译字符串，结合上下文信息以提高翻译准确性。
  • 参数说明：$text（必需，要翻译的文本）、$context（必需，翻译上下文）、$domain（可选，文本域，默认为 'default'）。
  • 实现方式：内部调用 _x() 函数进行翻译并直接输出结果。
  • 相关函数：与 _x() 紧密相关，后者用于检索翻译字符串而不输出。
  • 使用场景：广泛用于 WordPress 核心和管理界面，如自定义器、主题安装、插件搜索等模板渲染。
  • 版本历史：自 WordPress 3.0.0 版本引入。

代码示例

_ex( $text, $context, $domain = 'default' ) {
    echo _x( $text, $context, $domain );
}
📄 原文内容

Displays translated string with gettext context.

Parameters

$textstringrequired
Text to translate.
$contextstringrequired
Context information for the translators.
$domainstringoptional
Text domain. Unique identifier for retrieving translated strings.
Default 'default'.

Source

function _ex( $text, $context, $domain = 'default' ) {
	echo _x( $text, $context, $domain );
}

View all references View on Trac View on GitHub

Uses Description
_x()wp-includes/l10n.php

Retrieves translated string with gettext context.
Used by Description
WP_Customize_Themes_Panel::render_template()wp-includes/customize/class-wp-customize-themes-panel.php

An Underscore (JS) template for rendering this panel’s container.
WP_Customize_Theme_Control::content_template()wp-includes/customize/class-wp-customize-theme-control.php

Render a JS template for theme display.
customize_themes_print_templates()wp-admin/includes/theme.php

Prints JS templates for the theme-browsing UI in the Customizer.
wp_print_revision_templates()wp-admin/includes/revision.php

Print JavaScript templates required for the revisions experience.
display_setup_form()wp-admin/install.php

Displays installer setup form.
install_theme_search_form()wp-admin/includes/theme-install.php

Displays search form for searching themes.
install_search_form()wp-admin/includes/plugin-install.php

Displays a search form for searching plugins.
install_plugin_information()wp-admin/includes/plugin-install.php

Displays plugin information in dialog box form.
list_meta()wp-admin/includes/template.php

Outputs a post’s public meta data in the Custom Fields meta box.
meta_form()wp-admin/includes/template.php

Prints the form in the Custom Fields meta box.
media_upload_gallery_form()wp-admin/includes/media.php

Adds gallery form to upload iframe.
media_upload_form()wp-admin/includes/media.php

Outputs the legacy media upload form.
link_categories_meta_box()wp-admin/includes/meta-boxes.php

Displays link categories form fields.
link_xfn_meta_box()wp-admin/includes/meta-boxes.php

Displays XFN form fields.
post_submit_meta_box()wp-admin/includes/meta-boxes.php

Displays post submit form fields.
WP_Terms_List_Table::inline_edit()wp-admin/includes/class-wp-terms-list-table.php

Outputs the hidden row displayed when inline editing
WP_Posts_List_Table::inline_edit()wp-admin/includes/class-wp-posts-list-table.php

Outputs the hidden row displayed when inline editing
wp_widget_control()wp-admin/includes/widgets.php

Meta widget used to display the control form for a widget.
Custom_Background::admin_page()wp-admin/includes/class-custom-background.php

Displays the custom background page.
WP_Widget_Links::form()wp-includes/widgets/class-wp-widget-links.php

Outputs the settings form for the Links widget.
WP_Customize_Header_Image_Control::render_content()wp-includes/customize/class-wp-customize-header-image-control.php
wp_print_media_templates()wp-includes/media-template.php

Prints the templates used in the media manager.

Show 17 moreShow less

Changelog

Version Description
3.0.0 Introduced.