Update to 4.7.3

[perso/Immae/Projets/packagist/ludivine-ckeditor-component.git] / sources / plugins / removeformat / 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( 'removeformat', {\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,id,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
	icons: 'removeformat', // %REMOVE_LINE_CORE%\r
	hidpi: true, // %REMOVE_LINE_CORE%\r
	init: function( editor ) {\r
		editor.addCommand( 'removeFormat', CKEDITOR.plugins.removeformat.commands.removeformat );\r
		editor.ui.addButton && editor.ui.addButton( 'RemoveFormat', {\r
			label: editor.lang.removeformat.toolbar,\r
			command: 'removeFormat',\r
			toolbar: 'cleanup,10'\r
		} );\r
	}\r
} );\r
\r
CKEDITOR.plugins.removeformat = {\r
	commands: {\r
		removeformat: {\r
			exec: function( editor ) {\r
				var tagsRegex = editor._.removeFormatRegex || ( editor._.removeFormatRegex = new RegExp( '^(?:' + editor.config.removeFormatTags.replace( /,/g, '|' ) + ')$', 'i' ) );\r
\r
				var removeAttributes = editor._.removeAttributes || ( editor._.removeAttributes = editor.config.removeFormatAttributes.split( ',' ) ),\r
					filter = CKEDITOR.plugins.removeformat.filter,\r
					ranges = editor.getSelection().getRanges(),\r
					iterator = ranges.createIterator(),\r
					isElement = function( element ) {\r
						return element.type == CKEDITOR.NODE_ELEMENT;\r
					},\r
					range;\r
\r
				while ( ( range = iterator.getNextRange() ) ) {\r
					if ( !range.collapsed )\r
						range.enlarge( CKEDITOR.ENLARGE_ELEMENT );\r
\r
					// Bookmark the range so we can re-select it after processing.\r
					var bookmark = range.createBookmark(),\r
						// The style will be applied within the bookmark boundaries.\r
						startNode = bookmark.startNode,\r
						endNode = bookmark.endNode,\r
						currentNode;\r
\r
					// We need to check the selection boundaries (bookmark spans) to break\r
					// the code in a way that we can properly remove partially selected nodes.\r
					// For example, removing a <b> style from\r
					//		<b>This is [some text</b> to show <b>the] problem</b>\r
					// ... where [ and ] represent the selection, must result:\r
					//		<b>This is </b>[some text to show the]<b> problem</b>\r
					// The strategy is simple, we just break the partial nodes before the\r
					// removal logic, having something that could be represented this way:\r
					//		<b>This is </b>[<b>some text</b> to show <b>the</b>]<b> problem</b>\r
\r
					var breakParent = function( node ) {\r
							// Let's start checking the start boundary.\r
							var path = editor.elementPath( node ),\r
								pathElements = path.elements;\r
\r
							for ( var i = 1, pathElement; pathElement = pathElements[ i ]; i++ ) {\r
								if ( pathElement.equals( path.block ) || pathElement.equals( path.blockLimit ) )\r
									break;\r
\r
								// If this element can be removed (even partially).\r
								if ( tagsRegex.test( pathElement.getName() ) && filter( editor, pathElement ) )\r
									node.breakParent( pathElement );\r
							}\r
						};\r
\r
					breakParent( startNode );\r
					if ( endNode ) {\r
						breakParent( endNode );\r
\r
						// Navigate through all nodes between the bookmarks.\r
						currentNode = startNode.getNextSourceNode( true, CKEDITOR.NODE_ELEMENT );\r
\r
						while ( currentNode ) {\r
							// If we have reached the end of the selection, stop looping.\r
							if ( currentNode.equals( endNode ) )\r
								break;\r
\r
							if ( currentNode.isReadOnly() ) {\r
								// In case of non-editable we're skipping to the next sibling *elmenet*.\r
\r
								// We need to be aware that endNode can be nested within current non-editable.\r
								// This condition tests if currentNode (non-editable) contains endNode. If it does\r
								// then we should break the filtering\r
								if ( currentNode.getPosition( endNode ) & CKEDITOR.POSITION_CONTAINS ) {\r
									break;\r
								}\r
\r
								currentNode = currentNode.getNext( isElement );\r
								continue;\r
							}\r
\r
							// Cache the next node to be processed. Do it now, because\r
							// currentNode may be removed.\r
							var nextNode = currentNode.getNextSourceNode( false, CKEDITOR.NODE_ELEMENT ),\r
								isFakeElement = currentNode.getName() == 'img' && currentNode.data( 'cke-realelement' );\r
\r
							// This node must not be a fake element, and must not be read-only.\r
							if ( !isFakeElement && filter( editor, currentNode ) ) {\r
								// Remove elements nodes that match with this style rules.\r
								if ( tagsRegex.test( currentNode.getName() ) )\r
									currentNode.remove( 1 );\r
								else {\r
									currentNode.removeAttributes( removeAttributes );\r
									editor.fire( 'removeFormatCleanup', currentNode );\r
								}\r
							}\r
\r
							currentNode = nextNode;\r
						}\r
					}\r
\r
					range.moveToBookmark( bookmark );\r
				}\r
\r
				// The selection path may not changed, but we should force a selection\r
				// change event to refresh command states, due to the above attribution change. (http://dev.ckeditor.com/ticket/9238)\r
				editor.forceNextSelectionCheck();\r
				editor.getSelection().selectRanges( ranges );\r
			}\r
		}\r
	},\r
\r
	// Perform the remove format filters on the passed element.\r
	// @param {CKEDITOR.editor} editor\r
	// @param {CKEDITOR.dom.element} element\r
	filter: function( editor, element ) {\r
		// If editor#addRemoveFotmatFilter hasn't been executed yet value is not initialized.\r
		var filters = editor._.removeFormatFilters || [];\r
		for ( var i = 0; i < filters.length; i++ ) {\r
			if ( filters[ i ]( element ) === false )\r
				return false;\r
		}\r
		return true;\r
	}\r
};\r
\r
/**\r
 * Add to a collection of functions to decide whether a specific\r
 * element should be considered as formatting element and thus\r
 * could be removed during `removeFormat` command.\r
 *\r
 * **Note:** Only available with the existence of `removeformat` plugin.\r
 *\r
 *		// Don't remove empty span.\r
 *		editor.addRemoveFormatFilter( function( element ) {\r
 *			return !( element.is( 'span' ) && CKEDITOR.tools.isEmpty( element.getAttributes() ) );\r
 *		} );\r
 *\r
 * @since 3.3\r
 * @member CKEDITOR.editor\r
 * @param {Function} func The function to be called, which will be passed a {CKEDITOR.dom.element} element to test.\r
 */\r
CKEDITOR.editor.prototype.addRemoveFormatFilter = function( func ) {\r
	if ( !this._.removeFormatFilters )\r
		this._.removeFormatFilters = [];\r
\r
	this._.removeFormatFilters.push( func );\r
};\r
\r
/**\r
 * A comma separated list of elements to be removed when executing the `remove\r
 * format` command. Note that only inline elements are allowed.\r
 *\r
 * @cfg\r
 * @member CKEDITOR.config\r
 */\r
CKEDITOR.config.removeFormatTags = 'b,big,cite,code,del,dfn,em,font,i,ins,kbd,q,s,samp,small,span,strike,strong,sub,sup,tt,u,var';\r
\r
/**\r
 * A comma separated list of elements attributes to be removed when executing\r
 * the `remove format` command.\r
 *\r
 * @cfg\r
 * @member CKEDITOR.config\r
 */\r
CKEDITOR.config.removeFormatAttributes = 'class,style,lang,width,height,align,hspace,valign';\r
\r
/**\r
 * Fired after an element was cleaned by the removeFormat plugin.\r
 *\r
 * @event removeFormatCleanup\r
 * @member CKEDITOR.editor\r
 * @param {CKEDITOR.editor} editor This editor instance.\r
 * @param data\r
 * @param {CKEDITOR.dom.element} data.element The element that was cleaned up.\r
 */\r