vanilla ckeditor-3.2.2

[ckeditor.git] / _source / plugins / removeformat / plugin.js

diff --git a/_source/plugins/removeformat/plugin.js b/_source/plugins/removeformat/plugin.js
index 97b858a..84d7947 100644 (file)
--- a/_source/plugins/removeformat/plugin.js
+++ b/_source/plugins/removeformat/plugin.js
@@ -15,6 +15,8 @@ CKEDITOR.plugins.add( 'removeformat',
                                label : editor.lang.removeFormat,\r
                                command : 'removeFormat'\r
                        });\r
+\r
+               editor._.removeFormat = { filters: [] };\r
        }\r
 });\r
 \r
@@ -32,6 +34,7 @@ CKEDITOR.plugins.removeformat =
                                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();\r
 \r
                                for ( var i = 0, range ; range = ranges[ i ] ; i++ )\r
@@ -70,7 +73,7 @@ CKEDITOR.plugins.removeformat =
                                                                break;\r
 \r
                                                        // If this element can be removed (even partially).\r
-                                                       if ( tagsRegex.test( pathElement.getName() ) )\r
+                                                       if ( tagsRegex.test( pathElement.getName() ) && filter( editor, pathElement ) )\r
                                                                node.breakParent( pathElement );\r
                                                }\r
                                        };\r
@@ -92,7 +95,9 @@ CKEDITOR.plugins.removeformat =
                                                var nextNode = currentNode.getNextSourceNode( false, CKEDITOR.NODE_ELEMENT );\r
 \r
                                                // This node must not be a fake element.\r
-                                               if ( !( currentNode.getName() == 'img' && currentNode.getAttribute( '_cke_realelement' ) ) )\r
+                                               if ( !( currentNode.getName() == 'img'\r
+                                                       && currentNode.getAttribute( '_cke_realelement' ) )\r
+                                                       && filter( editor, currentNode ) )\r
                                                {\r
                                                        // Remove elements nodes that match with this style rules.\r
                                                        if ( tagsRegex.test( currentNode.getName() ) )\r
@@ -110,10 +115,45 @@ CKEDITOR.plugins.removeformat =
                                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