Update to 4.7.3

[perso/Immae/Projets/packagist/ludivine-ckeditor-component.git] / sources / plugins / elementspath / 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
/**\r
 * @fileOverview The "elementspath" plugin. It shows all elements in the DOM\r
 *		parent tree relative to the current selection in the editing area.\r
 */\r
\r
( function() {\r
	var commands = {\r
		toolbarFocus: {\r
			editorFocus: false,\r
			readOnly: 1,\r
			exec: function( editor ) {\r
				var idBase = editor._.elementsPath.idBase;\r
				var element = CKEDITOR.document.getById( idBase + '0' );\r
\r
				// Make the first button focus accessible for IE. (http://dev.ckeditor.com/ticket/3417)\r
				// Adobe AIR instead need while of delay.\r
				element && element.focus( CKEDITOR.env.ie || CKEDITOR.env.air );\r
			}\r
		}\r
	};\r
\r
	var emptyHtml = '<span class="cke_path_empty">&nbsp;</span>';\r
\r
	var extra = '';\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
		extra += ' 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
		extra += ' onblur="this.style.cssText = this.style.cssText;"';\r
\r
	var pathItemTpl = CKEDITOR.addTemplate( 'pathItem', '<a' +\r
		' id="{id}"' +\r
		' href="{jsTitle}"' +\r
		' tabindex="-1"' +\r
		' class="cke_path_item"' +\r
		' title="{label}"' +\r
		extra +\r
		' hidefocus="true" ' +\r
		' onkeydown="return CKEDITOR.tools.callFunction({keyDownFn},{index}, event );"' +\r
		' onclick="CKEDITOR.tools.callFunction({clickFn},{index}); return false;"' +\r
		' role="button" aria-label="{label}">' +\r
		'{text}' +\r
		'</a>' );\r
\r
	CKEDITOR.plugins.add( 'elementspath', {\r
		// jscs:disable maximumLineLength\r
		lang: 'af,ar,az,bg,bn,bs,ca,cs,cy,da,de,de-ch,el,en,en-au,en-ca,en-gb,eo,es,es-mx,et,eu,fa,fi,fo,fr,fr-ca,gl,gu,he,hi,hr,hu,is,it,ja,ka,km,ko,ku,lt,lv,mk,mn,ms,nb,nl,no,oc,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
		init: function( editor ) {\r
			editor._.elementsPath = {\r
				idBase: 'cke_elementspath_' + CKEDITOR.tools.getNextNumber() + '_',\r
				filters: []\r
			};\r
\r
			editor.on( 'uiSpace', function( event ) {\r
				if ( event.data.space == 'bottom' )\r
					initElementsPath( editor, event.data );\r
			} );\r
		}\r
	} );\r
\r
	function initElementsPath( editor, bottomSpaceData ) {\r
		var spaceId = editor.ui.spaceId( 'path' ),\r
			spaceElement,\r
			getSpaceElement = function() {\r
				if ( !spaceElement )\r
					spaceElement = CKEDITOR.document.getById( spaceId );\r
				return spaceElement;\r
			},\r
			elementsPath = editor._.elementsPath,\r
			idBase = elementsPath.idBase;\r
\r
		bottomSpaceData.html += '<span id="' + spaceId + '_label" class="cke_voice_label">' + editor.lang.elementspath.eleLabel + '</span>' +\r
			'<span id="' + spaceId + '" class="cke_path" role="group" aria-labelledby="' + spaceId + '_label">' + emptyHtml + '</span>';\r
\r
		// Register the ui element to the focus manager.\r
		editor.on( 'uiReady', function() {\r
			var element = editor.ui.space( 'path' );\r
			element && editor.focusManager.add( element, 1 );\r
		} );\r
\r
		function onClick( elementIndex ) {\r
			var element = elementsPath.list[ elementIndex ],\r
				selection;\r
\r
			if ( element.equals( editor.editable() ) || element.getAttribute( 'contenteditable' ) == 'true' ) {\r
				var range = editor.createRange();\r
				range.selectNodeContents( element );\r
\r
				selection = range.select();\r
			} else {\r
				selection = editor.getSelection();\r
				selection.selectElement( element );\r
			}\r
\r
			// Explicitly fire selectionChange when clicking on an element path button. (http://dev.ckeditor.com/ticket/13548)\r
			if ( CKEDITOR.env.ie ) {\r
				editor.fire( 'selectionChange', { selection: selection, path: new CKEDITOR.dom.elementPath( element ) } );\r
			}\r
\r
			// It is important to focus() *after* the above selection\r
			// manipulation, otherwise Firefox will have troubles. http://dev.ckeditor.com/ticket/10119\r
			editor.focus();\r
		}\r
\r
		elementsPath.onClick = onClick;\r
\r
		var onClickHanlder = CKEDITOR.tools.addFunction( onClick ),\r
			onKeyDownHandler = CKEDITOR.tools.addFunction( function( elementIndex, ev ) {\r
				var idBase = elementsPath.idBase,\r
					element;\r
\r
				ev = new CKEDITOR.dom.event( ev );\r
\r
				var rtl = editor.lang.dir == 'rtl';\r
				switch ( ev.getKeystroke() ) {\r
					case rtl ? 39 : 37: // LEFT-ARROW\r
					case 9: // TAB\r
						element = CKEDITOR.document.getById( idBase + ( elementIndex + 1 ) );\r
						if ( !element )\r
							element = CKEDITOR.document.getById( idBase + '0' );\r
						element.focus();\r
						return false;\r
\r
					case rtl ? 37 : 39: // RIGHT-ARROW\r
					case CKEDITOR.SHIFT + 9: // SHIFT + TAB\r
						element = CKEDITOR.document.getById( idBase + ( elementIndex - 1 ) );\r
						if ( !element )\r
							element = CKEDITOR.document.getById( idBase + ( elementsPath.list.length - 1 ) );\r
						element.focus();\r
						return false;\r
\r
					case 27: // ESC\r
						editor.focus();\r
						return false;\r
\r
					case 13: // ENTER	// Opera\r
					case 32: // SPACE\r
						onClick( elementIndex );\r
						return false;\r
				}\r
				return true;\r
			} );\r
\r
		editor.on( 'selectionChange', function() {\r
			var html = [],\r
				elementsList = elementsPath.list = [],\r
				namesList = [],\r
				filters = elementsPath.filters,\r
				isContentEditable = true,\r
\r
				// Use elementPath to consider children of editable only (http://dev.ckeditor.com/ticket/11124).\r
				elementsChain = editor.elementPath().elements,\r
				name;\r
\r
			// Starts iteration from body element, skipping html.\r
			for ( var j = elementsChain.length; j--; ) {\r
				var element = elementsChain[ j ],\r
					ignore = 0;\r
\r
				if ( element.data( 'cke-display-name' ) )\r
					name = element.data( 'cke-display-name' );\r
				else if ( element.data( 'cke-real-element-type' ) )\r
					name = element.data( 'cke-real-element-type' );\r
				else\r
					name = element.getName();\r
\r
				isContentEditable = element.hasAttribute( 'contenteditable' ) ?\r
					element.getAttribute( 'contenteditable' ) == 'true' : isContentEditable;\r
\r
				// If elem is non-contenteditable, and it's not specifying contenteditable\r
				// attribute - then elem should be ignored.\r
				if ( !isContentEditable && !element.hasAttribute( 'contenteditable' ) )\r
					ignore = 1;\r
\r
				for ( var i = 0; i < filters.length; i++ ) {\r
					var ret = filters[ i ]( element, name );\r
					if ( ret === false ) {\r
						ignore = 1;\r
						break;\r
					}\r
					name = ret || name;\r
				}\r
\r
				if ( !ignore ) {\r
					elementsList.unshift( element );\r
					namesList.unshift( name );\r
				}\r
			}\r
\r
			for ( var iterationLimit = elementsList.length, index = 0; index < iterationLimit; index++ ) {\r
				name = namesList[ index ];\r
				var label = editor.lang.elementspath.eleTitle.replace( /%1/, name ),\r
					item = pathItemTpl.output( {\r
						id: idBase + index,\r
						label: label,\r
						text: name,\r
						jsTitle: 'javascript:void(\'' + name + '\')', // jshint ignore:line\r
						index: index,\r
						keyDownFn: onKeyDownHandler,\r
						clickFn: onClickHanlder\r
					} );\r
\r
				html.unshift( item );\r
			}\r
\r
			var space = getSpaceElement();\r
			space.setHtml( html.join( '' ) + emptyHtml );\r
			editor.fire( 'elementsPathUpdate', { space: space } );\r
		} );\r
\r
		function empty() {\r
			spaceElement && spaceElement.setHtml( emptyHtml );\r
			delete elementsPath.list;\r
		}\r
\r
		editor.on( 'readOnly', empty );\r
		editor.on( 'contentDomUnload', empty );\r
\r
		editor.addCommand( 'elementsPathFocus', commands.toolbarFocus );\r
		editor.setKeystroke( CKEDITOR.ALT + 122 /*F11*/, 'elementsPathFocus' );\r
	}\r
} )();\r
\r
/**\r
 * Fired when the contents of the elementsPath are changed.\r
 *\r
 * @event elementsPathUpdate\r
 * @member CKEDITOR.editor\r
 * @param {CKEDITOR.editor} editor This editor instance.\r
 * @param data\r
 * @param {CKEDITOR.dom.element} data.space The elementsPath container.\r
 */\r