1. 首页
  2. WordPress 函数手册

add_editor_style()

add_editor_style( array|string $stylesheet = ‘editor-style.css’ )

为自定义TinyMCE编辑器样式表添加回调。
Add callback for custom TinyMCE editor stylesheets.

目录锚点:#说明#参数#返回#源码#笔记


说明(Description)

参数$stylesheet是样式表的名称,相对于主题根。它还接受一个样式表数组。它是可选的,默认为编辑器-样式表’.

此函数自动添加另一个带有-rtl前缀的样式表,例如编辑器样式-实时样式表. 如果该文件不存在,则在将样式表添加到TinyMCE之前将其删除。如果将样式表数组传递给add_editor_style(),则只为第一个样式表添加RTL。

从版本3.4开始,TinyMCE主体就有了.rtl CSS类。使用该类并将任何RTL样式添加到主样式表中是一个更好的选择。


参数(Parameters)

参数 类型 必填 说明
$stylesheet (array | string) 可选 样式表名称或其数组,相对于主题根。默认为“编辑器”-样式表’

返回(Return)

无返回值


源码(Source)

/**
 * Add callback for custom TinyMCE editor stylesheets.
 *
 * The parameter $stylesheet is the name of the stylesheet, relative to
 * the theme root. It also accepts an array of stylesheets.
 * It is optional and defaults to 'editor-style.css'.
 *
 * This function automatically adds another stylesheet with -rtl prefix, e.g. editor-style-rtl.css.
 * If that file doesn't exist, it is removed before adding the stylesheet(s) to TinyMCE.
 * If an array of stylesheets is passed to add_editor_style(),
 * RTL is only added for the first stylesheet.
 *
 * Since version 3.4 the TinyMCE body has .rtl CSS class.
 * It is a better option to use that class and add any RTL styles to the main stylesheet.
 *
 * @since 3.0.0
 *
 * @global array $editor_styles
 *
 * @param array|string $stylesheet Optional. Stylesheet name or array thereof, relative to theme root.
 * 	                               Defaults to 'editor-style.css'
 */
function add_editor_style( $stylesheet = 'editor-style.css' ) {
	add_theme_support( 'editor-style' );

	if ( ! is_admin() )
		return;

	global $editor_styles;
	$editor_styles = (array) $editor_styles;
	$stylesheet    = (array) $stylesheet;
	if ( is_rtl() ) {
		$rtl_stylesheet = str_replace('.css', '-rtl.css', $stylesheet[0]);
		$stylesheet[] = $rtl_stylesheet;
	}

	$editor_styles = array_merge( $editor_styles, $stylesheet );
}
更新版本 源码位置 使用 被使用
3.0.0 wp-includes/theme.php:1943 0 2

笔记(Notes)

基本示例
如果要动态添加样式(例如从主题mods),可以使用tiny_mce_before_init过滤器并将其添加到content_style键。
使用谷歌字体

add_editor_style() 为WP2原创文章,链接:https://www.wp2.cn/functions/add_editor_style/

发表评论

您的电子邮箱地址不会被公开。