2 Copyright (c) 2003-2010, CKSource - Frederico Knabben. All rights reserved.
\r
3 For licensing, see LICENSE.html or http://ckeditor.com/license
\r
10 editorFocus : false,
\r
11 modes : { wysiwyg:1, source:1 }
\r
16 exec : function( editor )
\r
18 editor.container.focusNext( true, editor.tabIndex );
\r
22 var blurBackCommand =
\r
24 exec : function( editor )
\r
26 editor.container.focusPrevious( true, editor.tabIndex );
\r
30 CKEDITOR.plugins.add( 'tab',
\r
32 requires : [ 'keystrokes' ],
\r
34 init : function( editor )
\r
36 var tabSpaces = editor.config.tabSpaces || 0,
\r
39 while ( tabSpaces-- )
\r
44 editor.on( 'key', function( ev )
\r
46 if ( ev.data.keyCode == 9 ) // TAB
\r
48 editor.insertHtml( tabText );
\r
54 if ( CKEDITOR.env.webkit )
\r
56 editor.on( 'key', function( ev )
\r
58 var keyCode = ev.data.keyCode;
\r
60 if ( keyCode == 9 && !tabText ) // TAB
\r
63 editor.execCommand( 'blur' );
\r
66 if ( keyCode == ( CKEDITOR.SHIFT + 9 ) ) // SHIFT+TAB
\r
68 editor.execCommand( 'blurBack' );
\r
74 editor.addCommand( 'blur', CKEDITOR.tools.extend( blurCommand, meta ) );
\r
75 editor.addCommand( 'blurBack', CKEDITOR.tools.extend( blurBackCommand, meta ) );
\r
81 * Moves the UI focus to the element following this element in the tabindex
\r
84 * var element = CKEDITOR.document.getById( 'example' );
\r
85 * element.focusNext();
\r
87 CKEDITOR.dom.element.prototype.focusNext = function( ignoreChildren, indexToUse )
\r
90 curTabIndex = ( indexToUse === undefined ? this.getTabIndex() : indexToUse ),
\r
91 passedCurrent, enteredCurrent,
\r
92 elected, electedTabIndex,
\r
93 element, elementTabIndex;
\r
95 if ( curTabIndex <= 0 )
\r
97 // If this element has tabindex <= 0 then we must simply look for any
\r
98 // element following it containing tabindex=0.
\r
100 element = this.getNextSourceNode( ignoreChildren, CKEDITOR.NODE_ELEMENT );
\r
104 if ( element.isVisible() && element.getTabIndex() === 0 )
\r
110 element = element.getNextSourceNode( false, CKEDITOR.NODE_ELEMENT );
\r
115 // If this element has tabindex > 0 then we must look for:
\r
116 // 1. An element following this element with the same tabindex.
\r
117 // 2. The first element in source other with the lowest tabindex
\r
118 // that is higher than this element tabindex.
\r
119 // 3. The first element with tabindex=0.
\r
121 element = this.getDocument().getBody().getFirst();
\r
123 while ( ( element = element.getNextSourceNode( false, CKEDITOR.NODE_ELEMENT ) ) )
\r
125 if ( !passedCurrent )
\r
127 if ( !enteredCurrent && element.equals( this ) )
\r
129 enteredCurrent = true;
\r
131 // Ignore this element, if required.
\r
132 if ( ignoreChildren )
\r
134 if ( !( element = element.getNextSourceNode( true, CKEDITOR.NODE_ELEMENT ) ) )
\r
139 else if ( enteredCurrent && !this.contains( element ) )
\r
143 if ( !element.isVisible() || ( elementTabIndex = element.getTabIndex() ) < 0 )
\r
146 if ( passedCurrent && elementTabIndex == curTabIndex )
\r
152 if ( elementTabIndex > curTabIndex && ( !elected || !electedTabIndex || elementTabIndex < electedTabIndex ) )
\r
155 electedTabIndex = elementTabIndex;
\r
157 else if ( !elected && elementTabIndex === 0 )
\r
160 electedTabIndex = elementTabIndex;
\r
170 * Moves the UI focus to the element before this element in the tabindex order.
\r
172 * var element = CKEDITOR.document.getById( 'example' );
\r
173 * element.focusPrevious();
\r
175 CKEDITOR.dom.element.prototype.focusPrevious = function( ignoreChildren, indexToUse )
\r
178 curTabIndex = ( indexToUse === undefined ? this.getTabIndex() : indexToUse ),
\r
179 passedCurrent, enteredCurrent,
\r
181 electedTabIndex = 0,
\r
184 var element = this.getDocument().getBody().getLast();
\r
186 while ( ( element = element.getPreviousSourceNode( false, CKEDITOR.NODE_ELEMENT ) ) )
\r
188 if ( !passedCurrent )
\r
190 if ( !enteredCurrent && element.equals( this ) )
\r
192 enteredCurrent = true;
\r
194 // Ignore this element, if required.
\r
195 if ( ignoreChildren )
\r
197 if ( !( element = element.getPreviousSourceNode( true, CKEDITOR.NODE_ELEMENT ) ) )
\r
202 else if ( enteredCurrent && !this.contains( element ) )
\r
206 if ( !element.isVisible() || ( elementTabIndex = element.getTabIndex() ) < 0 )
\r
209 if ( curTabIndex <= 0 )
\r
211 // If this element has tabindex <= 0 then we must look for:
\r
212 // 1. An element before this one containing tabindex=0.
\r
213 // 2. The last element with the highest tabindex.
\r
215 if ( passedCurrent && elementTabIndex === 0 )
\r
221 if ( elementTabIndex > electedTabIndex )
\r
224 electedTabIndex = elementTabIndex;
\r
229 // If this element has tabindex > 0 we must look for:
\r
230 // 1. An element preceeding this one, with the same tabindex.
\r
231 // 2. The last element in source other with the highest tabindex
\r
232 // that is lower than this element tabindex.
\r
234 if ( passedCurrent && elementTabIndex == curTabIndex )
\r
240 if ( elementTabIndex < curTabIndex && ( !elected || elementTabIndex > electedTabIndex ) )
\r
243 electedTabIndex = elementTabIndex;
\r
253 * Intructs the editor to add a number of spaces (&nbsp;) to the text when
\r
254 * hitting the TAB key. If set to zero, the TAB key will be used to move the
\r
255 * cursor focus to the next element in the page, out of the editor focus.
\r
256 * @name CKEDITOR.config.tabSpaces
\r
260 * config.tabSpaces = 4;
\r