--- /dev/null
+/*\r
+Copyright (c) 2003-2011, CKSource - Frederico Knabben. All rights reserved.\r
+For licensing, see LICENSE.html or http://ckeditor.com/license\r
+*/\r
+\r
+CKEDITOR.plugins.add( 'removeformat',\r
+{\r
+ requires : [ 'selection' ],\r
+\r
+ init : function( editor )\r
+ {\r
+ editor.addCommand( 'removeFormat', CKEDITOR.plugins.removeformat.commands.removeformat );\r
+ editor.ui.addButton( 'RemoveFormat',\r
+ {\r
+ label : editor.lang.removeFormat,\r
+ command : 'removeFormat'\r
+ });\r
+\r
+ editor._.removeFormat = { filters: [] };\r
+ }\r
+});\r
+\r
+CKEDITOR.plugins.removeformat =\r
+{\r
+ commands :\r
+ {\r
+ removeformat :\r
+ {\r
+ exec : function( editor )\r
+ {\r
+ var tagsRegex = editor._.removeFormatRegex ||\r
+ ( editor._.removeFormatRegex = new RegExp( '^(?:' + editor.config.removeFormatTags.replace( /,/g,'|' ) + ')$', 'i' ) );\r
+\r
+ var removeAttributes = editor._.removeAttributes ||\r
+ ( editor._.removeAttributes = editor.config.removeFormatAttributes.split( ',' ) );\r
+\r
+ var filter = CKEDITOR.plugins.removeformat.filter;\r
+ var ranges = editor.getSelection().getRanges( 1 ),\r
+ iterator = ranges.createIterator(),\r
+ range;\r
+\r
+ while ( ( range = iterator.getNextRange() ) )\r
+ {\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
+ {\r
+ // Let's start checking the start boundary.\r
+ var path = new CKEDITOR.dom.elementPath( node ),\r
+ pathElements = path.elements;\r
+\r
+ for ( var i = 1, pathElement ; pathElement = pathElements[ i ] ; i++ )\r
+ {\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
+ {\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
+ {\r
+ // If we have reached the end of the selection, stop looping.\r
+ if ( currentNode.equals( endNode ) )\r
+ break;\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
+\r
+ // This node must not be a fake element.\r
+ if ( !( currentNode.getName() == 'img'\r
+ && currentNode.data( 'cke-realelement' ) )\r
+ && filter( editor, currentNode ) )\r
+ {\r
+ // Remove elements nodes that match with this style rules.\r
+ if ( tagsRegex.test( currentNode.getName() ) )\r
+ currentNode.remove( 1 );\r
+ else\r
+ {\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
+ editor.getSelection().selectRanges( ranges );\r
+ }\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
+ */\r
+ filter : function ( editor, element )\r
+ {\r
+ var filters = editor._.removeFormat.filters;\r
+ for ( var i = 0; i < filters.length; i++ )\r
+ {\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 <b>removeFormat</b> command,\r
+ * Note: Only available with the existence of 'removeformat' plugin.\r
+ * @since 3.3\r
+ * @param {Function} func The function to be called, which will be passed a {CKEDITOR.dom.element} element to test.\r
+ * @example\r
+ * // Don't remove empty span\r
+ * editor.addRemoveFormatFilter.push( function( element )\r
+ * {\r
+ * return !( element.is( 'span' ) && CKEDITOR.tools.isEmpty( element.getAttributes() ) );\r
+ * });\r
+ */\r
+CKEDITOR.editor.prototype.addRemoveFormatFilter = function( func )\r
+{\r
+ this._.removeFormat.filters.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
+ * @type String\r
+ * @default 'b,big,code,del,dfn,em,font,i,ins,kbd,q,samp,small,span,strike,strong,sub,sup,tt,u,var'\r
+ * @example\r
+ */\r
+CKEDITOR.config.removeFormatTags = 'b,big,code,del,dfn,em,font,i,ins,kbd,q,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
+ * @type String\r
+ * @default 'class,style,lang,width,height,align,hspace,valign'\r
+ * @example\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
+ * @name CKEDITOR.editor#removeFormatCleanup\r
+ * @event\r
+ * @param {Object} data.element The element that was cleaned up.\r
+ */\r
projects / ckeditor.git / blobdiff