wpseek.com
A WordPress-centric search engine for devs and theme authors



add_editor_style › WordPress Function

Since3.0.0
Deprecatedn/a
› add_editor_style ( $stylesheet = 'editor-style.css' )
Parameters:
  • (array|string) $stylesheet Optional. Stylesheet name or array thereof, relative to theme root. Defaults to 'editor-style.css'
    Required: No
    Default: 'editor-style.css'
Defined at:
Codex:

Adds 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. Internally this registers the 'editor-style' (singular) theme support to enable editor stylesheets for the classic/TinyMCE editor. The plural form, 'editor-styles', is a separate theme support that allows the block editor to load the stylesheets registered by this function. To add styles to the block editor, use add_theme_support( 'editor-styles' ) in addition to this function. Block themes support 'editor-styles' by default.


Related Functions: remove_editor_styles, get_editor_stylesheets, wp_register_style, wp_add_editor_classic_theme_styles, add_rewrite_rule

Source 

function add_editor_style( $stylesheet = 'editor-style.css' ) {
	global $editor_styles;

	add_theme_support( 'editor-style' );

	$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 );
}