Validation initiale

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

/**\r
 * @license Copyright (c) 2003-2017, CKSource - Frederico Knabben. All rights reserved.\r
 * For licensing, see LICENSE.md or http://ckeditor.com/license\r
 */\r
\r
CKEDITOR.plugins.add( 'richcombo', {\r
	requires: 'floatpanel,listblock,button',\r
\r
	beforeInit: function( editor ) {\r
		editor.ui.addHandler( CKEDITOR.UI_RICHCOMBO, CKEDITOR.ui.richCombo.handler );\r
	}\r
} );\r
\r
( function() {\r
	var template = '<span id="{id}"' +\r
		' class="cke_combo cke_combo__{name} {cls}"' +\r
		' role="presentation">' +\r
			'<span id="{id}_label" class="cke_combo_label">{label}</span>' +\r
			'<a class="cke_combo_button" title="{title}" tabindex="-1"' +\r
			( CKEDITOR.env.gecko && !CKEDITOR.env.hc ? '' : ' href="javascript:void(\'{titleJs}\')"' ) +\r
			' hidefocus="true"' +\r
			' role="button"' +\r
			' aria-labelledby="{id}_label"' +\r
			' aria-haspopup="true"';\r
\r
	// Some browsers don't cancel key events in the keydown but in the\r
	// keypress.\r
	// TODO: Check if really needed.\r
	if ( CKEDITOR.env.gecko && CKEDITOR.env.mac )\r
		template += ' onkeypress="return false;"';\r
\r
	// With Firefox, we need to force the button to redraw, otherwise it\r
	// will remain in the focus state.\r
	if ( CKEDITOR.env.gecko )\r
		template += ' onblur="this.style.cssText = this.style.cssText;"';\r
\r
	template +=\r
		' onkeydown="return CKEDITOR.tools.callFunction({keydownFn},event,this);"' +\r
		' onfocus="return CKEDITOR.tools.callFunction({focusFn},event);" ' +\r
			( CKEDITOR.env.ie ? 'onclick="return false;" onmouseup' : 'onclick' ) + // #188\r
				'="CKEDITOR.tools.callFunction({clickFn},this);return false;">' +\r
			'<span id="{id}_text" class="cke_combo_text cke_combo_inlinelabel">{label}</span>' +\r
			'<span class="cke_combo_open">' +\r
				'<span class="cke_combo_arrow">' +\r
				// BLACK DOWN-POINTING TRIANGLE\r
	( CKEDITOR.env.hc ? '&#9660;' : CKEDITOR.env.air ? '&nbsp;' : '' ) +\r
				'</span>' +\r
			'</span>' +\r
		'</a>' +\r
		'</span>';\r
\r
	var rcomboTpl = CKEDITOR.addTemplate( 'combo', template );\r
\r
	/**\r
	 * Button UI element.\r
	 *\r
	 * @readonly\r
	 * @property {String} [='richcombo']\r
	 * @member CKEDITOR\r
	 */\r
	CKEDITOR.UI_RICHCOMBO = 'richcombo';\r
\r
	/**\r
	 * @class\r
	 * @todo\r
	 */\r
	CKEDITOR.ui.richCombo = CKEDITOR.tools.createClass( {\r
		$: function( definition ) {\r
			// Copy all definition properties to this object.\r
			CKEDITOR.tools.extend( this, definition,\r
			// Set defaults.\r
			{\r
				// The combo won't participate in toolbar grouping.\r
				canGroup: false,\r
				title: definition.label,\r
				modes: { wysiwyg: 1 },\r
				editorFocus: 1\r
			} );\r
\r
			// We don't want the panel definition in this object.\r
			var panelDefinition = this.panel || {};\r
			delete this.panel;\r
\r
			this.id = CKEDITOR.tools.getNextNumber();\r
\r
			this.document = ( panelDefinition.parent && panelDefinition.parent.getDocument() ) || CKEDITOR.document;\r
\r
			panelDefinition.className = 'cke_combopanel';\r
			panelDefinition.block = {\r
				multiSelect: panelDefinition.multiSelect,\r
				attributes: panelDefinition.attributes\r
			};\r
			panelDefinition.toolbarRelated = true;\r
\r
			this._ = {\r
				panelDefinition: panelDefinition,\r
				items: {}\r
			};\r
		},\r
\r
		proto: {\r
			renderHtml: function( editor ) {\r
				var output = [];\r
				this.render( editor, output );\r
				return output.join( '' );\r
			},\r
\r
			/**\r
			 * Renders the combo.\r
			 *\r
			 * @param {CKEDITOR.editor} editor The editor instance which this button is\r
			 * to be used by.\r
			 * @param {Array} output The output array to which append the HTML relative\r
			 * to this button.\r
			 */\r
			render: function( editor, output ) {\r
				var env = CKEDITOR.env;\r
\r
				var id = 'cke_' + this.id;\r
				var clickFn = CKEDITOR.tools.addFunction( function( el ) {\r
					// Restore locked selection in Opera.\r
					if ( selLocked ) {\r
						editor.unlockSelection( 1 );\r
						selLocked = 0;\r
					}\r
					instance.execute( el );\r
				}, this );\r
\r
				var combo = this;\r
				var instance = {\r
					id: id,\r
					combo: this,\r
					focus: function() {\r
						var element = CKEDITOR.document.getById( id ).getChild( 1 );\r
						element.focus();\r
					},\r
					execute: function( el ) {\r
						var _ = combo._;\r
\r
						if ( _.state == CKEDITOR.TRISTATE_DISABLED )\r
							return;\r
\r
						combo.createPanel( editor );\r
\r
						if ( _.on ) {\r
							_.panel.hide();\r
							return;\r
						}\r
\r
						combo.commit();\r
						var value = combo.getValue();\r
						if ( value )\r
							_.list.mark( value );\r
						else\r
							_.list.unmarkAll();\r
\r
						_.panel.showBlock( combo.id, new CKEDITOR.dom.element( el ), 4 );\r
					},\r
					clickFn: clickFn\r
				};\r
\r
				function updateState() {\r
					// Don't change state while richcombo is active (#11793).\r
					if ( this.getState() == CKEDITOR.TRISTATE_ON )\r
						return;\r
\r
					var state = this.modes[ editor.mode ] ? CKEDITOR.TRISTATE_OFF : CKEDITOR.TRISTATE_DISABLED;\r
\r
					if ( editor.readOnly && !this.readOnly )\r
						state = CKEDITOR.TRISTATE_DISABLED;\r
\r
					this.setState( state );\r
					this.setValue( '' );\r
\r
					// Let plugin to disable button.\r
					if ( state != CKEDITOR.TRISTATE_DISABLED && this.refresh )\r
						this.refresh();\r
				}\r
\r
				// Update status when activeFilter, mode, selection or readOnly changes.\r
				editor.on( 'activeFilterChange', updateState, this );\r
				editor.on( 'mode', updateState, this );\r
				editor.on( 'selectionChange', updateState, this );\r
				// If this combo is sensitive to readOnly state, update it accordingly.\r
				!this.readOnly && editor.on( 'readOnly', updateState, this );\r
\r
				var keyDownFn = CKEDITOR.tools.addFunction( function( ev, element ) {\r
					ev = new CKEDITOR.dom.event( ev );\r
\r
					var keystroke = ev.getKeystroke();\r
\r
					// ARROW-DOWN\r
					// This call is duplicated in plugins/toolbar/plugin.js in itemKeystroke().\r
					// Move focus to the first element after drop down was opened by the arrow down key.\r
					if ( keystroke == 40 ) {\r
						editor.once( 'panelShow', function( evt ) {\r
							evt.data._.panel._.currentBlock.onKeyDown( 40 );\r
						} );\r
					}\r
\r
					switch ( keystroke ) {\r
						case 13: // ENTER\r
						case 32: // SPACE\r
						case 40: // ARROW-DOWN\r
							// Show panel\r
							CKEDITOR.tools.callFunction( clickFn, element );\r
							break;\r
						default:\r
							// Delegate the default behavior to toolbar button key handling.\r
							instance.onkey( instance, keystroke );\r
					}\r
\r
					// Avoid subsequent focus grab on editor document.\r
					ev.preventDefault();\r
				} );\r
\r
				var focusFn = CKEDITOR.tools.addFunction( function() {\r
					instance.onfocus && instance.onfocus();\r
				} );\r
\r
				var selLocked = 0;\r
\r
				// For clean up\r
				instance.keyDownFn = keyDownFn;\r
\r
				var params = {\r
					id: id,\r
					name: this.name || this.command,\r
					label: this.label,\r
					title: this.title,\r
					cls: this.className || '',\r
					titleJs: env.gecko && !env.hc ? '' : ( this.title || '' ).replace( "'", '' ),\r
					keydownFn: keyDownFn,\r
					focusFn: focusFn,\r
					clickFn: clickFn\r
				};\r
\r
				rcomboTpl.output( params, output );\r
\r
				if ( this.onRender )\r
					this.onRender();\r
\r
				return instance;\r
			},\r
\r
			createPanel: function( editor ) {\r
				if ( this._.panel )\r
					return;\r
\r
				var panelDefinition = this._.panelDefinition,\r
					panelBlockDefinition = this._.panelDefinition.block,\r
					panelParentElement = panelDefinition.parent || CKEDITOR.document.getBody(),\r
					namedPanelCls = 'cke_combopanel__' + this.name,\r
					panel = new CKEDITOR.ui.floatPanel( editor, panelParentElement, panelDefinition ),\r
					list = panel.addListBlock( this.id, panelBlockDefinition ),\r
					me = this;\r
\r
				panel.onShow = function() {\r
					this.element.addClass( namedPanelCls );\r
\r
					me.setState( CKEDITOR.TRISTATE_ON );\r
\r
					me._.on = 1;\r
\r
					me.editorFocus && !editor.focusManager.hasFocus && editor.focus();\r
\r
					if ( me.onOpen )\r
						me.onOpen();\r
\r
					// The "panelShow" event is fired assinchronously, after the\r
					// onShow method call.\r
					editor.once( 'panelShow', function() {\r
						list.focus( !list.multiSelect && me.getValue() );\r
					} );\r
				};\r
\r
				panel.onHide = function( preventOnClose ) {\r
					this.element.removeClass( namedPanelCls );\r
\r
					me.setState( me.modes && me.modes[ editor.mode ] ? CKEDITOR.TRISTATE_OFF : CKEDITOR.TRISTATE_DISABLED );\r
\r
					me._.on = 0;\r
\r
					if ( !preventOnClose && me.onClose )\r
						me.onClose();\r
				};\r
\r
				panel.onEscape = function() {\r
					// Hide drop-down with focus returned.\r
					panel.hide( 1 );\r
				};\r
\r
				list.onClick = function( value, marked ) {\r
\r
					if ( me.onClick )\r
						me.onClick.call( me, value, marked );\r
\r
					panel.hide();\r
				};\r
\r
				this._.panel = panel;\r
				this._.list = list;\r
\r
				panel.getBlock( this.id ).onHide = function() {\r
					me._.on = 0;\r
					me.setState( CKEDITOR.TRISTATE_OFF );\r
				};\r
\r
				if ( this.init )\r
					this.init();\r
			},\r
\r
			setValue: function( value, text ) {\r
				this._.value = value;\r
\r
				var textElement = this.document.getById( 'cke_' + this.id + '_text' );\r
				if ( textElement ) {\r
					if ( !( value || text ) ) {\r
						text = this.label;\r
						textElement.addClass( 'cke_combo_inlinelabel' );\r
					} else {\r
						textElement.removeClass( 'cke_combo_inlinelabel' );\r
					}\r
\r
					textElement.setText( typeof text != 'undefined' ? text : value );\r
				}\r
			},\r
\r
			getValue: function() {\r
				return this._.value || '';\r
			},\r
\r
			unmarkAll: function() {\r
				this._.list.unmarkAll();\r
			},\r
\r
			mark: function( value ) {\r
				this._.list.mark( value );\r
			},\r
\r
			hideItem: function( value ) {\r
				this._.list.hideItem( value );\r
			},\r
\r
			hideGroup: function( groupTitle ) {\r
				this._.list.hideGroup( groupTitle );\r
			},\r
\r
			showAll: function() {\r
				this._.list.showAll();\r
			},\r
\r
			add: function( value, html, text ) {\r
				this._.items[ value ] = text || value;\r
				this._.list.add( value, html, text );\r
			},\r
\r
			startGroup: function( title ) {\r
				this._.list.startGroup( title );\r
			},\r
\r
			commit: function() {\r
				if ( !this._.committed ) {\r
					this._.list.commit();\r
					this._.committed = 1;\r
					CKEDITOR.ui.fire( 'ready', this );\r
				}\r
				this._.committed = 1;\r
			},\r
\r
			setState: function( state ) {\r
				if ( this._.state == state )\r
					return;\r
\r
				var el = this.document.getById( 'cke_' + this.id );\r
				el.setState( state, 'cke_combo' );\r
\r
				state == CKEDITOR.TRISTATE_DISABLED ?\r
					el.setAttribute( 'aria-disabled', true ) :\r
					el.removeAttribute( 'aria-disabled' );\r
\r
				this._.state = state;\r
			},\r
\r
			getState: function() {\r
				return this._.state;\r
			},\r
\r
			enable: function() {\r
				if ( this._.state == CKEDITOR.TRISTATE_DISABLED )\r
					this.setState( this._.lastState );\r
			},\r
\r
			disable: function() {\r
				if ( this._.state != CKEDITOR.TRISTATE_DISABLED ) {\r
					this._.lastState = this._.state;\r
					this.setState( CKEDITOR.TRISTATE_DISABLED );\r
				}\r
			}\r
		},\r
\r
		/**\r
		 * Represents richCombo handler object.\r
		 *\r
		 * @class CKEDITOR.ui.richCombo.handler\r
		 * @singleton\r
		 * @extends CKEDITOR.ui.handlerDefinition\r
		 */\r
		statics: {\r
			handler: {\r
				/**\r
				 * Transforms a richCombo definition in a {@link CKEDITOR.ui.richCombo} instance.\r
				 *\r
				 * @param {Object} definition\r
				 * @returns {CKEDITOR.ui.richCombo}\r
				 */\r
				create: function( definition ) {\r
					return new CKEDITOR.ui.richCombo( definition );\r
				}\r
			}\r
		}\r
	} );\r
\r
	/**\r
	 * @param {String} name\r
	 * @param {Object} definition\r
	 * @member CKEDITOR.ui\r
	 * @todo\r
	 */\r
	CKEDITOR.ui.prototype.addRichCombo = function( name, definition ) {\r
		this.add( name, CKEDITOR.UI_RICHCOMBO, definition );\r
	};\r
\r
} )();\r