Mimimum syndical pour en faire un produit zope / cmf.
[ckeditor.git] / _source / plugins / removeformat / plugin.js
1 /*
2 Copyright (c) 2003-2011, CKSource - Frederico Knabben. All rights reserved.
3 For licensing, see LICENSE.html or http://ckeditor.com/license
4 */
5
6 CKEDITOR.plugins.add( 'removeformat',
7 {
8 requires : [ 'selection' ],
9
10 init : function( editor )
11 {
12 editor.addCommand( 'removeFormat', CKEDITOR.plugins.removeformat.commands.removeformat );
13 editor.ui.addButton( 'RemoveFormat',
14 {
15 label : editor.lang.removeFormat,
16 command : 'removeFormat'
17 });
18
19 editor._.removeFormat = { filters: [] };
20 }
21 });
22
23 CKEDITOR.plugins.removeformat =
24 {
25 commands :
26 {
27 removeformat :
28 {
29 exec : function( editor )
30 {
31 var tagsRegex = editor._.removeFormatRegex ||
32 ( editor._.removeFormatRegex = new RegExp( '^(?:' + editor.config.removeFormatTags.replace( /,/g,'|' ) + ')$', 'i' ) );
33
34 var removeAttributes = editor._.removeAttributes ||
35 ( editor._.removeAttributes = editor.config.removeFormatAttributes.split( ',' ) );
36
37 var filter = CKEDITOR.plugins.removeformat.filter;
38 var ranges = editor.getSelection().getRanges( 1 ),
39 iterator = ranges.createIterator(),
40 range;
41
42 while ( ( range = iterator.getNextRange() ) )
43 {
44 if ( ! range.collapsed )
45 range.enlarge( CKEDITOR.ENLARGE_ELEMENT );
46
47 // Bookmark the range so we can re-select it after processing.
48 var bookmark = range.createBookmark(),
49 // The style will be applied within the bookmark boundaries.
50 startNode = bookmark.startNode,
51 endNode = bookmark.endNode,
52 currentNode;
53
54 // We need to check the selection boundaries (bookmark spans) to break
55 // the code in a way that we can properly remove partially selected nodes.
56 // For example, removing a <b> style from
57 // <b>This is [some text</b> to show <b>the] problem</b>
58 // ... where [ and ] represent the selection, must result:
59 // <b>This is </b>[some text to show the]<b> problem</b>
60 // The strategy is simple, we just break the partial nodes before the
61 // removal logic, having something that could be represented this way:
62 // <b>This is </b>[<b>some text</b> to show <b>the</b>]<b> problem</b>
63
64 var breakParent = function( node )
65 {
66 // Let's start checking the start boundary.
67 var path = new CKEDITOR.dom.elementPath( node ),
68 pathElements = path.elements;
69
70 for ( var i = 1, pathElement ; pathElement = pathElements[ i ] ; i++ )
71 {
72 if ( pathElement.equals( path.block ) || pathElement.equals( path.blockLimit ) )
73 break;
74
75 // If this element can be removed (even partially).
76 if ( tagsRegex.test( pathElement.getName() ) && filter( editor, pathElement ) )
77 node.breakParent( pathElement );
78 }
79 };
80
81 breakParent( startNode );
82 if ( endNode )
83 {
84 breakParent( endNode );
85
86 // Navigate through all nodes between the bookmarks.
87 currentNode = startNode.getNextSourceNode( true, CKEDITOR.NODE_ELEMENT );
88
89 while ( currentNode )
90 {
91 // If we have reached the end of the selection, stop looping.
92 if ( currentNode.equals( endNode ) )
93 break;
94
95 // Cache the next node to be processed. Do it now, because
96 // currentNode may be removed.
97 var nextNode = currentNode.getNextSourceNode( false, CKEDITOR.NODE_ELEMENT );
98
99 // This node must not be a fake element.
100 if ( !( currentNode.getName() == 'img'
101 && currentNode.data( 'cke-realelement' ) )
102 && filter( editor, currentNode ) )
103 {
104 // Remove elements nodes that match with this style rules.
105 if ( tagsRegex.test( currentNode.getName() ) )
106 currentNode.remove( 1 );
107 else
108 {
109 currentNode.removeAttributes( removeAttributes );
110 editor.fire( 'removeFormatCleanup', currentNode );
111 }
112 }
113
114 currentNode = nextNode;
115 }
116 }
117
118 range.moveToBookmark( bookmark );
119 }
120
121 editor.getSelection().selectRanges( ranges );
122 }
123 }
124 },
125
126 /**
127 * Perform the remove format filters on the passed element.
128 * @param {CKEDITOR.editor} editor
129 * @param {CKEDITOR.dom.element} element
130 */
131 filter : function ( editor, element )
132 {
133 var filters = editor._.removeFormat.filters;
134 for ( var i = 0; i < filters.length; i++ )
135 {
136 if ( filters[ i ]( element ) === false )
137 return false;
138 }
139 return true;
140 }
141 };
142
143 /**
144 * Add to a collection of functions to decide whether a specific
145 * element should be considered as formatting element and thus
146 * could be removed during <b>removeFormat</b> command,
147 * Note: Only available with the existence of 'removeformat' plugin.
148 * @since 3.3
149 * @param {Function} func The function to be called, which will be passed a {CKEDITOR.dom.element} element to test.
150 * @example
151 * // Don't remove empty span
152 * editor.addRemoveFormatFilter.push( function( element )
153 * {
154 * return !( element.is( 'span' ) && CKEDITOR.tools.isEmpty( element.getAttributes() ) );
155 * });
156 */
157 CKEDITOR.editor.prototype.addRemoveFormatFilter = function( func )
158 {
159 this._.removeFormat.filters.push( func );
160 };
161
162 /**
163 * A comma separated list of elements to be removed when executing the "remove
164 " format" command. Note that only inline elements are allowed.
165 * @type String
166 * @default 'b,big,code,del,dfn,em,font,i,ins,kbd,q,samp,small,span,strike,strong,sub,sup,tt,u,var'
167 * @example
168 */
169 CKEDITOR.config.removeFormatTags = 'b,big,code,del,dfn,em,font,i,ins,kbd,q,samp,small,span,strike,strong,sub,sup,tt,u,var';
170
171 /**
172 * A comma separated list of elements attributes to be removed when executing
173 * the "remove format" command.
174 * @type String
175 * @default 'class,style,lang,width,height,align,hspace,valign'
176 * @example
177 */
178 CKEDITOR.config.removeFormatAttributes = 'class,style,lang,width,height,align,hspace,valign';
179
180 /**
181 * Fired after an element was cleaned by the removeFormat plugin.
182 * @name CKEDITOR.editor#removeFormatCleanup
183 * @event
184 * @param {Object} data.element The element that was cleaned up.
185 */