On prépare de quoi se concentrer sur les images incorporées.
[ckeditor.git] / skins / ckeditor / _source / themes / default / theme.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 /**
7 * @name CKEDITOR.theme
8 * @class
9 */
10
11 CKEDITOR.themes.add( 'default', (function()
12 {
13 var hiddenSkins = {};
14
15 function checkSharedSpace( editor, spaceName )
16 {
17 var container,
18 element;
19
20 // Try to retrieve the target element from the sharedSpaces settings.
21 element = editor.config.sharedSpaces;
22 element = element && element[ spaceName ];
23 element = element && CKEDITOR.document.getById( element );
24
25 // If the element is available, we'll then create the container for
26 // the space.
27 if ( element )
28 {
29 // Creates an HTML structure that reproduces the editor class hierarchy.
30 var html =
31 '<span class="cke_shared "' +
32 ' dir="'+ editor.lang.dir + '"' +
33 '>' +
34 '<span class="' + editor.skinClass + ' ' + editor.id + ' cke_editor_' + editor.name + '">' +
35 '<span class="' + CKEDITOR.env.cssClass + '">' +
36 '<span class="cke_wrapper cke_' + editor.lang.dir + '">' +
37 '<span class="cke_editor">' +
38 '<div class="cke_' + spaceName + '">' +
39 '</div></span></span></span></span></span>';
40
41 var mainContainer = element.append( CKEDITOR.dom.element.createFromHtml( html, element.getDocument() ) );
42
43 // Only the first container starts visible. Others get hidden.
44 if ( element.getCustomData( 'cke_hasshared' ) )
45 mainContainer.hide();
46 else
47 element.setCustomData( 'cke_hasshared', 1 );
48
49 // Get the deeper inner <div>.
50 container = mainContainer.getChild( [0,0,0,0] );
51
52 // Save a reference to the shared space container.
53 !editor.sharedSpaces && ( editor.sharedSpaces = {} );
54 editor.sharedSpaces[ spaceName ] = container;
55
56 // When the editor gets focus, we show the space container, hiding others.
57 editor.on( 'focus', function()
58 {
59 for ( var i = 0, sibling, children = element.getChildren() ; ( sibling = children.getItem( i ) ) ; i++ )
60 {
61 if ( sibling.type == CKEDITOR.NODE_ELEMENT
62 && !sibling.equals( mainContainer )
63 && sibling.hasClass( 'cke_shared' ) )
64 {
65 sibling.hide();
66 }
67 }
68
69 mainContainer.show();
70 });
71
72 editor.on( 'destroy', function()
73 {
74 mainContainer.remove();
75 });
76 }
77
78 return container;
79 }
80
81 return /** @lends CKEDITOR.theme */ {
82 build : function( editor, themePath )
83 {
84 var name = editor.name,
85 element = editor.element,
86 elementMode = editor.elementMode;
87
88 if ( !element || elementMode == CKEDITOR.ELEMENT_MODE_NONE )
89 return;
90
91 if ( elementMode == CKEDITOR.ELEMENT_MODE_REPLACE )
92 element.hide();
93
94 // Get the HTML for the predefined spaces.
95 var topHtml = editor.fire( 'themeSpace', { space : 'top', html : '' } ).html;
96 var contentsHtml = editor.fire( 'themeSpace', { space : 'contents', html : '' } ).html;
97 var bottomHtml = editor.fireOnce( 'themeSpace', { space : 'bottom', html : '' } ).html;
98
99 var height = contentsHtml && editor.config.height;
100
101 var tabIndex = editor.config.tabIndex || editor.element.getAttribute( 'tabindex' ) || 0;
102
103 // The editor height is considered only if the contents space got filled.
104 if ( !contentsHtml )
105 height = 'auto';
106 else if ( !isNaN( height ) )
107 height += 'px';
108
109 var style = '';
110 var width = editor.config.width;
111
112 if ( width )
113 {
114 if ( !isNaN( width ) )
115 width += 'px';
116
117 style += "width: " + width + ";";
118 }
119
120 var sharedTop = topHtml && checkSharedSpace( editor, 'top' ),
121 sharedBottoms = checkSharedSpace( editor, 'bottom' );
122
123 sharedTop && ( sharedTop.setHtml( topHtml ) , topHtml = '' );
124 sharedBottoms && ( sharedBottoms.setHtml( bottomHtml ), bottomHtml = '' );
125
126 var hideSkin = '<style>.' + editor.skinClass + '{visibility:hidden;}</style>';
127 if ( hiddenSkins[ editor.skinClass ] )
128 hideSkin = '';
129 else
130 hiddenSkins[ editor.skinClass ] = 1;
131
132 var container = CKEDITOR.dom.element.createFromHtml( [
133 '<span' +
134 ' id="cke_', name, '"' +
135 ' class="', editor.skinClass, ' ', editor.id, ' cke_editor_', name, '"' +
136 ' dir="', editor.lang.dir, '"' +
137 ' title="', ( CKEDITOR.env.gecko ? ' ' : '' ), '"' +
138 ' lang="', editor.langCode, '"' +
139 ( CKEDITOR.env.webkit? ' tabindex="' + tabIndex + '"' : '' ) +
140 ' role="application"' +
141 ' aria-labelledby="cke_', name, '_arialbl"' +
142 ( style ? ' style="' + style + '"' : '' ) +
143 '>' +
144 '<span id="cke_', name, '_arialbl" class="cke_voice_label">' + editor.lang.editor + '</span>' +
145 '<span class="' , CKEDITOR.env.cssClass, '" role="presentation">' +
146 '<span class="cke_wrapper cke_', editor.lang.dir, '" role="presentation">' +
147 '<table class="cke_editor" border="0" cellspacing="0" cellpadding="0" role="presentation"><tbody>' +
148 '<tr', topHtml ? '' : ' style="display:none"', ' role="presentation"><td id="cke_top_' , name, '" class="cke_top" role="presentation">' , topHtml , '</td></tr>' +
149 '<tr', contentsHtml ? '' : ' style="display:none"', ' role="presentation"><td id="cke_contents_', name, '" class="cke_contents" style="height:', height, '" role="presentation">', contentsHtml, '</td></tr>' +
150 '<tr', bottomHtml ? '' : ' style="display:none"', ' role="presentation"><td id="cke_bottom_' , name, '" class="cke_bottom" role="presentation">' , bottomHtml , '</td></tr>' +
151 '</tbody></table>' +
152 //Hide the container when loading skins, later restored by skin css.
153 hideSkin +
154 '</span>' +
155 '</span>' +
156 '</span>' ].join( '' ) );
157
158 container.getChild( [1, 0, 0, 0, 0] ).unselectable();
159 container.getChild( [1, 0, 0, 0, 2] ).unselectable();
160
161 if ( elementMode == CKEDITOR.ELEMENT_MODE_REPLACE )
162 container.insertAfter( element );
163 else
164 element.append( container );
165
166 /**
167 * The DOM element that holds the main editor interface.
168 * @name CKEDITOR.editor.prototype.container
169 * @type CKEDITOR.dom.element
170 * @example
171 * var editor = CKEDITOR.instances.editor1;
172 * alert( <b>editor.container</b>.getName() ); "span"
173 */
174 editor.container = container;
175
176 // Disable browser context menu for editor's chrome.
177 container.disableContextMenu();
178
179 // Use a class to indicate that the current selection is in different direction than the UI.
180 editor.on( 'contentDirChanged', function( evt )
181 {
182 var func = ( editor.lang.dir != evt.data ? 'add' : 'remove' ) + 'Class';
183
184 container.getChild( 1 )[ func ]( 'cke_mixed_dir_content' );
185
186 // Put the mixed direction class on the respective element also for shared spaces.
187 var toolbarSpace = this.sharedSpaces && this.sharedSpaces[ this.config.toolbarLocation ];
188 toolbarSpace && toolbarSpace.getParent().getParent()[ func ]( 'cke_mixed_dir_content' );
189 });
190
191 editor.fireOnce( 'themeLoaded' );
192 editor.fireOnce( 'uiReady' );
193 },
194
195 buildDialog : function( editor )
196 {
197 var baseIdNumber = CKEDITOR.tools.getNextNumber();
198
199 var element = CKEDITOR.dom.element.createFromHtml( [
200 '<div class="', editor.id, '_dialog cke_editor_', editor.name.replace('.', '\\.'), '_dialog cke_skin_', editor.skinName,
201 '" dir="', editor.lang.dir, '"' +
202 ' lang="', editor.langCode, '"' +
203 ' role="dialog"' +
204 ' aria-labelledby="%title#"' +
205 '>' +
206 '<table class="cke_dialog', ' ' + CKEDITOR.env.cssClass,
207 ' cke_', editor.lang.dir, '" style="position:absolute" role="presentation">' +
208 '<tr><td role="presentation">' +
209 '<div class="%body" role="presentation">' +
210 '<div id="%title#" class="%title" role="presentation"></div>' +
211 '<a id="%close_button#" class="%close_button" href="javascript:void(0)" title="' + editor.lang.common.close+'" role="button"><span class="cke_label">X</span></a>' +
212 '<div id="%tabs#" class="%tabs" role="tablist"></div>' +
213 '<table class="%contents" role="presentation">' +
214 '<tr>' +
215 '<td id="%contents#" class="%contents" role="presentation"></td>' +
216 '</tr>' +
217 '<tr>' +
218 '<td id="%footer#" class="%footer" role="presentation"></td>' +
219 '</tr>' +
220 '</table>' +
221 '</div>' +
222 '<div id="%tl#" class="%tl"></div>' +
223 '<div id="%tc#" class="%tc"></div>' +
224 '<div id="%tr#" class="%tr"></div>' +
225 '<div id="%ml#" class="%ml"></div>' +
226 '<div id="%mr#" class="%mr"></div>' +
227 '<div id="%bl#" class="%bl"></div>' +
228 '<div id="%bc#" class="%bc"></div>' +
229 '<div id="%br#" class="%br"></div>' +
230 '</td></tr>' +
231 '</table>',
232
233 //Hide the container when loading skins, later restored by skin css.
234 ( CKEDITOR.env.ie ? '' : '<style>.cke_dialog{visibility:hidden;}</style>' ),
235
236 '</div>'
237 ].join( '' )
238 .replace( /#/g, '_' + baseIdNumber )
239 .replace( /%/g, 'cke_dialog_' ) );
240
241 var body = element.getChild( [ 0, 0, 0, 0, 0 ] ),
242 title = body.getChild( 0 ),
243 close = body.getChild( 1 );
244
245 // Make the Title and Close Button unselectable.
246 title.unselectable();
247 close.unselectable();
248
249
250 return {
251 element : element,
252 parts :
253 {
254 dialog : element.getChild( 0 ),
255 title : title,
256 close : close,
257 tabs : body.getChild( 2 ),
258 contents : body.getChild( [ 3, 0, 0, 0 ] ),
259 footer : body.getChild( [ 3, 0, 1, 0 ] )
260 }
261 };
262 },
263
264 destroy : function( editor )
265 {
266 var container = editor.container,
267 element = editor.element;
268
269 if ( container )
270 {
271 container.clearCustomData();
272 container.remove();
273 }
274
275 if ( element )
276 {
277 element.clearCustomData();
278 editor.elementMode == CKEDITOR.ELEMENT_MODE_REPLACE && element.show();
279 delete editor.element;
280 }
281 }
282 };
283 })() );
284
285 /**
286 * Returns the DOM element that represents a theme space. The default theme defines
287 * three spaces, namely "top", "contents" and "bottom", representing the main
288 * blocks that compose the editor interface.
289 * @param {String} spaceName The space name.
290 * @returns {CKEDITOR.dom.element} The element that represents the space.
291 * @example
292 * // Hide the bottom space in the UI.
293 * var bottom = editor.getThemeSpace( 'bottom' );
294 * bottom.setStyle( 'display', 'none' );
295 */
296 CKEDITOR.editor.prototype.getThemeSpace = function( spaceName )
297 {
298 var spacePrefix = 'cke_' + spaceName;
299 var space = this._[ spacePrefix ] ||
300 ( this._[ spacePrefix ] = CKEDITOR.document.getById( spacePrefix + '_' + this.name ) );
301 return space;
302 };
303
304 /**
305 * Resizes the editor interface.
306 * @param {Number|String} width The new width. It can be an pixels integer or a
307 * CSS size value.
308 * @param {Number|String} height The new height. It can be an pixels integer or
309 * a CSS size value.
310 * @param {Boolean} [isContentHeight] Indicates that the provided height is to
311 * be applied to the editor contents space, not to the entire editor
312 * interface. Defaults to false.
313 * @param {Boolean} [resizeInner] Indicates that the first inner interface
314 * element must receive the size, not the outer element. The default theme
315 * defines the interface inside a pair of span elements
316 * (&lt;span&gt;&lt;span&gt;...&lt;/span&gt;&lt;/span&gt;). By default the
317 * first span element receives the sizes. If this parameter is set to
318 * true, the second span is sized instead.
319 * @example
320 * editor.resize( 900, 300 );
321 * @example
322 * editor.resize( '100%', 450, true );
323 */
324 CKEDITOR.editor.prototype.resize = function( width, height, isContentHeight, resizeInner )
325 {
326 var container = this.container,
327 contents = CKEDITOR.document.getById( 'cke_contents_' + this.name ),
328 outer = resizeInner ? container.getChild( 1 ) : container;
329
330 // Resize the width first.
331 // WEBKIT BUG: Webkit requires that we put the editor off from display when we
332 // resize it. If we don't, the browser crashes!
333 CKEDITOR.env.webkit && outer.setStyle( 'display', 'none' );
334 // Set as border box width. (#5353)
335 outer.setSize( 'width', width, true );
336 if ( CKEDITOR.env.webkit )
337 {
338 outer.$.offsetWidth;
339 outer.setStyle( 'display', '' );
340 }
341
342 // Get the height delta between the outer table and the content area.
343 // If we're setting the content area's height, then we don't need the delta.
344 var delta = isContentHeight ? 0 : ( outer.$.offsetHeight || 0 ) - ( contents.$.clientHeight || 0 );
345 contents.setStyle( 'height', Math.max( height - delta, 0 ) + 'px' );
346
347 // Emit a resize event.
348 this.fire( 'resize' );
349 };
350
351 /**
352 * Gets the element that can be freely used to check the editor size. This method
353 * is mainly used by the resize plugin, which adds a UI handle that can be used
354 * to resize the editor.
355 * @param {Boolean} forContents Whether to return the "contents" part of the theme instead of the container.
356 * @returns {CKEDITOR.dom.element} The resizable element.
357 * @example
358 */
359 CKEDITOR.editor.prototype.getResizable = function( forContents )
360 {
361 return forContents ? CKEDITOR.document.getById( 'cke_contents_' + this.name ) : this.container;
362 };
363
364 /**
365 * Makes it possible to place some of the editor UI blocks, like the toolbar
366 * and the elements path, into any element in the page.
367 * The elements used to hold the UI blocks can be shared among several editor
368 * instances. In that case, only the blocks of the active editor instance will
369 * display.
370 * @name CKEDITOR.config.sharedSpaces
371 * @type Object
372 * @default undefined
373 * @example
374 * // Place the toolbar inside the element with ID "someElementId" and the
375 * // elements path into the element with ID "anotherId".
376 * config.sharedSpaces =
377 * {
378 * top : 'someElementId',
379 * bottom : 'anotherId'
380 * };
381 * @example
382 * // Place the toolbar inside the element with ID "someElementId". The
383 * // elements path will remain attached to the editor UI.
384 * config.sharedSpaces =
385 * {
386 * top : 'someElementId'
387 * };
388 */
389
390 /**
391 * Fired after the editor instance is resized through
392 * the {@link CKEDITOR.editor.prototype.resize} method.
393 * @name CKEDITOR.editor#resize
394 * @event
395 */