Upgrade to 4.5.7 and add some plugin

[perso/Immae/Projets/packagist/connexionswing-ckeditor-component.git] / sources / plugins / toolbar / plugin.js

/**\r
 * @license Copyright (c) 2003-2016, CKSource - Frederico Knabben. All rights reserved.\r
 * For licensing, see LICENSE.md or http://ckeditor.com/license\r
 */\r
\r
/**\r
 * @fileOverview The "toolbar" plugin. Renders the default toolbar interface in\r
 * the editor.\r
 */\r
\r
( function() {\r
	var toolbox = function() {\r
			this.toolbars = [];\r
			this.focusCommandExecuted = false;\r
		};\r
\r
	toolbox.prototype.focus = function() {\r
		for ( var t = 0, toolbar; toolbar = this.toolbars[ t++ ]; ) {\r
			for ( var i = 0, item; item = toolbar.items[ i++ ]; ) {\r
				if ( item.focus ) {\r
					item.focus();\r
					return;\r
				}\r
			}\r
		}\r
	};\r
\r
	var commands = {\r
		toolbarFocus: {\r
			modes: { wysiwyg: 1, source: 1 },\r
			readOnly: 1,\r
\r
			exec: function( editor ) {\r
				if ( editor.toolbox ) {\r
					editor.toolbox.focusCommandExecuted = true;\r
\r
					// Make the first button focus accessible for IE. (#3417)\r
					// Adobe AIR instead need while of delay.\r
					if ( CKEDITOR.env.ie || CKEDITOR.env.air ) {\r
						setTimeout( function() {\r
							editor.toolbox.focus();\r
						}, 100 );\r
					} else {\r
						editor.toolbox.focus();\r
					}\r
				}\r
			}\r
		}\r
	};\r
\r
	CKEDITOR.plugins.add( 'toolbar', {\r
		requires: 'button',\r
		// jscs:disable maximumLineLength\r
		lang: 'af,ar,bg,bn,bs,ca,cs,cy,da,de,de-ch,el,en,en-au,en-ca,en-gb,eo,es,et,eu,fa,fi,fo,fr,fr-ca,gl,gu,he,hi,hr,hu,id,is,it,ja,ka,km,ko,ku,lt,lv,mk,mn,ms,nb,nl,no,pl,pt,pt-br,ro,ru,si,sk,sl,sq,sr,sr-latn,sv,th,tr,tt,ug,uk,vi,zh,zh-cn', // %REMOVE_LINE_CORE%\r
		// jscs:enable maximumLineLength\r
\r
		init: function( editor ) {\r
			var endFlag;\r
\r
			var itemKeystroke = function( item, keystroke ) {\r
					var next, toolbar;\r
					var rtl = editor.lang.dir == 'rtl',\r
						toolbarGroupCycling = editor.config.toolbarGroupCycling,\r
						// Picking right/left key codes.\r
						rightKeyCode = rtl ? 37 : 39,\r
						leftKeyCode = rtl ? 39 : 37;\r
\r
					toolbarGroupCycling = toolbarGroupCycling === undefined || toolbarGroupCycling;\r
\r
					switch ( keystroke ) {\r
						case 9: // TAB\r
						case CKEDITOR.SHIFT + 9: // SHIFT + TAB\r
							// Cycle through the toolbars, starting from the one\r
							// closest to the current item.\r
							while ( !toolbar || !toolbar.items.length ) {\r
								if ( keystroke == 9 ) {\r
									toolbar = ( ( toolbar ? toolbar.next : item.toolbar.next ) || editor.toolbox.toolbars[ 0 ] );\r
								} else {\r
									toolbar = ( ( toolbar ? toolbar.previous : item.toolbar.previous ) || editor.toolbox.toolbars[ editor.toolbox.toolbars.length - 1 ] );\r
								}\r
\r
								// Look for the first item that accepts focus.\r
								if ( toolbar.items.length ) {\r
									item = toolbar.items[ endFlag ? ( toolbar.items.length - 1 ) : 0 ];\r
									while ( item && !item.focus ) {\r
										item = endFlag ? item.previous : item.next;\r
\r
										if ( !item )\r
											toolbar = 0;\r
									}\r
								}\r
							}\r
\r
							if ( item )\r
								item.focus();\r
\r
							return false;\r
\r
						case rightKeyCode:\r
							next = item;\r
							do {\r
								// Look for the next item in the toolbar.\r
								next = next.next;\r
\r
								// If it's the last item, cycle to the first one.\r
								if ( !next && toolbarGroupCycling ) next = item.toolbar.items[ 0 ];\r
							}\r
							while ( next && !next.focus );\r
\r
							// If available, just focus it, otherwise focus the\r
							// first one.\r
							if ( next )\r
								next.focus();\r
							else\r
								// Send a TAB.\r
								itemKeystroke( item, 9 );\r
\r
							return false;\r
						case 40: // DOWN-ARROW\r
							if ( item.button && item.button.hasArrow ) {\r
								// Note: code is duplicated in plugins\richcombo\plugin.js in keyDownFn().\r
								editor.once( 'panelShow', function( evt ) {\r
									evt.data._.panel._.currentBlock.onKeyDown( 40 );\r
								} );\r
								item.execute();\r
							} else {\r
								// Send left arrow key.\r
								itemKeystroke( item, keystroke == 40 ? rightKeyCode : leftKeyCode );\r
							}\r
							return false;\r
						case leftKeyCode:\r
						case 38: // UP-ARROW\r
							next = item;\r
							do {\r
								// Look for the previous item in the toolbar.\r
								next = next.previous;\r
\r
								// If it's the first item, cycle to the last one.\r
								if ( !next && toolbarGroupCycling ) next = item.toolbar.items[ item.toolbar.items.length - 1 ];\r
							}\r
							while ( next && !next.focus );\r
\r
							// If available, just focus it, otherwise focus the\r
							// last one.\r
							if ( next )\r
								next.focus();\r
							else {\r
								endFlag = 1;\r
								// Send a SHIFT + TAB.\r
								itemKeystroke( item, CKEDITOR.SHIFT + 9 );\r
								endFlag = 0;\r
							}\r
\r
							return false;\r
\r
						case 27: // ESC\r
							editor.focus();\r
							return false;\r
\r
						case 13: // ENTER\r
						case 32: // SPACE\r
							item.execute();\r
							return false;\r
					}\r
					return true;\r
				};\r
\r
			editor.on( 'uiSpace', function( event ) {\r
				if ( event.data.space != editor.config.toolbarLocation )\r
					return;\r
\r
				// Create toolbar only once.\r
				event.removeListener();\r
\r
				editor.toolbox = new toolbox();\r
\r
				var labelId = CKEDITOR.tools.getNextId();\r
\r
				var output = [\r
					'<span id="', labelId, '" class="cke_voice_label">', editor.lang.toolbar.toolbars, '</span>',\r
					'<span id="' + editor.ui.spaceId( 'toolbox' ) + '" class="cke_toolbox" role="group" aria-labelledby="', labelId, '" onmousedown="return false;">'\r
				];\r
\r
				var expanded = editor.config.toolbarStartupExpanded !== false,\r
					groupStarted, pendingSeparator;\r
\r
				// If the toolbar collapser will be available, we'll have\r
				// an additional container for all toolbars.\r
				if ( editor.config.toolbarCanCollapse && editor.elementMode != CKEDITOR.ELEMENT_MODE_INLINE )\r
					output.push( '<span class="cke_toolbox_main"' + ( expanded ? '>' : ' style="display:none">' ) );\r
\r
				var toolbars = editor.toolbox.toolbars,\r
					toolbar = getToolbarConfig( editor );\r
\r
				for ( var r = 0; r < toolbar.length; r++ ) {\r
					var toolbarId,\r
						toolbarObj = 0,\r
						toolbarName,\r
						row = toolbar[ r ],\r
						items;\r
\r
					// It's better to check if the row object is really\r
					// available because it's a common mistake to leave\r
					// an extra comma in the toolbar definition\r
					// settings, which leads on the editor not loading\r
					// at all in IE. (#3983)\r
					if ( !row )\r
						continue;\r
\r
					if ( groupStarted ) {\r
						output.push( '</span>' );\r
						groupStarted = 0;\r
						pendingSeparator = 0;\r
					}\r
\r
					if ( row === '/' ) {\r
						output.push( '<span class="cke_toolbar_break"></span>' );\r
						continue;\r
					}\r
\r
					items = row.items || row;\r
\r
					// Create all items defined for this toolbar.\r
					for ( var i = 0; i < items.length; i++ ) {\r
						var item = items[ i ],\r
							canGroup;\r
\r
						if ( item ) {\r
							if ( item.type == CKEDITOR.UI_SEPARATOR ) {\r
								// Do not add the separator immediately. Just save\r
								// it be included if we already have something in\r
								// the toolbar and if a new item is to be added (later).\r
								pendingSeparator = groupStarted && item;\r
								continue;\r
							}\r
\r
							canGroup = item.canGroup !== false;\r
\r
							// Initialize the toolbar first, if needed.\r
							if ( !toolbarObj ) {\r
								// Create the basic toolbar object.\r
								toolbarId = CKEDITOR.tools.getNextId();\r
								toolbarObj = { id: toolbarId, items: [] };\r
								toolbarName = row.name && ( editor.lang.toolbar.toolbarGroups[ row.name ] || row.name );\r
\r
								// Output the toolbar opener.\r
								output.push( '<span id="', toolbarId, '" class="cke_toolbar"', ( toolbarName ? ' aria-labelledby="' + toolbarId + '_label"' : '' ), ' role="toolbar">' );\r
\r
								// If a toolbar name is available, send the voice label.\r
								toolbarName && output.push( '<span id="', toolbarId, '_label" class="cke_voice_label">', toolbarName, '</span>' );\r
\r
								output.push( '<span class="cke_toolbar_start"></span>' );\r
\r
								// Add the toolbar to the "editor.toolbox.toolbars"\r
								// array.\r
								var index = toolbars.push( toolbarObj ) - 1;\r
\r
								// Create the next/previous reference.\r
								if ( index > 0 ) {\r
									toolbarObj.previous = toolbars[ index - 1 ];\r
									toolbarObj.previous.next = toolbarObj;\r
								}\r
							}\r
\r
							if ( canGroup ) {\r
								if ( !groupStarted ) {\r
									output.push( '<span class="cke_toolgroup" role="presentation">' );\r
									groupStarted = 1;\r
								}\r
							} else if ( groupStarted ) {\r
								output.push( '</span>' );\r
								groupStarted = 0;\r
							}\r
\r
							function addItem( item ) { // jshint ignore:line\r
								var itemObj = item.render( editor, output );\r
								index = toolbarObj.items.push( itemObj ) - 1;\r
\r
								if ( index > 0 ) {\r
									itemObj.previous = toolbarObj.items[ index - 1 ];\r
									itemObj.previous.next = itemObj;\r
								}\r
\r
								itemObj.toolbar = toolbarObj;\r
								itemObj.onkey = itemKeystroke;\r
\r
								// Fix for #3052:\r
								// Prevent JAWS from focusing the toolbar after document load.\r
								itemObj.onfocus = function() {\r
									if ( !editor.toolbox.focusCommandExecuted )\r
										editor.focus();\r
								};\r
							}\r
\r
							if ( pendingSeparator ) {\r
								addItem( pendingSeparator );\r
								pendingSeparator = 0;\r
							}\r
\r
							addItem( item );\r
						}\r
					}\r
\r
					if ( groupStarted ) {\r
						output.push( '</span>' );\r
						groupStarted = 0;\r
						pendingSeparator = 0;\r
					}\r
\r
					if ( toolbarObj )\r
						output.push( '<span class="cke_toolbar_end"></span></span>' );\r
				}\r
\r
				if ( editor.config.toolbarCanCollapse )\r
					output.push( '</span>' );\r
\r
				// Not toolbar collapser for inline mode.\r
				if ( editor.config.toolbarCanCollapse && editor.elementMode != CKEDITOR.ELEMENT_MODE_INLINE ) {\r
					var collapserFn = CKEDITOR.tools.addFunction( function() {\r
						editor.execCommand( 'toolbarCollapse' );\r
					} );\r
\r
					editor.on( 'destroy', function() {\r
						CKEDITOR.tools.removeFunction( collapserFn );\r
					} );\r
\r
					editor.addCommand( 'toolbarCollapse', {\r
						readOnly: 1,\r
						exec: function( editor ) {\r
							var collapser = editor.ui.space( 'toolbar_collapser' ),\r
								toolbox = collapser.getPrevious(),\r
								contents = editor.ui.space( 'contents' ),\r
								toolboxContainer = toolbox.getParent(),\r
								contentHeight = parseInt( contents.$.style.height, 10 ),\r
								previousHeight = toolboxContainer.$.offsetHeight,\r
								minClass = 'cke_toolbox_collapser_min',\r
								collapsed = collapser.hasClass( minClass );\r
\r
							if ( !collapsed ) {\r
								toolbox.hide();\r
								collapser.addClass( minClass );\r
								collapser.setAttribute( 'title', editor.lang.toolbar.toolbarExpand );\r
							} else {\r
								toolbox.show();\r
								collapser.removeClass( minClass );\r
								collapser.setAttribute( 'title', editor.lang.toolbar.toolbarCollapse );\r
							}\r
\r
							// Update collapser symbol.\r
							collapser.getFirst().setText( collapsed ? '\u25B2' : // BLACK UP-POINTING TRIANGLE\r
							'\u25C0' ); // BLACK LEFT-POINTING TRIANGLE\r
\r
							var dy = toolboxContainer.$.offsetHeight - previousHeight;\r
							contents.setStyle( 'height', ( contentHeight - dy ) + 'px' );\r
\r
							editor.fire( 'resize', {\r
								outerHeight: editor.container.$.offsetHeight,\r
								contentsHeight: contents.$.offsetHeight,\r
								outerWidth: editor.container.$.offsetWidth\r
							} );\r
						},\r
\r
						modes: { wysiwyg: 1, source: 1 }\r
					} );\r
\r
					editor.setKeystroke( CKEDITOR.ALT + ( CKEDITOR.env.ie || CKEDITOR.env.webkit ? 189 : 109 ) /*-*/, 'toolbarCollapse' );\r
\r
					output.push( '<a title="' + ( expanded ? editor.lang.toolbar.toolbarCollapse : editor.lang.toolbar.toolbarExpand ) +\r
						'" id="' + editor.ui.spaceId( 'toolbar_collapser' ) +\r
						'" tabIndex="-1" class="cke_toolbox_collapser' );\r
\r
					if ( !expanded )\r
						output.push( ' cke_toolbox_collapser_min' );\r
\r
					output.push( '" onclick="CKEDITOR.tools.callFunction(' + collapserFn + ')">', '<span class="cke_arrow">&#9650;</span>', // BLACK UP-POINTING TRIANGLE\r
						'</a>' );\r
				}\r
\r
				output.push( '</span>' );\r
				event.data.html += output.join( '' );\r
			} );\r
\r
			editor.on( 'destroy', function() {\r
				if ( this.toolbox ) {\r
					var toolbars,\r
						index = 0,\r
						i, items, instance;\r
					toolbars = this.toolbox.toolbars;\r
					for ( ; index < toolbars.length; index++ ) {\r
						items = toolbars[ index ].items;\r
						for ( i = 0; i < items.length; i++ ) {\r
							instance = items[ i ];\r
							if ( instance.clickFn )\r
								CKEDITOR.tools.removeFunction( instance.clickFn );\r
							if ( instance.keyDownFn )\r
								CKEDITOR.tools.removeFunction( instance.keyDownFn );\r
						}\r
					}\r
				}\r
			} );\r
\r
			// Manage editor focus  when navigating the toolbar.\r
			editor.on( 'uiReady', function() {\r
				var toolbox = editor.ui.space( 'toolbox' );\r
				toolbox && editor.focusManager.add( toolbox, 1 );\r
			} );\r
\r
			editor.addCommand( 'toolbarFocus', commands.toolbarFocus );\r
			editor.setKeystroke( CKEDITOR.ALT + 121 /*F10*/, 'toolbarFocus' );\r
\r
			editor.ui.add( '-', CKEDITOR.UI_SEPARATOR, {} );\r
			editor.ui.addHandler( CKEDITOR.UI_SEPARATOR, {\r
				create: function() {\r
					return {\r
						render: function( editor, output ) {\r
							output.push( '<span class="cke_toolbar_separator" role="separator"></span>' );\r
							return {};\r
						}\r
					};\r
				}\r
			} );\r
		}\r
	} );\r
\r
	function getToolbarConfig( editor ) {\r
		var removeButtons = editor.config.removeButtons;\r
\r
		removeButtons = removeButtons && removeButtons.split( ',' );\r
\r
		function buildToolbarConfig() {\r
\r
			// Object containing all toolbar groups used by ui items.\r
			var lookup = getItemDefinedGroups();\r
\r
			// Take the base for the new toolbar, which is basically a toolbar\r
			// definition without items.\r
			var toolbar = CKEDITOR.tools.clone( editor.config.toolbarGroups ) || getPrivateToolbarGroups( editor );\r
\r
			// Fill the toolbar groups with the available ui items.\r
			for ( var i = 0; i < toolbar.length; i++ ) {\r
				var toolbarGroup = toolbar[ i ];\r
\r
				// Skip toolbar break.\r
				if ( toolbarGroup == '/' )\r
					continue;\r
				// Handle simply group name item.\r
				else if ( typeof toolbarGroup == 'string' )\r
					toolbarGroup = toolbar[ i ] = { name: toolbarGroup };\r
\r
				var items, subGroups = toolbarGroup.groups;\r
\r
				// Look for items that match sub groups.\r
				if ( subGroups ) {\r
					for ( var j = 0, sub; j < subGroups.length; j++ ) {\r
						sub = subGroups[ j ];\r
\r
						// If any ui item is registered for this subgroup.\r
						items = lookup[ sub ];\r
						items && fillGroup( toolbarGroup, items );\r
					}\r
				}\r
\r
				// Add the main group items as well.\r
				items = lookup[ toolbarGroup.name ];\r
				items && fillGroup( toolbarGroup, items );\r
			}\r
\r
			return toolbar;\r
		}\r
\r
		// Returns an object containing all toolbar groups used by ui items.\r
		function getItemDefinedGroups() {\r
			var groups = {},\r
				itemName, item, itemToolbar, group, order;\r
\r
			for ( itemName in editor.ui.items ) {\r
				item = editor.ui.items[ itemName ];\r
				itemToolbar = item.toolbar || 'others';\r
				if ( itemToolbar ) {\r
					// Break the toolbar property into its parts: "group_name[,order]".\r
					itemToolbar = itemToolbar.split( ',' );\r
					group = itemToolbar[ 0 ];\r
					order = parseInt( itemToolbar[ 1 ] || -1, 10 );\r
\r
					// Initialize the group, if necessary.\r
					groups[ group ] || ( groups[ group ] = [] );\r
\r
					// Push the data used to build the toolbar later.\r
					groups[ group ].push( { name: itemName, order: order } );\r
				}\r
			}\r
\r
			// Put the items in the right order.\r
			for ( group in groups ) {\r
				groups[ group ] = groups[ group ].sort( function( a, b ) {\r
					return a.order == b.order ? 0 :\r
						b.order < 0 ? -1 :\r
						a.order < 0 ? 1 :\r
						a.order < b.order ? -1 :\r
						1;\r
				} );\r
			}\r
\r
			return groups;\r
		}\r
\r
		function fillGroup( toolbarGroup, uiItems ) {\r
			if ( uiItems.length ) {\r
				if ( toolbarGroup.items )\r
					toolbarGroup.items.push( editor.ui.create( '-' ) );\r
				else\r
					toolbarGroup.items = [];\r
\r
				var item, name;\r
				while ( ( item = uiItems.shift() ) ) {\r
					name = typeof item == 'string' ? item : item.name;\r
\r
					// Ignore items that are configured to be removed.\r
					if ( !removeButtons || CKEDITOR.tools.indexOf( removeButtons, name ) == -1 ) {\r
						item = editor.ui.create( name );\r
\r
						if ( !item )\r
							continue;\r
\r
						if ( !editor.addFeature( item ) )\r
							continue;\r
\r
						toolbarGroup.items.push( item );\r
					}\r
				}\r
			}\r
		}\r
\r
		function populateToolbarConfig( config ) {\r
			var toolbar = [],\r
				i, group, newGroup;\r
\r
			for ( i = 0; i < config.length; ++i ) {\r
				group = config[ i ];\r
				newGroup = {};\r
\r
				if ( group == '/' )\r
					toolbar.push( group );\r
				else if ( CKEDITOR.tools.isArray( group ) ) {\r
					fillGroup( newGroup, CKEDITOR.tools.clone( group ) );\r
					toolbar.push( newGroup );\r
				}\r
				else if ( group.items ) {\r
					fillGroup( newGroup, CKEDITOR.tools.clone( group.items ) );\r
					newGroup.name = group.name;\r
					toolbar.push( newGroup );\r
				}\r
			}\r
\r
			return toolbar;\r
		}\r
\r
		var toolbar = editor.config.toolbar;\r
\r
		// If it is a string, return the relative "toolbar_name" config.\r
		if ( typeof toolbar == 'string' )\r
			toolbar = editor.config[ 'toolbar_' + toolbar ];\r
\r
		return ( editor.toolbar = toolbar ? populateToolbarConfig( toolbar ) : buildToolbarConfig() );\r
	}\r
\r
	/**\r
	 * Adds a toolbar group. See {@link CKEDITOR.config#toolbarGroups} for more details.\r
	 *\r
	 * **Note:** This method will not modify toolbar groups set explicitly by\r
	 * {@link CKEDITOR.config#toolbarGroups}. It will only extend the default setting.\r
	 *\r
	 * @param {String} name Toolbar group name.\r
	 * @param {Number/String} previous The name of the toolbar group after which this one\r
	 * should be added or `0` if this group should be the first one.\r
	 * @param {String} [subgroupOf] The name of the parent group.\r
	 * @member CKEDITOR.ui\r
	 */\r
	CKEDITOR.ui.prototype.addToolbarGroup = function( name, previous, subgroupOf ) {\r
		// The toolbarGroups from the privates is the one we gonna use for automatic toolbar creation.\r
		var toolbarGroups = getPrivateToolbarGroups( this.editor ),\r
			atStart = previous === 0,\r
			newGroup = { name: name };\r
\r
		if ( subgroupOf ) {\r
			// Transform the subgroupOf name in the real subgroup object.\r
			subgroupOf = CKEDITOR.tools.search( toolbarGroups, function( group ) {\r
				return group.name == subgroupOf;\r
			} );\r
\r
			if ( subgroupOf ) {\r
				!subgroupOf.groups && ( subgroupOf.groups = [] ) ;\r
\r
				if ( previous ) {\r
					// Search the "previous" item and add the new one after it.\r
					previous = CKEDITOR.tools.indexOf( subgroupOf.groups, previous );\r
					if ( previous >= 0 ) {\r
						subgroupOf.groups.splice( previous + 1, 0, name );\r
						return;\r
					}\r
				}\r
\r
				// If no previous found.\r
\r
				if ( atStart )\r
					subgroupOf.groups.splice( 0, 0, name );\r
				else\r
					subgroupOf.groups.push(  name );\r
				return;\r
			} else {\r
				// Ignore "previous" if subgroupOf has not been found.\r
				previous = null;\r
			}\r
		}\r
\r
		if ( previous ) {\r
			// Transform the "previous" name into its index.\r
			previous = CKEDITOR.tools.indexOf( toolbarGroups, function( group ) {\r
				return group.name == previous;\r
			} );\r
		}\r
\r
		if ( atStart )\r
			toolbarGroups.splice( 0, 0, name );\r
		else if ( typeof previous == 'number' )\r
			toolbarGroups.splice( previous + 1, 0, newGroup );\r
		else\r
			toolbarGroups.push( name );\r
	};\r
\r
	function getPrivateToolbarGroups( editor ) {\r
		return editor._.toolbarGroups || ( editor._.toolbarGroups = [\r
			{ name: 'document',    groups: [ 'mode', 'document', 'doctools' ] },\r
			{ name: 'clipboard',   groups: [ 'clipboard', 'undo' ] },\r
			{ name: 'editing',     groups: [ 'find', 'selection', 'spellchecker' ] },\r
			{ name: 'forms' },\r
			'/',\r
			{ name: 'basicstyles', groups: [ 'basicstyles', 'cleanup' ] },\r
			{ name: 'paragraph',   groups: [ 'list', 'indent', 'blocks', 'align', 'bidi' ] },\r
			{ name: 'links' },\r
			{ name: 'insert' },\r
			'/',\r
			{ name: 'styles' },\r
			{ name: 'colors' },\r
			{ name: 'tools' },\r
			{ name: 'others' },\r
			{ name: 'about' }\r
		] );\r
	}\r
} )();\r
\r
/**\r
 * Separator UI element.\r
 *\r
 * @readonly\r
 * @property {String} [='separator']\r
 * @member CKEDITOR\r
 */\r
CKEDITOR.UI_SEPARATOR = 'separator';\r
\r
/**\r
 * The part of the user interface where the toolbar will be rendered. For the default\r
 * editor implementation, the recommended options are `'top'` and `'bottom'`.\r
 *\r
 * Please note that this option is only applicable to [classic](#!/guide/dev_framed)\r
 * (`iframe`-based) editor. In case of [inline](#!/guide/dev_inline) editor the toolbar\r
 * position is set dynamically depending on the position of the editable element on the screen.\r
 *\r
 * Read more in the [documentation](#!/guide/dev_toolbarlocation)\r
 * and see the [SDK sample](http://sdk.ckeditor.com/samples/toolbarlocation.html).\r
 *\r
 *		config.toolbarLocation = 'bottom';\r
 *\r
 * @cfg\r
 * @member CKEDITOR.config\r
 */\r
CKEDITOR.config.toolbarLocation = 'top';\r
\r
/**\r
 * The toolbox (alias toolbar) definition. It is a toolbar name or an array of\r
 * toolbars (strips), each one being also an array, containing a list of UI items.\r
 *\r
 * If set to `null`, the toolbar will be generated automatically using all available buttons\r
 * and {@link #toolbarGroups} as a toolbar groups layout.\r
 *\r
 * In CKEditor 4.5+ you can generate your toolbar customization code by using the [visual\r
 * toolbar configurator](http://docs.ckeditor.com/#!/guide/dev_toolbar).\r
 *\r
 *		// Defines a toolbar with only one strip containing the "Source" button, a\r
 *		// separator, and the "Bold" and "Italic" buttons.\r
 *		config.toolbar = [\r
 *			[ 'Source', '-', 'Bold', 'Italic' ]\r
 *		];\r
 *\r
 *		// Similar to the example above, defines a "Basic" toolbar with only one strip containing three buttons.\r
 *		// Note that this setting is composed by "toolbar_" added to the toolbar name, which in this case is called "Basic".\r
 *		// This second part of the setting name can be anything. You must use this name in the CKEDITOR.config.toolbar setting\r
 *		// in order to instruct the editor which `toolbar_(name)` setting should be used.\r
 *		config.toolbar_Basic = [\r
 *			[ 'Source', '-', 'Bold', 'Italic' ]\r
 *		];\r
 *		// Load toolbar_Name where Name = Basic.\r
 *		config.toolbar = 'Basic';\r
 *\r
 * @cfg {Array/String} [toolbar=null]\r
 * @member CKEDITOR.config\r
 */\r
\r
/**\r
 * The toolbar groups definition.\r
 *\r
 * If the toolbar layout is not explicitly defined by the {@link #toolbar} setting, then\r
 * this setting is used to group all defined buttons (see {@link CKEDITOR.ui#addButton}).\r
 * Buttons are associated with toolbar groups by the `toolbar` property in their definition objects.\r
 *\r
 * New groups may be dynamically added during the editor and plugin initialization by\r
 * {@link CKEDITOR.ui#addToolbarGroup}. This is only possible if the default setting was used.\r
 *\r
 *		// Default setting.\r
 *		config.toolbarGroups = [\r
 *			{ name: 'document',	   groups: [ 'mode', 'document', 'doctools' ] },\r
 *			{ name: 'clipboard',   groups: [ 'clipboard', 'undo' ] },\r
 *			{ name: 'editing',     groups: [ 'find', 'selection', 'spellchecker' ] },\r
 *			{ name: 'forms' },\r
 *			'/',\r
 *			{ name: 'basicstyles', groups: [ 'basicstyles', 'cleanup' ] },\r
 *			{ name: 'paragraph',   groups: [ 'list', 'indent', 'blocks', 'align', 'bidi' ] },\r
 *			{ name: 'links' },\r
 *			{ name: 'insert' },\r
 *			'/',\r
 *			{ name: 'styles' },\r
 *			{ name: 'colors' },\r
 *			{ name: 'tools' },\r
 *			{ name: 'others' },\r
 *			{ name: 'about' }\r
 *		];\r
 *\r
 * @cfg {Array} [toolbarGroups=see example]\r
 * @member CKEDITOR.config\r
 */\r
\r
/**\r
 * Whether the toolbar can be collapsed by the user. If disabled, the Collapse Toolbar\r
 * button will not be displayed.\r
 *\r
 *		config.toolbarCanCollapse = true;\r
 *\r
 * @cfg {Boolean} [toolbarCanCollapse=false]\r
 * @member CKEDITOR.config\r
 */\r
\r
/**\r
 * Whether the toolbar must start expanded when the editor is loaded.\r
 *\r
 * Setting this option to `false` will affect the toolbar only when\r
 * {@link #toolbarCanCollapse} is set to `true`:\r
 *\r
 *		config.toolbarCanCollapse = true;\r
 *		config.toolbarStartupExpanded = false;\r
 *\r
 * @cfg {Boolean} [toolbarStartupExpanded=true]\r
 * @member CKEDITOR.config\r
 */\r
\r
/**\r
 * When enabled, causes the *Arrow* keys navigation to cycle within the current\r
 * toolbar group. Otherwise the *Arrow* keys will move through all items available in\r
 * the toolbar. The *Tab* key will still be used to quickly jump among the\r
 * toolbar groups.\r
 *\r
 *		config.toolbarGroupCycling = false;\r
 *\r
 * @since 3.6\r
 * @cfg {Boolean} [toolbarGroupCycling=true]\r
 * @member CKEDITOR.config\r
 */\r
\r
/**\r
 * List of toolbar button names that must not be rendered. This will also work\r
 * for non-button toolbar items, like the Font drop-down list.\r
 *\r
 *		config.removeButtons = 'Underline,JustifyCenter';\r
 *\r
 * This configuration option should not be overused. The recommended way is to use the\r
 * {@link CKEDITOR.config#removePlugins} setting to remove features from the editor\r
 * or even better, [create a custom editor build](http://ckeditor.com/builder) with\r
 * just the features that you will use.\r
 * In some cases though, a single plugin may define a set of toolbar buttons and\r
 * `removeButtons` may be useful when just a few of them are to be removed.\r
 *\r
 * @cfg {String} [removeButtons]\r
 * @member CKEDITOR.config\r
 */\r
\r
/**\r
 * The toolbar definition used by the editor. It is created from the\r
 * {@link CKEDITOR.config#toolbar} option if it is set or automatically\r
 * based on {@link CKEDITOR.config#toolbarGroups}.\r
 *\r
 * @readonly\r
 * @property {Object} toolbar\r
 * @member CKEDITOR.editor\r
 */\r