JasonWoof Got questions, comments, patches, etc.? Contact Jason Woofenden
d4a92f8961462eaa794656aad022a78a37ac98b9
[ckeditor.git] / _source / plugins / selection / plugin.js
1 /*\r
2 Copyright (c) 2003-2010, CKSource - Frederico Knabben. All rights reserved.\r
3 For licensing, see LICENSE.html or http://ckeditor.com/license\r
4 */\r
5 \r
6 (function()\r
7 {\r
8         // #### checkSelectionChange : START\r
9 \r
10         // The selection change check basically saves the element parent tree of\r
11         // the current node and check it on successive requests. If there is any\r
12         // change on the tree, then the selectionChange event gets fired.\r
13         function checkSelectionChange()\r
14         {\r
15                 try\r
16                 {\r
17                         // In IE, the "selectionchange" event may still get thrown when\r
18                         // releasing the WYSIWYG mode, so we need to check it first.\r
19                         var sel = this.getSelection();\r
20                         if ( !sel || !sel.document.getWindow().$ )\r
21                                 return;\r
22 \r
23                         var firstElement = sel.getStartElement();\r
24                         var currentPath = new CKEDITOR.dom.elementPath( firstElement );\r
25 \r
26                         if ( !currentPath.compare( this._.selectionPreviousPath ) )\r
27                         {\r
28                                 this._.selectionPreviousPath = currentPath;\r
29                                 this.fire( 'selectionChange', { selection : sel, path : currentPath, element : firstElement } );\r
30                         }\r
31                 }\r
32                 catch (e)\r
33                 {}\r
34         }\r
35 \r
36         var checkSelectionChangeTimer,\r
37                 checkSelectionChangeTimeoutPending;\r
38 \r
39         function checkSelectionChangeTimeout()\r
40         {\r
41                 // Firing the "OnSelectionChange" event on every key press started to\r
42                 // be too slow. This function guarantees that there will be at least\r
43                 // 200ms delay between selection checks.\r
44 \r
45                 checkSelectionChangeTimeoutPending = true;\r
46 \r
47                 if ( checkSelectionChangeTimer )\r
48                         return;\r
49 \r
50                 checkSelectionChangeTimeoutExec.call( this );\r
51 \r
52                 checkSelectionChangeTimer = CKEDITOR.tools.setTimeout( checkSelectionChangeTimeoutExec, 200, this );\r
53         }\r
54 \r
55         function checkSelectionChangeTimeoutExec()\r
56         {\r
57                 checkSelectionChangeTimer = null;\r
58 \r
59                 if ( checkSelectionChangeTimeoutPending )\r
60                 {\r
61                         // Call this with a timeout so the browser properly moves the\r
62                         // selection after the mouseup. It happened that the selection was\r
63                         // being moved after the mouseup when clicking inside selected text\r
64                         // with Firefox.\r
65                         CKEDITOR.tools.setTimeout( checkSelectionChange, 0, this );\r
66 \r
67                         checkSelectionChangeTimeoutPending = false;\r
68                 }\r
69         }\r
70 \r
71         // #### checkSelectionChange : END\r
72 \r
73         var selectAllCmd =\r
74         {\r
75                 modes : { wysiwyg : 1, source : 1 },\r
76                 exec : function( editor )\r
77                 {\r
78                         switch ( editor.mode )\r
79                         {\r
80                                 case 'wysiwyg' :\r
81                                         editor.document.$.execCommand( 'SelectAll', false, null );\r
82                                         break;\r
83                                 case 'source' :\r
84                                         // Select the contents of the textarea\r
85                                         var textarea = editor.textarea.$ ;\r
86                                         if ( CKEDITOR.env.ie )\r
87                                         {\r
88                                                 textarea.createTextRange().execCommand( 'SelectAll' ) ;\r
89                                         }\r
90                                         else\r
91                                         {\r
92                                                 textarea.selectionStart = 0 ;\r
93                                                 textarea.selectionEnd = textarea.value.length ;\r
94                                         }\r
95                                         textarea.focus() ;\r
96                         }\r
97                 },\r
98                 canUndo : false\r
99         };\r
100 \r
101         CKEDITOR.plugins.add( 'selection',\r
102         {\r
103                 init : function( editor )\r
104                 {\r
105                         editor.on( 'contentDom', function()\r
106                                 {\r
107                                         var doc = editor.document,\r
108                                                 body = doc.getBody(),\r
109                                                 html = doc.getDocumentElement();\r
110 \r
111                                         if ( CKEDITOR.env.ie )\r
112                                         {\r
113                                                 // Other browsers don't loose the selection if the\r
114                                                 // editor document loose the focus. In IE, we don't\r
115                                                 // have support for it, so we reproduce it here, other\r
116                                                 // than firing the selection change event.\r
117 \r
118                                                 var savedRange,\r
119                                                         saveEnabled,\r
120                                                         restoreEnabled = 1;\r
121 \r
122                                                 // "onfocusin" is fired before "onfocus". It makes it\r
123                                                 // possible to restore the selection before click\r
124                                                 // events get executed.\r
125                                                 body.on( 'focusin', function( evt )\r
126                                                         {\r
127                                                                 // If there are elements with layout they fire this event but\r
128                                                                 // it must be ignored to allow edit its contents #4682\r
129                                                                 if ( evt.data.$.srcElement.nodeName != 'BODY' )\r
130                                                                         return;\r
131 \r
132                                                                 // If we have saved a range, restore it at this\r
133                                                                 // point.\r
134                                                                 if ( savedRange )\r
135                                                                 {\r
136                                                                         if ( restoreEnabled )\r
137                                                                         {\r
138                                                                                 // Well not break because of this.\r
139                                                                                 try\r
140                                                                                 {\r
141                                                                                         savedRange.select();\r
142                                                                                 }\r
143                                                                                 catch (e)\r
144                                                                                 {}\r
145                                                                         }\r
146 \r
147                                                                         savedRange = null;\r
148                                                                 }\r
149                                                         });\r
150 \r
151                                                 body.on( 'focus', function()\r
152                                                         {\r
153                                                                 // Enable selections to be saved.\r
154                                                                 saveEnabled = true;\r
155 \r
156                                                                 saveSelection();\r
157                                                         });\r
158 \r
159                                                 body.on( 'beforedeactivate', function( evt )\r
160                                                         {\r
161                                                                 // Ignore this event if it's caused by focus switch between\r
162                                                                 // internal editable control type elements, e.g. layouted paragraph. (#4682)\r
163                                                                 if ( evt.data.$.toElement )\r
164                                                                         return;\r
165 \r
166                                                                 // Disable selections from being saved.\r
167                                                                 saveEnabled = false;\r
168                                                                 restoreEnabled = 1;\r
169                                                         });\r
170 \r
171                                                 // IE before version 8 will leave cursor blinking inside the document after\r
172                                                 // editor blurred unless we clean up the selection. (#4716)\r
173                                                 if ( CKEDITOR.env.ie && CKEDITOR.env.version < 8 )\r
174                                                 {\r
175                                                         editor.on( 'blur', function( evt )\r
176                                                         {\r
177                                                                 editor.document && editor.document.$.selection.empty();\r
178                                                         });\r
179                                                 }\r
180 \r
181                                                 // Listening on document element ensures that\r
182                                                 // scrollbar is included. (#5280)\r
183                                                 html.on( 'mousedown', function ()\r
184                                                 {\r
185                                                         // Lock restore selection now, as we have\r
186                                                         // a followed 'click' event which introduce\r
187                                                         // new selection. (#5735)\r
188                                                         restoreEnabled = 0;\r
189                                                 });\r
190 \r
191                                                 html.on( 'mouseup', function ()\r
192                                                 {\r
193                                                         restoreEnabled = 1;\r
194                                                 });\r
195 \r
196                                                 // In IE6/7 the blinking cursor appears, but contents are\r
197                                                 // not editable. (#5634)\r
198                                                 if ( CKEDITOR.env.ie && ( CKEDITOR.env.ie7Compat || CKEDITOR.env.version < 8 || CKEDITOR.env.quirks ) )\r
199                                                 {\r
200                                                         // The 'click' event is not fired when clicking the\r
201                                                         // scrollbars, so we can use it to check whether\r
202                                                         // the empty space following <body> has been clicked.\r
203                                                         html.on( 'click', function( evt )\r
204                                                         {\r
205                                                                 if ( evt.data.getTarget().getName() == 'html' )\r
206                                                                         editor.getSelection().getRanges()[ 0 ].select();\r
207                                                         });\r
208                                                 }\r
209 \r
210                                                 // IE fires the "selectionchange" event when clicking\r
211                                                 // inside a selection. We don't want to capture that.\r
212                                                 body.on( 'mousedown', function ()\r
213                                                 {\r
214                                                         disableSave();\r
215                                                 });\r
216 \r
217                                                 body.on( 'mouseup',\r
218                                                         function()\r
219                                                         {\r
220                                                                 saveEnabled = true;\r
221                                                                 setTimeout( function()\r
222                                                                         {\r
223                                                                                 saveSelection( true );\r
224                                                                         },\r
225                                                                         0 );\r
226                                                         });\r
227 \r
228                                                 body.on( 'keydown', disableSave );\r
229                                                 body.on( 'keyup',\r
230                                                         function()\r
231                                                         {\r
232                                                                 saveEnabled = true;\r
233                                                                 saveSelection();\r
234                                                         });\r
235 \r
236 \r
237                                                 // IE is the only to provide the "selectionchange"\r
238                                                 // event.\r
239                                                 doc.on( 'selectionchange', saveSelection );\r
240 \r
241                                                 function disableSave()\r
242                                                 {\r
243                                                         saveEnabled = false;\r
244                                                 }\r
245 \r
246                                                 function saveSelection( testIt )\r
247                                                 {\r
248                                                         if ( saveEnabled )\r
249                                                         {\r
250                                                                 var doc = editor.document,\r
251                                                                         sel = editor.getSelection(),\r
252                                                                         nativeSel = sel && sel.getNative();\r
253 \r
254                                                                 // There is a very specific case, when clicking\r
255                                                                 // inside a text selection. In that case, the\r
256                                                                 // selection collapses at the clicking point,\r
257                                                                 // but the selection object remains in an\r
258                                                                 // unknown state, making createRange return a\r
259                                                                 // range at the very start of the document. In\r
260                                                                 // such situation we have to test the range, to\r
261                                                                 // be sure it's valid.\r
262                                                                 if ( testIt && nativeSel && nativeSel.type == 'None' )\r
263                                                                 {\r
264                                                                         // The "InsertImage" command can be used to\r
265                                                                         // test whether the selection is good or not.\r
266                                                                         // If not, it's enough to give some time to\r
267                                                                         // IE to put things in order for us.\r
268                                                                         if ( !doc.$.queryCommandEnabled( 'InsertImage' ) )\r
269                                                                         {\r
270                                                                                 CKEDITOR.tools.setTimeout( saveSelection, 50, this, true );\r
271                                                                                 return;\r
272                                                                         }\r
273                                                                 }\r
274 \r
275                                                                 // Avoid saving selection from within text input. (#5747)\r
276                                                                 var parentTag;\r
277                                                                 if ( nativeSel && nativeSel.type && nativeSel.type != 'Control'\r
278                                                                         && ( parentTag = nativeSel.createRange() )\r
279                                                                         && ( parentTag = parentTag.parentElement() )\r
280                                                                         && ( parentTag = parentTag.nodeName )\r
281                                                                         && parentTag.toLowerCase() in { input: 1, textarea : 1 } )\r
282                                                                 {\r
283                                                                         return;\r
284                                                                 }\r
285 \r
286                                                                 savedRange = nativeSel && sel.getRanges()[ 0 ];\r
287 \r
288                                                                 checkSelectionChangeTimeout.call( editor );\r
289                                                         }\r
290                                                 }\r
291                                         }\r
292                                         else\r
293                                         {\r
294                                                 // In other browsers, we make the selection change\r
295                                                 // check based on other events, like clicks or keys\r
296                                                 // press.\r
297 \r
298                                                 doc.on( 'mouseup', checkSelectionChangeTimeout, editor );\r
299                                                 doc.on( 'keyup', checkSelectionChangeTimeout, editor );\r
300                                         }\r
301                                 });\r
302 \r
303                         editor.addCommand( 'selectAll', selectAllCmd );\r
304                         editor.ui.addButton( 'SelectAll',\r
305                                 {\r
306                                         label : editor.lang.selectAll,\r
307                                         command : 'selectAll'\r
308                                 });\r
309 \r
310                         editor.selectionChange = checkSelectionChangeTimeout;\r
311                 }\r
312         });\r
313 \r
314         /**\r
315          * Gets the current selection from the editing area when in WYSIWYG mode.\r
316          * @returns {CKEDITOR.dom.selection} A selection object or null if not on\r
317          *              WYSIWYG mode or no selection is available.\r
318          * @example\r
319          * var selection = CKEDITOR.instances.editor1.<b>getSelection()</b>;\r
320          * alert( selection.getType() );\r
321          */\r
322         CKEDITOR.editor.prototype.getSelection = function()\r
323         {\r
324                 return this.document && this.document.getSelection();\r
325         };\r
326 \r
327         CKEDITOR.editor.prototype.forceNextSelectionCheck = function()\r
328         {\r
329                 delete this._.selectionPreviousPath;\r
330         };\r
331 \r
332         /**\r
333          * Gets the current selection from the document.\r
334          * @returns {CKEDITOR.dom.selection} A selection object.\r
335          * @example\r
336          * var selection = CKEDITOR.instances.editor1.document.<b>getSelection()</b>;\r
337          * alert( selection.getType() );\r
338          */\r
339         CKEDITOR.dom.document.prototype.getSelection = function()\r
340         {\r
341                 var sel = new CKEDITOR.dom.selection( this );\r
342                 return ( !sel || sel.isInvalid ) ? null : sel;\r
343         };\r
344 \r
345         /**\r
346          * No selection.\r
347          * @constant\r
348          * @example\r
349          * if ( editor.getSelection().getType() == CKEDITOR.SELECTION_NONE )\r
350          *     alert( 'Nothing is selected' );\r
351          */\r
352         CKEDITOR.SELECTION_NONE         = 1;\r
353 \r
354         /**\r
355          * Text or collapsed selection.\r
356          * @constant\r
357          * @example\r
358          * if ( editor.getSelection().getType() == CKEDITOR.SELECTION_TEXT )\r
359          *     alert( 'Text is selected' );\r
360          */\r
361         CKEDITOR.SELECTION_TEXT         = 2;\r
362 \r
363         /**\r
364          * Element selection.\r
365          * @constant\r
366          * @example\r
367          * if ( editor.getSelection().getType() == CKEDITOR.SELECTION_ELEMENT )\r
368          *     alert( 'An element is selected' );\r
369          */\r
370         CKEDITOR.SELECTION_ELEMENT      = 3;\r
371 \r
372         /**\r
373          * Manipulates the selection in a DOM document.\r
374          * @constructor\r
375          * @example\r
376          */\r
377         CKEDITOR.dom.selection = function( document )\r
378         {\r
379                 var lockedSelection = document.getCustomData( 'cke_locked_selection' );\r
380 \r
381                 if ( lockedSelection )\r
382                         return lockedSelection;\r
383 \r
384                 this.document = document;\r
385                 this.isLocked = false;\r
386                 this._ =\r
387                 {\r
388                         cache : {}\r
389                 };\r
390 \r
391                 /**\r
392                  * IE BUG: The selection's document may be a different document than the\r
393                  * editor document. Return null if that's the case.\r
394                  */\r
395                 if ( CKEDITOR.env.ie )\r
396                 {\r
397                         var range = this.getNative().createRange();\r
398                         if ( !range\r
399                                 || ( range.item && range.item(0).ownerDocument != this.document.$ )\r
400                                 || ( range.parentElement && range.parentElement().ownerDocument != this.document.$ ) )\r
401                         {\r
402                                 this.isInvalid = true;\r
403                         }\r
404                 }\r
405 \r
406                 return this;\r
407         };\r
408 \r
409         var styleObjectElements =\r
410         {\r
411                 img:1,hr:1,li:1,table:1,tr:1,td:1,th:1,embed:1,object:1,ol:1,ul:1,\r
412                 a:1, input:1, form:1, select:1, textarea:1, button:1, fieldset:1, th:1, thead:1, tfoot:1\r
413         };\r
414 \r
415         CKEDITOR.dom.selection.prototype =\r
416         {\r
417                 /**\r
418                  * Gets the native selection object from the browser.\r
419                  * @function\r
420                  * @returns {Object} The native selection object.\r
421                  * @example\r
422                  * var selection = editor.getSelection().<b>getNative()</b>;\r
423                  */\r
424                 getNative :\r
425                         CKEDITOR.env.ie ?\r
426                                 function()\r
427                                 {\r
428                                         return this._.cache.nativeSel || ( this._.cache.nativeSel = this.document.$.selection );\r
429                                 }\r
430                         :\r
431                                 function()\r
432                                 {\r
433                                         return this._.cache.nativeSel || ( this._.cache.nativeSel = this.document.getWindow().$.getSelection() );\r
434                                 },\r
435 \r
436                 /**\r
437                  * Gets the type of the current selection. The following values are\r
438                  * available:\r
439                  * <ul>\r
440                  *              <li>{@link CKEDITOR.SELECTION_NONE} (1): No selection.</li>\r
441                  *              <li>{@link CKEDITOR.SELECTION_TEXT} (2): Text is selected or\r
442                  *                      collapsed selection.</li>\r
443                  *              <li>{@link CKEDITOR.SELECTION_ELEMENT} (3): A element\r
444                  *                      selection.</li>\r
445                  * </ul>\r
446                  * @function\r
447                  * @returns {Number} One of the following constant values:\r
448                  *              {@link CKEDITOR.SELECTION_NONE}, {@link CKEDITOR.SELECTION_TEXT} or\r
449                  *              {@link CKEDITOR.SELECTION_ELEMENT}.\r
450                  * @example\r
451                  * if ( editor.getSelection().<b>getType()</b> == CKEDITOR.SELECTION_TEXT )\r
452                  *     alert( 'Text is selected' );\r
453                  */\r
454                 getType :\r
455                         CKEDITOR.env.ie ?\r
456                                 function()\r
457                                 {\r
458                                         var cache = this._.cache;\r
459                                         if ( cache.type )\r
460                                                 return cache.type;\r
461 \r
462                                         var type = CKEDITOR.SELECTION_NONE;\r
463 \r
464                                         try\r
465                                         {\r
466                                                 var sel = this.getNative(),\r
467                                                         ieType = sel.type;\r
468 \r
469                                                 if ( ieType == 'Text' )\r
470                                                         type = CKEDITOR.SELECTION_TEXT;\r
471 \r
472                                                 if ( ieType == 'Control' )\r
473                                                         type = CKEDITOR.SELECTION_ELEMENT;\r
474 \r
475                                                 // It is possible that we can still get a text range\r
476                                                 // object even when type == 'None' is returned by IE.\r
477                                                 // So we'd better check the object returned by\r
478                                                 // createRange() rather than by looking at the type.\r
479                                                 if ( sel.createRange().parentElement )\r
480                                                         type = CKEDITOR.SELECTION_TEXT;\r
481                                         }\r
482                                         catch(e) {}\r
483 \r
484                                         return ( cache.type = type );\r
485                                 }\r
486                         :\r
487                                 function()\r
488                                 {\r
489                                         var cache = this._.cache;\r
490                                         if ( cache.type )\r
491                                                 return cache.type;\r
492 \r
493                                         var type = CKEDITOR.SELECTION_TEXT;\r
494 \r
495                                         var sel = this.getNative();\r
496 \r
497                                         if ( !sel )\r
498                                                 type = CKEDITOR.SELECTION_NONE;\r
499                                         else if ( sel.rangeCount == 1 )\r
500                                         {\r
501                                                 // Check if the actual selection is a control (IMG,\r
502                                                 // TABLE, HR, etc...).\r
503 \r
504                                                 var range = sel.getRangeAt(0),\r
505                                                         startContainer = range.startContainer;\r
506 \r
507                                                 if ( startContainer == range.endContainer\r
508                                                         && startContainer.nodeType == 1\r
509                                                         && ( range.endOffset - range.startOffset ) == 1\r
510                                                         && styleObjectElements[ startContainer.childNodes[ range.startOffset ].nodeName.toLowerCase() ] )\r
511                                                 {\r
512                                                         type = CKEDITOR.SELECTION_ELEMENT;\r
513                                                 }\r
514                                         }\r
515 \r
516                                         return ( cache.type = type );\r
517                                 },\r
518 \r
519                 /**\r
520                  * Retrieve the {@link CKEDITOR.dom.range} instances that represent the current selection.\r
521                  * Note: Some browsers returns multiple ranges even on a sequent selection, e.g. Firefox returns\r
522                  * one range for each table cell when one or more table row is selected.\r
523                  * @return {Array}\r
524                  * @example\r
525                  * var ranges = selection.getRanges();\r
526                  * alert(ranges.length);\r
527                  */\r
528                 getRanges : (function ()\r
529                 {\r
530                         var func = CKEDITOR.env.ie ?\r
531                                 ( function()\r
532                                 {\r
533                                         // Finds the container and offset for a specific boundary\r
534                                         // of an IE range.\r
535                                         var getBoundaryInformation = function( range, start )\r
536                                         {\r
537                                                 // Creates a collapsed range at the requested boundary.\r
538                                                 range = range.duplicate();\r
539                                                 range.collapse( start );\r
540 \r
541                                                 // Gets the element that encloses the range entirely.\r
542                                                 var parent = range.parentElement();\r
543                                                 var siblings = parent.childNodes;\r
544 \r
545                                                 var testRange;\r
546 \r
547                                                 for ( var i = 0 ; i < siblings.length ; i++ )\r
548                                                 {\r
549                                                         var child = siblings[ i ];\r
550                                                         if ( child.nodeType == 1 )\r
551                                                         {\r
552                                                                 testRange = range.duplicate();\r
553 \r
554                                                                 testRange.moveToElementText( child );\r
555 \r
556                                                                 var comparisonStart = testRange.compareEndPoints( 'StartToStart', range ),\r
557                                                                         comparisonEnd = testRange.compareEndPoints( 'EndToStart', range );\r
558 \r
559                                                                 testRange.collapse();\r
560 \r
561                                                                 if ( comparisonStart > 0 )\r
562                                                                         break;\r
563                                                                 // When selection stay at the side of certain self-closing elements, e.g. BR,\r
564                                                                 // our comparison will never shows an equality. (#4824)\r
565                                                                 else if ( !comparisonStart\r
566                                                                         || comparisonEnd == 1 && comparisonStart == -1 )\r
567                                                                         return { container : parent, offset : i };\r
568                                                                 else if ( !comparisonEnd )\r
569                                                                         return { container : parent, offset : i + 1 };\r
570 \r
571                                                                 testRange = null;\r
572                                                         }\r
573                                                 }\r
574 \r
575                                                 if ( !testRange )\r
576                                                 {\r
577                                                         testRange = range.duplicate();\r
578                                                         testRange.moveToElementText( parent );\r
579                                                         testRange.collapse( false );\r
580                                                 }\r
581 \r
582                                                 testRange.setEndPoint( 'StartToStart', range );\r
583                                                 // IE report line break as CRLF with range.text but\r
584                                                 // only LF with textnode.nodeValue, normalize them to avoid\r
585                                                 // breaking character counting logic below. (#3949)\r
586                                                 var distance = testRange.text.replace( /(\r\n|\r)/g, '\n' ).length;\r
587 \r
588                                                 try\r
589                                                 {\r
590                                                         while ( distance > 0 )\r
591                                                                 distance -= siblings[ --i ].nodeValue.length;\r
592                                                 }\r
593                                                 // Measurement in IE could be somtimes wrong because of <select> element. (#4611)\r
594                                                 catch( e )\r
595                                                 {\r
596                                                         distance = 0;\r
597                                                 }\r
598 \r
599 \r
600                                                 if ( distance === 0 )\r
601                                                 {\r
602                                                         return {\r
603                                                                 container : parent,\r
604                                                                 offset : i\r
605                                                         };\r
606                                                 }\r
607                                                 else\r
608                                                 {\r
609                                                         return {\r
610                                                                 container : siblings[ i ],\r
611                                                                 offset : -distance\r
612                                                         };\r
613                                                 }\r
614                                         };\r
615 \r
616                                         return function()\r
617                                         {\r
618                                                 // IE doesn't have range support (in the W3C way), so we\r
619                                                 // need to do some magic to transform selections into\r
620                                                 // CKEDITOR.dom.range instances.\r
621 \r
622                                                 var sel = this.getNative(),\r
623                                                         nativeRange = sel && sel.createRange(),\r
624                                                         type = this.getType(),\r
625                                                         range;\r
626 \r
627                                                 if ( !sel )\r
628                                                         return [];\r
629 \r
630                                                 if ( type == CKEDITOR.SELECTION_TEXT )\r
631                                                 {\r
632                                                         range = new CKEDITOR.dom.range( this.document );\r
633 \r
634                                                         var boundaryInfo = getBoundaryInformation( nativeRange, true );\r
635                                                         range.setStart( new CKEDITOR.dom.node( boundaryInfo.container ), boundaryInfo.offset );\r
636 \r
637                                                         boundaryInfo = getBoundaryInformation( nativeRange );\r
638                                                         range.setEnd( new CKEDITOR.dom.node( boundaryInfo.container ), boundaryInfo.offset );\r
639 \r
640                                                         return [ range ];\r
641                                                 }\r
642                                                 else if ( type == CKEDITOR.SELECTION_ELEMENT )\r
643                                                 {\r
644                                                         var retval = [];\r
645 \r
646                                                         for ( var i = 0 ; i < nativeRange.length ; i++ )\r
647                                                         {\r
648                                                                 var element = nativeRange.item( i ),\r
649                                                                         parentElement = element.parentNode,\r
650                                                                         j = 0;\r
651 \r
652                                                                 range = new CKEDITOR.dom.range( this.document );\r
653 \r
654                                                                 for (; j < parentElement.childNodes.length && parentElement.childNodes[j] != element ; j++ )\r
655                                                                 { /*jsl:pass*/ }\r
656 \r
657                                                                 range.setStart( new CKEDITOR.dom.node( parentElement ), j );\r
658                                                                 range.setEnd( new CKEDITOR.dom.node( parentElement ), j + 1 );\r
659                                                                 retval.push( range );\r
660                                                         }\r
661 \r
662                                                         return retval;\r
663                                                 }\r
664 \r
665                                                 return [];\r
666                                         };\r
667                                 })()\r
668                         :\r
669                                 function()\r
670                                 {\r
671 \r
672                                         // On browsers implementing the W3C range, we simply\r
673                                         // tranform the native ranges in CKEDITOR.dom.range\r
674                                         // instances.\r
675 \r
676                                         var ranges = [];\r
677                                         var sel = this.getNative();\r
678 \r
679                                         if ( !sel )\r
680                                                 return [];\r
681 \r
682                                         for ( var i = 0 ; i < sel.rangeCount ; i++ )\r
683                                         {\r
684                                                 var nativeRange = sel.getRangeAt( i );\r
685                                                 var range = new CKEDITOR.dom.range( this.document );\r
686 \r
687                                                 range.setStart( new CKEDITOR.dom.node( nativeRange.startContainer ), nativeRange.startOffset );\r
688                                                 range.setEnd( new CKEDITOR.dom.node( nativeRange.endContainer ), nativeRange.endOffset );\r
689                                                 ranges.push( range );\r
690                                         }\r
691                                         return ranges;\r
692                                 };\r
693 \r
694                         return function( onlyEditables )\r
695                         {\r
696                                 var cache = this._.cache;\r
697                                 if ( cache.ranges && !onlyEditables )\r
698                                         return cache.ranges;\r
699                                 else if ( !cache.ranges )\r
700                                         cache.ranges = new CKEDITOR.dom.rangeList( func.call( this ) );\r
701 \r
702                                 // Split range into multiple by read-only nodes.\r
703                                 if ( onlyEditables )\r
704                                 {\r
705                                         var ranges = cache.ranges;\r
706                                         for ( var i = 0; i < ranges.length; i++ )\r
707                                         {\r
708                                                 var range = ranges[ i ];\r
709 \r
710                                                 // Drop range spans inside one ready-only node.\r
711                                                 var parent = range.getCommonAncestor();\r
712                                                 if ( parent.isReadOnly())\r
713                                                         ranges.splice( i, 1 );\r
714 \r
715                                                 if ( range.collapsed )\r
716                                                         continue;\r
717 \r
718                                                 var startContainer = range.startContainer,\r
719                                                         endContainer = range.endContainer,\r
720                                                         startOffset = range.startOffset,\r
721                                                         endOffset = range.endOffset,\r
722                                                         walkerRange = range.clone();\r
723 \r
724                                                 // Range may start inside a non-editable element, restart range\r
725                                                 // by the end of it.\r
726                                                 var readOnly;\r
727                                                 if ( ( readOnly = startContainer.isReadOnly() ) )\r
728                                                         range.setStartAfter( readOnly );\r
729 \r
730                                                 // Enlarge range start/end with text node to avoid walker\r
731                                                 // being DOM destructive, it doesn't interfere our checking\r
732                                                 // of elements below as well.\r
733                                                 if ( startContainer && startContainer.type == CKEDITOR.NODE_TEXT )\r
734                                                 {\r
735                                                         if ( startOffset >= startContainer.getLength() )\r
736                                                                 walkerRange.setStartAfter( startContainer );\r
737                                                         else\r
738                                                                 walkerRange.setStartBefore( startContainer );\r
739                                                 }\r
740 \r
741                                                 if ( endContainer && endContainer.type == CKEDITOR.NODE_TEXT )\r
742                                                 {\r
743                                                         if ( !endOffset )\r
744                                                                 walkerRange.setEndBefore( endContainer );\r
745                                                         else\r
746                                                                 walkerRange.setEndAfter( endContainer );\r
747                                                 }\r
748 \r
749                                                 // Looking for non-editable element inside the range.\r
750                                                 var walker = new CKEDITOR.dom.walker( walkerRange );\r
751                                                 walker.evaluator = function( node )\r
752                                                 {\r
753                                                         if ( node.type == CKEDITOR.NODE_ELEMENT\r
754                                                                 && node.getAttribute( 'contenteditable' ) == 'false' )\r
755                                                         {\r
756                                                                 var newRange = range.clone();\r
757                                                                 range.setEndBefore( node );\r
758 \r
759                                                                 // Drop collapsed range around read-only elements,\r
760                                                                 // it make sure the range list empty when selecting\r
761                                                                 // only non-editable elements.\r
762                                                                 if ( range.collapsed )\r
763                                                                         ranges.splice( i--, 1 );\r
764 \r
765                                                                 // Avoid creating invalid range.\r
766                                                                 if ( !( node.getPosition( walkerRange.endContainer ) & CKEDITOR.POSITION_CONTAINS ) )\r
767                                                                 {\r
768                                                                         newRange.setStartAfter( node );\r
769                                                                         if ( !newRange.collapsed )\r
770                                                                                 ranges.splice( i + 1, 0, newRange );\r
771                                                                 }\r
772 \r
773                                                                 return true;\r
774                                                         }\r
775 \r
776                                                         return false;\r
777                                                 };\r
778 \r
779                                                 walker.next();\r
780                                         }\r
781                                 }\r
782 \r
783                                 return cache.ranges;\r
784                         };\r
785                 })(),\r
786 \r
787                 /**\r
788                  * Gets the DOM element in which the selection starts.\r
789                  * @returns {CKEDITOR.dom.element} The element at the beginning of the\r
790                  *              selection.\r
791                  * @example\r
792                  * var element = editor.getSelection().<b>getStartElement()</b>;\r
793                  * alert( element.getName() );\r
794                  */\r
795                 getStartElement : function()\r
796                 {\r
797                         var cache = this._.cache;\r
798                         if ( cache.startElement !== undefined )\r
799                                 return cache.startElement;\r
800 \r
801                         var node,\r
802                                 sel = this.getNative();\r
803 \r
804                         switch ( this.getType() )\r
805                         {\r
806                                 case CKEDITOR.SELECTION_ELEMENT :\r
807                                         return this.getSelectedElement();\r
808 \r
809                                 case CKEDITOR.SELECTION_TEXT :\r
810 \r
811                                         var range = this.getRanges()[0];\r
812 \r
813                                         if ( range )\r
814                                         {\r
815                                                 if ( !range.collapsed )\r
816                                                 {\r
817                                                         range.optimize();\r
818 \r
819                                                         // Decrease the range content to exclude particial\r
820                                                         // selected node on the start which doesn't have\r
821                                                         // visual impact. ( #3231 )\r
822                                                         while ( true )\r
823                                                         {\r
824                                                                 var startContainer = range.startContainer,\r
825                                                                         startOffset = range.startOffset;\r
826                                                                 // Limit the fix only to non-block elements.(#3950)\r
827                                                                 if ( startOffset == ( startContainer.getChildCount ?\r
828                                                                          startContainer.getChildCount() : startContainer.getLength() )\r
829                                                                          && !startContainer.isBlockBoundary() )\r
830                                                                         range.setStartAfter( startContainer );\r
831                                                                 else break;\r
832                                                         }\r
833 \r
834                                                         node = range.startContainer;\r
835 \r
836                                                         if ( node.type != CKEDITOR.NODE_ELEMENT )\r
837                                                                 return node.getParent();\r
838 \r
839                                                         node = node.getChild( range.startOffset );\r
840 \r
841                                                         if ( !node || node.type != CKEDITOR.NODE_ELEMENT )\r
842                                                                 return range.startContainer;\r
843 \r
844                                                         var child = node.getFirst();\r
845                                                         while (  child && child.type == CKEDITOR.NODE_ELEMENT )\r
846                                                         {\r
847                                                                 node = child;\r
848                                                                 child = child.getFirst();\r
849                                                         }\r
850 \r
851                                                         return node;\r
852                                                 }\r
853                                         }\r
854 \r
855                                         if ( CKEDITOR.env.ie )\r
856                                         {\r
857                                                 range = sel.createRange();\r
858                                                 range.collapse( true );\r
859 \r
860                                                 node = range.parentElement();\r
861                                         }\r
862                                         else\r
863                                         {\r
864                                                 node = sel.anchorNode;\r
865 \r
866                                                 if ( node && node.nodeType != 1 )\r
867                                                         node = node.parentNode;\r
868                                         }\r
869                         }\r
870 \r
871                         return cache.startElement = ( node ? new CKEDITOR.dom.element( node ) : null );\r
872                 },\r
873 \r
874                 /**\r
875                  * Gets the current selected element.\r
876                  * @returns {CKEDITOR.dom.element} The selected element. Null if no\r
877                  *              selection is available or the selection type is not\r
878                  *              {@link CKEDITOR.SELECTION_ELEMENT}.\r
879                  * @example\r
880                  * var element = editor.getSelection().<b>getSelectedElement()</b>;\r
881                  * alert( element.getName() );\r
882                  */\r
883                 getSelectedElement : function()\r
884                 {\r
885                         var cache = this._.cache;\r
886                         if ( cache.selectedElement !== undefined )\r
887                                 return cache.selectedElement;\r
888 \r
889                         var self = this;\r
890 \r
891                         var node = CKEDITOR.tools.tryThese(\r
892                                 // Is it native IE control type selection?\r
893                                 function()\r
894                                 {\r
895                                         return self.getNative().createRange().item( 0 );\r
896                                 },\r
897                                 // Figure it out by checking if there's a single enclosed\r
898                                 // node of the range.\r
899                                 function()\r
900                                 {\r
901                                         var range  = self.getRanges()[ 0 ],\r
902                                                 enclosed,\r
903                                                 selected;\r
904 \r
905                                         // Check first any enclosed element, e.g. <ul>[<li><a href="#">item</a></li>]</ul>\r
906                                         for ( var i = 2; i && !( ( enclosed = range.getEnclosedNode() )\r
907                                                 && ( enclosed.type == CKEDITOR.NODE_ELEMENT )\r
908                                                 && styleObjectElements[ enclosed.getName() ]\r
909                                                 && ( selected = enclosed ) ); i-- )\r
910                                         {\r
911                                                 // Then check any deep wrapped element, e.g. [<b><i><img /></i></b>]\r
912                                                 range.shrink( CKEDITOR.SHRINK_ELEMENT );\r
913                                         }\r
914 \r
915                                         return  selected.$;\r
916                                 });\r
917 \r
918                         return cache.selectedElement = ( node ? new CKEDITOR.dom.element( node ) : null );\r
919                 },\r
920 \r
921                 lock : function()\r
922                 {\r
923                         // Call all cacheable function.\r
924                         this.getRanges();\r
925                         this.getStartElement();\r
926                         this.getSelectedElement();\r
927 \r
928                         // The native selection is not available when locked.\r
929                         this._.cache.nativeSel = {};\r
930 \r
931                         this.isLocked = true;\r
932 \r
933                         // Save this selection inside the DOM document.\r
934                         this.document.setCustomData( 'cke_locked_selection', this );\r
935                 },\r
936 \r
937                 unlock : function( restore )\r
938                 {\r
939                         var doc = this.document,\r
940                                 lockedSelection = doc.getCustomData( 'cke_locked_selection' );\r
941 \r
942                         if ( lockedSelection )\r
943                         {\r
944                                 doc.setCustomData( 'cke_locked_selection', null );\r
945 \r
946                                 if ( restore )\r
947                                 {\r
948                                         var selectedElement = lockedSelection.getSelectedElement(),\r
949                                                 ranges = !selectedElement && lockedSelection.getRanges();\r
950 \r
951                                         this.isLocked = false;\r
952                                         this.reset();\r
953 \r
954                                         doc.getBody().focus();\r
955 \r
956                                         if ( selectedElement )\r
957                                                 this.selectElement( selectedElement );\r
958                                         else\r
959                                                 this.selectRanges( ranges );\r
960                                 }\r
961                         }\r
962 \r
963                         if  ( !lockedSelection || !restore )\r
964                         {\r
965                                 this.isLocked = false;\r
966                                 this.reset();\r
967                         }\r
968                 },\r
969 \r
970                 reset : function()\r
971                 {\r
972                         this._.cache = {};\r
973                 },\r
974 \r
975                 /**\r
976                  *  Make the current selection of type {@link CKEDITOR.SELECTION_ELEMENT} by enclosing the specified element.\r
977                  * @param element\r
978                  */\r
979                 selectElement : function( element )\r
980                 {\r
981                         if ( this.isLocked )\r
982                         {\r
983                                 var range = new CKEDITOR.dom.range( this.document );\r
984                                 range.setStartBefore( element );\r
985                                 range.setEndAfter( element );\r
986 \r
987                                 this._.cache.selectedElement = element;\r
988                                 this._.cache.startElement = element;\r
989                                 this._.cache.ranges = new CKEDITOR.dom.rangeList( range );\r
990                                 this._.cache.type = CKEDITOR.SELECTION_ELEMENT;\r
991 \r
992                                 return;\r
993                         }\r
994 \r
995                         if ( CKEDITOR.env.ie )\r
996                         {\r
997                                 this.getNative().empty();\r
998 \r
999                                 try\r
1000                                 {\r
1001                                         // Try to select the node as a control.\r
1002                                         range = this.document.$.body.createControlRange();\r
1003                                         range.addElement( element.$ );\r
1004                                         range.select();\r
1005                                 }\r
1006                                 catch(e)\r
1007                                 {\r
1008                                         // If failed, select it as a text range.\r
1009                                         range = this.document.$.body.createTextRange();\r
1010                                         range.moveToElementText( element.$ );\r
1011                                         range.select();\r
1012                                 }\r
1013                                 finally\r
1014                                 {\r
1015                                         this.document.fire( 'selectionchange' );\r
1016                                 }\r
1017 \r
1018                                 this.reset();\r
1019                         }\r
1020                         else\r
1021                         {\r
1022                                 // Create the range for the element.\r
1023                                 range = this.document.$.createRange();\r
1024                                 range.selectNode( element.$ );\r
1025 \r
1026                                 // Select the range.\r
1027                                 var sel = this.getNative();\r
1028                                 sel.removeAllRanges();\r
1029                                 sel.addRange( range );\r
1030 \r
1031                                 this.reset();\r
1032                         }\r
1033                 },\r
1034 \r
1035                 /**\r
1036                  *  Adding the specified ranges to document selection preceding\r
1037                  * by clearing up the original selection.\r
1038                  * @param {CKEDITOR.dom.range} ranges\r
1039                  */\r
1040                 selectRanges : function( ranges )\r
1041                 {\r
1042                         if ( this.isLocked )\r
1043                         {\r
1044                                 this._.cache.selectedElement = null;\r
1045                                 this._.cache.startElement = ranges[ 0 ] && ranges[ 0 ].getTouchedStartNode();\r
1046                                 this._.cache.ranges = new CKEDITOR.dom.rangeList( ranges );\r
1047                                 this._.cache.type = CKEDITOR.SELECTION_TEXT;\r
1048 \r
1049                                 return;\r
1050                         }\r
1051 \r
1052                         if ( CKEDITOR.env.ie )\r
1053                         {\r
1054                                 if ( ranges.length > 1 )\r
1055                                 {\r
1056                                         // IE doesn't accept multiple ranges selection, so we join all into one.\r
1057                                         var last = ranges[ ranges.length -1 ] ;\r
1058                                         ranges[ 0 ].setEnd( last.endContainer, last.endOffset );\r
1059                                         ranges.length = 1;\r
1060                                 }\r
1061 \r
1062                                 if ( ranges[ 0 ] )\r
1063                                         ranges[ 0 ].select();\r
1064 \r
1065                                 this.reset();\r
1066                         }\r
1067                         else\r
1068                         {\r
1069                                 var sel = this.getNative();\r
1070 \r
1071                                 if ( ranges.length )\r
1072                                         sel.removeAllRanges();\r
1073 \r
1074                                 for ( var i = 0 ; i < ranges.length ; i++ )\r
1075                                 {\r
1076                                         // Joining sequential ranges introduced by\r
1077                                         // readonly elements protection.\r
1078                                         if ( i < ranges.length -1 )\r
1079                                         {\r
1080                                                 var left = ranges[ i ], right = ranges[ i +1 ],\r
1081                                                                 between = left.clone();\r
1082                                                 between.setStart( left.endContainer, left.endOffset );\r
1083                                                 between.setEnd( right.startContainer, right.startOffset );\r
1084 \r
1085                                                 // Don't confused by Firefox adjancent multi-ranges\r
1086                                                 // introduced by table cells selection.\r
1087                                                 if ( !between.collapsed )\r
1088                                                 {\r
1089                                                         between.shrink( CKEDITOR.NODE_ELEMENT, true );\r
1090                                                         if ( between.getCommonAncestor().isReadOnly())\r
1091                                                         {\r
1092                                                                 right.setStart( left.startContainer, left.startOffset );\r
1093                                                                 ranges.splice( i--, 1 );\r
1094                                                                 continue;\r
1095                                                         }\r
1096                                                 }\r
1097                                         }\r
1098 \r
1099                                         var range = ranges[ i ];\r
1100                                         var nativeRange = this.document.$.createRange();\r
1101                                         var startContainer = range.startContainer;\r
1102 \r
1103                                         // In FF2, if we have a collapsed range, inside an empty\r
1104                                         // element, we must add something to it otherwise the caret\r
1105                                         // will not be visible.\r
1106                                         if ( range.collapsed &&\r
1107                                                 ( CKEDITOR.env.gecko && CKEDITOR.env.version < 10900 ) &&\r
1108                                                 startContainer.type == CKEDITOR.NODE_ELEMENT &&\r
1109                                                 !startContainer.getChildCount() )\r
1110                                         {\r
1111                                                 startContainer.appendText( '' );\r
1112                                         }\r
1113 \r
1114                                         nativeRange.setStart( startContainer.$, range.startOffset );\r
1115                                         nativeRange.setEnd( range.endContainer.$, range.endOffset );\r
1116 \r
1117                                         // Select the range.\r
1118                                         sel.addRange( nativeRange );\r
1119                                 }\r
1120 \r
1121                                 this.reset();\r
1122                         }\r
1123                 },\r
1124 \r
1125                 /**\r
1126                  *  Create bookmark for every single of this selection range (from #getRanges)\r
1127                  * by calling the {@link CKEDITOR.dom.range.prototype.createBookmark} method,\r
1128                  * with extra cares to avoid interferon among those ranges. Same arguments are\r
1129                  * received as with the underlay range method.\r
1130                  */\r
1131                 createBookmarks : function( serializable )\r
1132                 {\r
1133                         return this.getRanges().createBookmarks( serializable );\r
1134                 },\r
1135 \r
1136                 /**\r
1137                  *  Create bookmark for every single of this selection range (from #getRanges)\r
1138                  * by calling the {@link CKEDITOR.dom.range.prototype.createBookmark2} method,\r
1139                  * with extra cares to avoid interferon among those ranges. Same arguments are\r
1140                  * received as with the underlay range method.\r
1141                  */\r
1142                 createBookmarks2 : function( normalized )\r
1143                 {\r
1144                         return this.getRanges().createBookmarks2( normalized );\r
1145                 },\r
1146 \r
1147                 /**\r
1148                  * Select the virtual ranges denote by the bookmarks by calling #selectRanges.\r
1149                  * @param bookmarks\r
1150                  */\r
1151                 selectBookmarks : function( bookmarks )\r
1152                 {\r
1153                         var ranges = [];\r
1154                         for ( var i = 0 ; i < bookmarks.length ; i++ )\r
1155                         {\r
1156                                 var range = new CKEDITOR.dom.range( this.document );\r
1157                                 range.moveToBookmark( bookmarks[i] );\r
1158                                 ranges.push( range );\r
1159                         }\r
1160                         this.selectRanges( ranges );\r
1161                         return this;\r
1162                 },\r
1163 \r
1164                 /**\r
1165                  * Retrieve the common ancestor node of the first range and the last range.\r
1166                  */\r
1167                 getCommonAncestor : function()\r
1168                 {\r
1169                         var ranges = this.getRanges(),\r
1170                                 startNode = ranges[ 0 ].startContainer,\r
1171                                 endNode = ranges[ ranges.length - 1 ].endContainer;\r
1172                         return startNode.getCommonAncestor( endNode );\r
1173                 },\r
1174 \r
1175                 /**\r
1176                  * Moving scroll bar to the current selection's start position.\r
1177                  */\r
1178                 scrollIntoView : function()\r
1179                 {\r
1180                         // If we have split the block, adds a temporary span at the\r
1181                         // range position and scroll relatively to it.\r
1182                         var start = this.getStartElement();\r
1183                         start.scrollIntoView();\r
1184                 }\r
1185         };\r
1186 })();\r
1187 \r
1188 ( function()\r
1189 {\r
1190         var notWhitespaces = CKEDITOR.dom.walker.whitespaces( true ),\r
1191                         fillerTextRegex = /\ufeff|\u00a0/,\r
1192                         nonCells = { table:1,tbody:1,tr:1 };\r
1193 \r
1194         CKEDITOR.dom.range.prototype.select =\r
1195                 CKEDITOR.env.ie ?\r
1196                         // V2\r
1197                         function( forceExpand )\r
1198                         {\r
1199                                 var collapsed = this.collapsed;\r
1200                                 var isStartMarkerAlone;\r
1201                                 var dummySpan;\r
1202 \r
1203                                 // IE doesn't support selecting the entire table row/cell, move the selection into cells, e.g.\r
1204                                 // <table><tbody><tr>[<td>cell</b></td>... => <table><tbody><tr><td>[cell</td>...\r
1205                                 if ( this.startContainer.type == CKEDITOR.NODE_ELEMENT && this.startContainer.getName() in nonCells\r
1206                                         || this.endContainer.type == CKEDITOR.NODE_ELEMENT && this.endContainer.getName() in nonCells )\r
1207                                 {\r
1208                                         this.shrink( CKEDITOR.NODE_ELEMENT, true );\r
1209                                 }\r
1210 \r
1211                                 var bookmark = this.createBookmark();\r
1212 \r
1213                                 // Create marker tags for the start and end boundaries.\r
1214                                 var startNode = bookmark.startNode;\r
1215 \r
1216                                 var endNode;\r
1217                                 if ( !collapsed )\r
1218                                         endNode = bookmark.endNode;\r
1219 \r
1220                                 // Create the main range which will be used for the selection.\r
1221                                 var ieRange = this.document.$.body.createTextRange();\r
1222 \r
1223                                 // Position the range at the start boundary.\r
1224                                 ieRange.moveToElementText( startNode.$ );\r
1225                                 ieRange.moveStart( 'character', 1 );\r
1226 \r
1227                                 if ( endNode )\r
1228                                 {\r
1229                                         // Create a tool range for the end.\r
1230                                         var ieRangeEnd = this.document.$.body.createTextRange();\r
1231 \r
1232                                         // Position the tool range at the end.\r
1233                                         ieRangeEnd.moveToElementText( endNode.$ );\r
1234 \r
1235                                         // Move the end boundary of the main range to match the tool range.\r
1236                                         ieRange.setEndPoint( 'EndToEnd', ieRangeEnd );\r
1237                                         ieRange.moveEnd( 'character', -1 );\r
1238                                 }\r
1239                                 else\r
1240                                 {\r
1241                                         // The isStartMarkerAlone logic comes from V2. It guarantees that the lines\r
1242                                         // will expand and that the cursor will be blinking on the right place.\r
1243                                         // Actually, we are using this flag just to avoid using this hack in all\r
1244                                         // situations, but just on those needed.\r
1245                                         var next = startNode.getNext( notWhitespaces );\r
1246                                         isStartMarkerAlone = ( !( next && next.getText && next.getText().match( fillerTextRegex ) )     // already a filler there?\r
1247                                                                                   && ( forceExpand || !startNode.hasPrevious() || ( startNode.getPrevious().is && startNode.getPrevious().is( 'br' ) ) ) );\r
1248 \r
1249                                         // Append a temporary <span>&#65279;</span> before the selection.\r
1250                                         // This is needed to avoid IE destroying selections inside empty\r
1251                                         // inline elements, like <b></b> (#253).\r
1252                                         // It is also needed when placing the selection right after an inline\r
1253                                         // element to avoid the selection moving inside of it.\r
1254                                         dummySpan = this.document.createElement( 'span' );\r
1255                                         dummySpan.setHtml( '&#65279;' );        // Zero Width No-Break Space (U+FEFF). See #1359.\r
1256                                         dummySpan.insertBefore( startNode );\r
1257 \r
1258                                         if ( isStartMarkerAlone )\r
1259                                         {\r
1260                                                 // To expand empty blocks or line spaces after <br>, we need\r
1261                                                 // instead to have any char, which will be later deleted using the\r
1262                                                 // selection.\r
1263                                                 // \ufeff = Zero Width No-Break Space (U+FEFF). (#1359)\r
1264                                                 this.document.createText( '\ufeff' ).insertBefore( startNode );\r
1265                                         }\r
1266                                 }\r
1267 \r
1268                                 // Remove the markers (reset the position, because of the changes in the DOM tree).\r
1269                                 this.setStartBefore( startNode );\r
1270                                 startNode.remove();\r
1271 \r
1272                                 if ( collapsed )\r
1273                                 {\r
1274                                         if ( isStartMarkerAlone )\r
1275                                         {\r
1276                                                 // Move the selection start to include the temporary \ufeff.\r
1277                                                 ieRange.moveStart( 'character', -1 );\r
1278 \r
1279                                                 ieRange.select();\r
1280 \r
1281                                                 // Remove our temporary stuff.\r
1282                                                 this.document.$.selection.clear();\r
1283                                         }\r
1284                                         else\r
1285                                                 ieRange.select();\r
1286 \r
1287                                         this.moveToPosition( dummySpan, CKEDITOR.POSITION_BEFORE_START );\r
1288                                         dummySpan.remove();\r
1289                                 }\r
1290                                 else\r
1291                                 {\r
1292                                         this.setEndBefore( endNode );\r
1293                                         endNode.remove();\r
1294                                         ieRange.select();\r
1295                                 }\r
1296 \r
1297                                 this.document.fire( 'selectionchange' );\r
1298                         }\r
1299                 :\r
1300                         function()\r
1301                         {\r
1302                                 var startContainer = this.startContainer;\r
1303 \r
1304                                 // If we have a collapsed range, inside an empty element, we must add\r
1305                                 // something to it, otherwise the caret will not be visible.\r
1306                                 if ( this.collapsed && startContainer.type == CKEDITOR.NODE_ELEMENT && !startContainer.getChildCount() )\r
1307                                         startContainer.append( new CKEDITOR.dom.text( '' ) );\r
1308 \r
1309                                 var nativeRange = this.document.$.createRange();\r
1310                                 nativeRange.setStart( startContainer.$, this.startOffset );\r
1311 \r
1312                                 try\r
1313                                 {\r
1314                                         nativeRange.setEnd( this.endContainer.$, this.endOffset );\r
1315                                 }\r
1316                                 catch ( e )\r
1317                                 {\r
1318                                         // There is a bug in Firefox implementation (it would be too easy\r
1319                                         // otherwise). The new start can't be after the end (W3C says it can).\r
1320                                         // So, let's create a new range and collapse it to the desired point.\r
1321                                         if ( e.toString().indexOf( 'NS_ERROR_ILLEGAL_VALUE' ) >= 0 )\r
1322                                         {\r
1323                                                 this.collapse( true );\r
1324                                                 nativeRange.setEnd( this.endContainer.$, this.endOffset );\r
1325                                         }\r
1326                                         else\r
1327                                                 throw( e );\r
1328                                 }\r
1329 \r
1330                                 var selection = this.document.getSelection().getNative();\r
1331                                 selection.removeAllRanges();\r
1332                                 selection.addRange( nativeRange );\r
1333                         };\r
1334 } )();\r