云策 WordPress 开发者社区

函数文档

is_rtl()

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

概述

is_rtl() 函数用于检测当前语言环境是否为从右到左（RTL）布局，常用于主题和插件开发中根据语言方向加载相应样式或脚本。自 WordPress 3.0 起，推荐使用此函数替代 get_bloginfo('text_direction')。

关键要点

  • is_rtl() 返回布尔值，表示当前语言环境是否为 RTL。
  • 该函数内部依赖 WP_Locale 类，通过 $wp_locale->is_rtl() 实现检测。
  • 在 WordPress 3.0 中引入，取代了 get_bloginfo('text_direction') 的使用。
  • 广泛应用于样式加载、编辑器设置、语言属性获取等多个核心功能中。

代码示例

if ( is_rtl() ) {
  wp_enqueue_style(  'style-rtl',  plugins_url( '/css/style-rtl.css', __FILE__ ) );
  wp_enqueue_script( 'script-rtl', plugins_url( '/js/script-rtl.js',  __FILE__ ) );
}
📄 原文内容

Determines whether the current locale is right-to-left (RTL).

Description

For more information on this and similar theme functions, check out the Conditional Tags article in the Theme Developer Handbook.

Return

bool Whether locale is RTL.

More Information

Deprecate get_bloginfo(‘text_direction’) in favor of is_rtl() in Version 3.0.

Source

function is_rtl() {
	global $wp_locale;
	if ( ! ( $wp_locale instanceof WP_Locale ) ) {
		return false;
	}
	return $wp_locale->is_rtl();
}

View all references View on Trac View on GitHub

Uses Description
WP_Locale::is_rtl()wp-includes/class-wp-locale.php

Checks if current locale is RTL.
Used by Description
wp_enqueue_block_style()wp-includes/script-loader.php

Enqueues a stylesheet for a specific block.
get_default_block_editor_settings()wp-includes/block-editor.php

Returns the default block editor settings.
register_block_style_handle()wp-includes/blocks.php

Finds a style handle for the block metadata field. It detects when a path to file was provided and registers the style under automatically generated handle name. It returns unprocessed style handle otherwise.
WP_Sitemaps_Stylesheet::get_stylesheet_css()wp-includes/sitemaps/class-wp-sitemaps-stylesheet.php

Gets the CSS to be included in sitemap XSL stylesheets.
_wp_die_process_input()wp-includes/functions.php

Processes arguments passed to wp_die() consistently for its handlers.
_WP_Editors::print_default_editor_scripts()wp-includes/class-wp-editor.php

Print (output) all editor scripts and default settings.
get_language_attributes()wp-includes/general-template.php

Gets the language attributes for the ‘html’ tag.
login_header()wp-login.php

Outputs the login page header.
display_header()wp-admin/install.php

Display installation header.
iframe_header()wp-admin/includes/template.php

Generic Iframe header for use with Thickbox.
wp_iframe()wp-admin/includes/media.php

Outputs the iframe to display the media upload page.
add_editor_style()wp-includes/theme.php

Adds callback for custom TinyMCE editor stylesheets.
register_admin_color_schemes()wp-includes/general-template.php

Registers the default admin color schemes.
wp_admin_css()wp-includes/general-template.php

Enqueues or directly prints a stylesheet link to the specified CSS file.
get_bloginfo()wp-includes/general-template.php

Retrieves information about the current site.
_mce_set_direction()wp-includes/functions.php

Sets the localized direction for MCE plugin.
get_body_class()wp-includes/post-template.php

Retrieves an array of the class names for the body element.
gallery_shortcode()wp-includes/media.php

Builds the Gallery shortcode output.
wp_default_styles()wp-includes/script-loader.php

Assigns default styles to $styles object.
_WP_Editors::wp_mce_translation()wp-includes/class-wp-editor.php

Translates the default TinyMCE strings and returns them as JSON encoded object ready to be loaded with tinymce.addI18n(), or as JS snippet that should run after tinymce.js is loaded.

Show 15 moreShow less

Changelog

Version Description
3.0.0 Introduced.

User Contributed Notes