--- /dev/null
+/*\r
+Copyright (c) 2003-2011, CKSource - Frederico Knabben. All rights reserved.\r
+For licensing, see LICENSE.html or http://ckeditor.com/license\r
+*/\r
+\r
+(function()\r
+{\r
+ var meta =\r
+ {\r
+ editorFocus : false,\r
+ modes : { wysiwyg:1, source:1 }\r
+ };\r
+\r
+ var blurCommand =\r
+ {\r
+ exec : function( editor )\r
+ {\r
+ editor.container.focusNext( true, editor.tabIndex );\r
+ }\r
+ };\r
+\r
+ var blurBackCommand =\r
+ {\r
+ exec : function( editor )\r
+ {\r
+ editor.container.focusPrevious( true, editor.tabIndex );\r
+ }\r
+ };\r
+\r
+ function selectNextCellCommand( backward )\r
+ {\r
+ return {\r
+ editorFocus : false,\r
+ canUndo : false,\r
+ modes : { wysiwyg : 1 },\r
+ exec : function( editor )\r
+ {\r
+ if ( editor.focusManager.hasFocus )\r
+ {\r
+ var sel = editor.getSelection(),\r
+ ancestor = sel.getCommonAncestor(),\r
+ cell;\r
+\r
+ if ( ( cell = ( ancestor.getAscendant( 'td', true ) || ancestor.getAscendant( 'th', true ) ) ) )\r
+ {\r
+ var resultRange = new CKEDITOR.dom.range( editor.document ),\r
+ next = CKEDITOR.tools.tryThese( function()\r
+ {\r
+ var row = cell.getParent(),\r
+ next = row.$.cells[ cell.$.cellIndex + ( backward ? - 1 : 1 ) ];\r
+\r
+ // Invalid any empty value.\r
+ next.parentNode.parentNode;\r
+ return next;\r
+ },\r
+ function()\r
+ {\r
+ var row = cell.getParent(),\r
+ table = row.getAscendant( 'table' ),\r
+ nextRow = table.$.rows[ row.$.rowIndex + ( backward ? - 1 : 1 ) ];\r
+\r
+ return nextRow.cells[ backward? nextRow.cells.length -1 : 0 ];\r
+ });\r
+\r
+ // Clone one more row at the end of table and select the first newly established cell.\r
+ if ( ! ( next || backward ) )\r
+ {\r
+ var table = cell.getAscendant( 'table' ).$,\r
+ cells = cell.getParent().$.cells;\r
+\r
+ var newRow = new CKEDITOR.dom.element( table.insertRow( -1 ), editor.document );\r
+\r
+ for ( var i = 0, count = cells.length ; i < count; i++ )\r
+ {\r
+ var newCell = newRow.append( new CKEDITOR.dom.element(\r
+ cells[ i ], editor.document ).clone( false, false ) );\r
+ !CKEDITOR.env.ie && newCell.appendBogus();\r
+ }\r
+\r
+ resultRange.moveToElementEditStart( newRow );\r
+ }\r
+ else if ( next )\r
+ {\r
+ next = new CKEDITOR.dom.element( next );\r
+ resultRange.moveToElementEditStart( next );\r
+ // Avoid selecting empty block makes the cursor blind.\r
+ if ( !( resultRange.checkStartOfBlock() && resultRange.checkEndOfBlock() ) )\r
+ resultRange.selectNodeContents( next );\r
+ }\r
+ else\r
+ return true;\r
+\r
+ resultRange.select( true );\r
+ return true;\r
+ }\r
+ }\r
+ return false;\r
+ }\r
+ };\r
+ }\r
+\r
+ CKEDITOR.plugins.add( 'tab',\r
+ {\r
+ requires : [ 'keystrokes' ],\r
+\r
+ init : function( editor )\r
+ {\r
+ var tabTools = editor.config.enableTabKeyTools !== false,\r
+ tabSpaces = editor.config.tabSpaces || 0,\r
+ tabText = '';\r
+\r
+ while ( tabSpaces-- )\r
+ tabText += '\xa0';\r
+\r
+ if ( tabText )\r
+ {\r
+ editor.on( 'key', function( ev )\r
+ {\r
+ if ( ev.data.keyCode == 9 ) // TAB\r
+ {\r
+ editor.insertHtml( tabText );\r
+ ev.cancel();\r
+ }\r
+ });\r
+ }\r
+\r
+ if ( tabTools )\r
+ {\r
+ editor.on( 'key', function( ev )\r
+ {\r
+ if ( ev.data.keyCode == 9 && editor.execCommand( 'selectNextCell' ) || // TAB\r
+ ev.data.keyCode == ( CKEDITOR.SHIFT + 9 ) && editor.execCommand( 'selectPreviousCell' ) ) // SHIFT+TAB\r
+ ev.cancel();\r
+ });\r
+ }\r
+\r
+ if ( CKEDITOR.env.webkit || CKEDITOR.env.gecko )\r
+ {\r
+ editor.on( 'key', function( ev )\r
+ {\r
+ var keyCode = ev.data.keyCode;\r
+\r
+ if ( keyCode == 9 && !tabText ) // TAB\r
+ {\r
+ ev.cancel();\r
+ editor.execCommand( 'blur' );\r
+ }\r
+\r
+ if ( keyCode == ( CKEDITOR.SHIFT + 9 ) ) // SHIFT+TAB\r
+ {\r
+ editor.execCommand( 'blurBack' );\r
+ ev.cancel();\r
+ }\r
+ });\r
+ }\r
+\r
+ editor.addCommand( 'blur', CKEDITOR.tools.extend( blurCommand, meta ) );\r
+ editor.addCommand( 'blurBack', CKEDITOR.tools.extend( blurBackCommand, meta ) );\r
+ editor.addCommand( 'selectNextCell', selectNextCellCommand() );\r
+ editor.addCommand( 'selectPreviousCell', selectNextCellCommand( true ) );\r
+ }\r
+ });\r
+})();\r
+\r
+/**\r
+ * Moves the UI focus to the element following this element in the tabindex\r
+ * order.\r
+ * @example\r
+ * var element = CKEDITOR.document.getById( 'example' );\r
+ * element.focusNext();\r
+ */\r
+CKEDITOR.dom.element.prototype.focusNext = function( ignoreChildren, indexToUse )\r
+{\r
+ var $ = this.$,\r
+ curTabIndex = ( indexToUse === undefined ? this.getTabIndex() : indexToUse ),\r
+ passedCurrent, enteredCurrent,\r
+ elected, electedTabIndex,\r
+ element, elementTabIndex;\r
+\r
+ if ( curTabIndex <= 0 )\r
+ {\r
+ // If this element has tabindex <= 0 then we must simply look for any\r
+ // element following it containing tabindex=0.\r
+\r
+ element = this.getNextSourceNode( ignoreChildren, CKEDITOR.NODE_ELEMENT );\r
+\r
+ while ( element )\r
+ {\r
+ if ( element.isVisible() && element.getTabIndex() === 0 )\r
+ {\r
+ elected = element;\r
+ break;\r
+ }\r
+\r
+ element = element.getNextSourceNode( false, CKEDITOR.NODE_ELEMENT );\r
+ }\r
+ }\r
+ else\r
+ {\r
+ // If this element has tabindex > 0 then we must look for:\r
+ // 1. An element following this element with the same tabindex.\r
+ // 2. The first element in source other with the lowest tabindex\r
+ // that is higher than this element tabindex.\r
+ // 3. The first element with tabindex=0.\r
+\r
+ element = this.getDocument().getBody().getFirst();\r
+\r
+ while ( ( element = element.getNextSourceNode( false, CKEDITOR.NODE_ELEMENT ) ) )\r
+ {\r
+ if ( !passedCurrent )\r
+ {\r
+ if ( !enteredCurrent && element.equals( this ) )\r
+ {\r
+ enteredCurrent = true;\r
+\r
+ // Ignore this element, if required.\r
+ if ( ignoreChildren )\r
+ {\r
+ if ( !( element = element.getNextSourceNode( true, CKEDITOR.NODE_ELEMENT ) ) )\r
+ break;\r
+ passedCurrent = 1;\r
+ }\r
+ }\r
+ else if ( enteredCurrent && !this.contains( element ) )\r
+ passedCurrent = 1;\r
+ }\r
+\r
+ if ( !element.isVisible() || ( elementTabIndex = element.getTabIndex() ) < 0 )\r
+ continue;\r
+\r
+ if ( passedCurrent && elementTabIndex == curTabIndex )\r
+ {\r
+ elected = element;\r
+ break;\r
+ }\r
+\r
+ if ( elementTabIndex > curTabIndex && ( !elected || !electedTabIndex || elementTabIndex < electedTabIndex ) )\r
+ {\r
+ elected = element;\r
+ electedTabIndex = elementTabIndex;\r
+ }\r
+ else if ( !elected && elementTabIndex === 0 )\r
+ {\r
+ elected = element;\r
+ electedTabIndex = elementTabIndex;\r
+ }\r
+ }\r
+ }\r
+\r
+ if ( elected )\r
+ elected.focus();\r
+};\r
+\r
+/**\r
+ * Moves the UI focus to the element before this element in the tabindex order.\r
+ * @example\r
+ * var element = CKEDITOR.document.getById( 'example' );\r
+ * element.focusPrevious();\r
+ */\r
+CKEDITOR.dom.element.prototype.focusPrevious = function( ignoreChildren, indexToUse )\r
+{\r
+ var $ = this.$,\r
+ curTabIndex = ( indexToUse === undefined ? this.getTabIndex() : indexToUse ),\r
+ passedCurrent, enteredCurrent,\r
+ elected,\r
+ electedTabIndex = 0,\r
+ elementTabIndex;\r
+\r
+ var element = this.getDocument().getBody().getLast();\r
+\r
+ while ( ( element = element.getPreviousSourceNode( false, CKEDITOR.NODE_ELEMENT ) ) )\r
+ {\r
+ if ( !passedCurrent )\r
+ {\r
+ if ( !enteredCurrent && element.equals( this ) )\r
+ {\r
+ enteredCurrent = true;\r
+\r
+ // Ignore this element, if required.\r
+ if ( ignoreChildren )\r
+ {\r
+ if ( !( element = element.getPreviousSourceNode( true, CKEDITOR.NODE_ELEMENT ) ) )\r
+ break;\r
+ passedCurrent = 1;\r
+ }\r
+ }\r
+ else if ( enteredCurrent && !this.contains( element ) )\r
+ passedCurrent = 1;\r
+ }\r
+\r
+ if ( !element.isVisible() || ( elementTabIndex = element.getTabIndex() ) < 0 )\r
+ continue;\r
+\r
+ if ( curTabIndex <= 0 )\r
+ {\r
+ // If this element has tabindex <= 0 then we must look for:\r
+ // 1. An element before this one containing tabindex=0.\r
+ // 2. The last element with the highest tabindex.\r
+\r
+ if ( passedCurrent && elementTabIndex === 0 )\r
+ {\r
+ elected = element;\r
+ break;\r
+ }\r
+\r
+ if ( elementTabIndex > electedTabIndex )\r
+ {\r
+ elected = element;\r
+ electedTabIndex = elementTabIndex;\r
+ }\r
+ }\r
+ else\r
+ {\r
+ // If this element has tabindex > 0 we must look for:\r
+ // 1. An element preceeding this one, with the same tabindex.\r
+ // 2. The last element in source other with the highest tabindex\r
+ // that is lower than this element tabindex.\r
+\r
+ if ( passedCurrent && elementTabIndex == curTabIndex )\r
+ {\r
+ elected = element;\r
+ break;\r
+ }\r
+\r
+ if ( elementTabIndex < curTabIndex && ( !elected || elementTabIndex > electedTabIndex ) )\r
+ {\r
+ elected = element;\r
+ electedTabIndex = elementTabIndex;\r
+ }\r
+ }\r
+ }\r
+\r
+ if ( elected )\r
+ elected.focus();\r
+};\r
+\r
+/**\r
+ * Intructs the editor to add a number of spaces (&nbsp;) to the text when\r
+ * hitting the TAB key. If set to zero, the TAB key will be used to move the\r
+ * cursor focus to the next element in the page, out of the editor focus.\r
+ * @name CKEDITOR.config.tabSpaces\r
+ * @type Number\r
+ * @default 0\r
+ * @example\r
+ * config.tabSpaces = 4;\r
+ */\r
+\r
+/**\r
+ * Allow context-sensitive tab key behaviors, including the following scenarios:\r
+ * <h5>When selection is anchored inside <b>table cells</b>:</h5>\r
+ * <ul>\r
+ * <li>If TAB is pressed, select the contents of the "next" cell. If in the last cell in the table, add a new row to it and focus its first cell.</li>\r
+ * <li>If SHIFT+TAB is pressed, select the contents of the "previous" cell. Do nothing when it's in the first cell.</li>\r
+ * </ul>\r
+ * @name CKEDITOR.config.enableTabKeyTools\r
+ * @type Boolean\r
+ * @default true\r
+ * @example\r
+ * config.enableTabKeyTools = false;\r
+ */\r
+\r
+// If the TAB key is not supposed to be enabled for navigation, the following\r
+// settings could be used alternatively:\r
+// config.keystrokes.push(\r
+// [ CKEDITOR.ALT + 38 /*Arrow Up*/, 'selectPreviousCell' ],\r
+// [ CKEDITOR.ALT + 40 /*Arrow Down*/, 'selectNextCell' ]\r
+// );\r
projects / ckeditor.git / blobdiff