jquery-datatables-rails 3.3.0 → 3.4.0

data/app/assets/javascripts/dataTables/extras/dataTables.keyTable.js

@@ -1,15 +1,15 @@
-/*! KeyTable 1.2.1
- * ©2010-2014 SpryMedia Ltd - datatables.net/license
+/*! KeyTable 2.1.0
+ * ©2009-2015 SpryMedia Ltd - datatables.net/license
  */
 
 /**
  * @summary     KeyTable
  * @description Spreadsheet like keyboard navigation for DataTables
- * @version     1.2.1
+ * @version     2.1.0
  * @file        dataTables.keyTable.js
  * @author      SpryMedia Ltd (www.sprymedia.co.uk)
  * @contact     www.sprymedia.co.uk/contact
- * @copyright   Copyright 2009-2014 SpryMedia Ltd.
+ * @copyright   Copyright 2009-2015 SpryMedia Ltd.
  *
  * This source file is free software, available under the following license:
  *   MIT license - http://datatables.net/license/mit
@@ -21,1155 +21,819 @@
  * For details please refer to: http://www.datatables.net
  */
 
-// Global scope for KeyTable for backwards compatibility. Will be removed in 1.3
-var KeyTable;
-
-
-(function(window, document, undefined) {
+(function( factory ){
+	if ( typeof define === 'function' && define.amd ) {
+		// AMD
+		define( ['jquery', 'datatables.net'], function ( $ ) {
+			return factory( $, window, document );
+		} );
+	}
+	else if ( typeof exports === 'object' ) {
+		// CommonJS
+		module.exports = function (root, $) {
+			if ( ! root ) {
+				root = window;
+			}
 
+			if ( ! $ || ! $.fn.dataTable ) {
+				$ = require('datatables.net')(root, $).$;
+			}
 
-var factory = function( $, DataTable ) {
-"use strict";
+			return factory( $, root, root.document );
+		};
+	}
+	else {
+		// Browser
+		factory( jQuery, window, document );
+	}
+}(function( $, window, document, undefined ) {
+'use strict';
+var DataTable = $.fn.dataTable;
 
-KeyTable = function ( oInit )
-{
-	/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
-	 * API parameters
-	 * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
 
-	/*
-	 * Variable: block
-	 * Purpose:  Flag whether or not KeyTable events should be processed
-	 * Scope:    KeyTable - public
-	 */
-	this.block = false;
-
-	/*
-	 * Variable: event
-	 * Purpose:  Container for all event application methods
-	 * Scope:    KeyTable - public
-	 * Notes:    This object contains all the public methods for adding and removing events - these
-	 *           are dynamically added later on
-	 */
-	this.event = {
-		"remove": {}
-	};
+var KeyTable = function ( dt, opts ) {
+	// Sanity check that we are using DataTables 1.10 or newer
+	if ( ! DataTable.versionCheck || ! DataTable.versionCheck( '1.10.8' ) ) {
+		throw 'KeyTable requires DataTables 1.10.8 or newer';
+	}
 
+	// User and defaults configuration object
+	this.c = $.extend( true, {},
+		DataTable.defaults.keyTable,
+		KeyTable.defaults,
+		opts
+	);
 
-	/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
-	 * API methods
-	 * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
+	// Internal settings
+	this.s = {
+		/** @type {DataTable.Api} DataTables' API instance */
+		dt: new DataTable.Api( dt ),
 
-	/*
-	 * Function: fnGetCurrentPosition
-	 * Purpose:  Get the currently focused cell's position
-	 * Returns:  array int: [ x, y ]
-	 * Inputs:   void
-	 */
-	this.fnGetCurrentPosition = function ()
-	{
-		return [ _iOldX, _iOldY ];
+		enable: true
 	};
 
+	// DOM items
+	this.dom = {
 
-	/*
-	 * Function: fnGetCurrentData
-	 * Purpose:  Get the currently focused cell's data (innerHTML)
-	 * Returns:  string: - data requested
-	 * Inputs:   void
-	 */
-	this.fnGetCurrentData = function ()
-	{
-		return _nOldFocus.innerHTML;
 	};
 
+	// Check if row reorder has already been initialised on this table
+	var settings = this.s.dt.settings()[0];
+	var exisiting = settings.keytable;
+	if ( exisiting ) {
+		return exisiting;
+	}
 
-	/*
-	 * Function: fnGetCurrentTD
-	 * Purpose:  Get the currently focused cell
-	 * Returns:  node: - focused element
-	 * Inputs:   void
-	 */
-	this.fnGetCurrentTD = function ()
-	{
-		return _nOldFocus;
-	};
+	settings.keytable = this;
+	this._constructor();
+};
 
 
-	/*
-	 * Function: fnSetPosition
-	 * Purpose:  Set the position of the focused cell
-	 * Returns:  -
-	 * Inputs:   int:x - x coordinate
-	 *           int:y - y coordinate
-	 * Notes:    Thanks to Rohan Daxini for the basis of this function
+$.extend( KeyTable.prototype, {
+	/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
+	 * API methods for DataTables API interface
 	 */
-	this.fnSetPosition = function( x, y )
-	{
-		if ( typeof x == 'object' && x.nodeName )
-		{
-			_fnSetFocus( x );
-		}
-		else
-		{
-			_fnSetFocus( _fnCellFromCoords(x, y) );
-		}
-	};
-
-
-	/*
-	 * Function: fnBlur
-	 * Purpose:  Blur the current focus
-	 * Returns:  -
-	 * Inputs:   -
+	
+	/**
+	 * Blur the table's cell focus
 	 */
-	this.fnBlur = function()
+	blur: function ()
 	{
-		_fnBlur();
-	};
-
+		this._blur();
+	},
 
-	/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
-	 * Private parameters
-	 * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
-
-	/*
-	 * Variable: _nBody
-	 * Purpose:  Body node of the table - cached for renference
-	 * Scope:    KeyTable - private
+	/**
+	 * Enable cell focus for the table
+	 *
+	 * @param  {string} state Can be `true`, `false` or `-string navigation-only`
 	 */
-	var _nBody = null;
+	enable: function ( state )
+	{
+		this.s.enable = state;
+	},
 
-	/*
-	 * Variable: 
-	 * Purpose:  
-	 * Scope:    KeyTable - private
+	/**
+	 * Focus on a cell
+	 * @param  {integer} row    Row index
+	 * @param  {integer} column Column index
 	 */
-	var _nOldFocus = null;
+	focus: function ( row, column )
+	{
+		this._focus( this.s.dt.cell( row, column ) );
+	},
 
-	/*
-	 * Variable: _iOldX and _iOldY
-	 * Purpose:  X and Y coords of the old elemet that was focused on
-	 * Scope:    KeyTable - private
+	/**
+	 * Is the cell focused
+	 * @param  {object} cell Cell index to check
+	 * @returns {boolean} true if focused, false otherwise
 	 */
-	var _iOldX = null;
-	var _iOldY = null;
+	focused: function ( cell )
+	{
+		var lastFocus = this.s.lastFocus;
 
-	/*
-	 * Variable: _that
-	 * Purpose:  Scope saving for 'this' after a jQuery event
-	 * Scope:    KeyTable - private
-	 */
-	var _that = null;
+		if ( ! lastFocus ) {
+			return false;
+		}
 
-	/*
-	 * Variable: sFocusClass
-	 * Purpose:  Class that should be used for focusing on a cell
-	 * Scope:    KeyTable - private
-	 */
-	var _sFocusClass = "focus";
+		var lastIdx = this.s.lastFocus.index();
+		return cell.row === lastIdx.row && cell.column === lastIdx.column;
+	},
 
-	/*
-	 * Variable: _bKeyCapture
-	 * Purpose:  Flag for should KeyTable capture key events or not
-	 * Scope:    KeyTable - private
-	 */
-	var _bKeyCapture = false;
 
-	/*
-	 * Variable: _oaoEvents
-	 * Purpose:  Event cache object, one array for each supported event for speed of searching
-	 * Scope:    KeyTable - private
+	/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
+	 * Constructor
 	 */
-	var _oaoEvents = {
-		"action": [],
-		"esc": [],
-		"focus": [],
-		"blur": []
-	};
 
-	/*
-	 * Variable: _oDatatable
-	 * Purpose:  DataTables settings object for if we are actually using a 
-	 *           DataTables table
-	 * Scope:    KeyTable - private
+	/**
+	 * Initialise the KeyTable instance
+	 *
+	 * @private
 	 */
-	var _oDatatable = null;
+	_constructor: function ()
+	{
+		this._tabInput();
 
-	var _bForm;
-	var _nInput;
-	var _bInputFocused = false;
+		var that = this;
+		var dt = this.s.dt;
+		var table = $( dt.table().node() );
 
+		// Need to be able to calculate the cell positions relative to the table
+		if ( table.css('position') === 'static' ) {
+			table.css( 'position', 'relative' );
+		}
 
-	/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
-	 * Private methods
-	 * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
+		// Click to focus
+		$( dt.table().body() ).on( 'click.keyTable', 'th, td', function () {
+			if ( that.s.enable === false ) {
+				return;
+			}
 
-	/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
-	 * Key table events
-	 */
+			var cell = dt.cell( this );
 
-	/*
-	 * Function: _fnEventAddTemplate
-	 * Purpose:  Create a function (with closure for sKey) event addition API
-	 * Returns:  function: - template function
-	 * Inputs:   string:sKey - type of event to detect
-	 */
-	function _fnEventAddTemplate( sKey )
-	{
-		/*
-		 * Function: -
-		 * Purpose:  API function for adding event to cache
-		 * Returns:  -
-		 * Inputs:   1. node:x - target node to add event for
-		 *           2. function:y - callback function to apply
-		 *         or
-		 *           1. int:x - x coord. of target cell (can be null for live events)
-		 *           2. int:y - y coord. of target cell (can be null for live events)
-		 *           3. function:z - callback function to apply
-		 * Notes:    This function is (interally) overloaded (in as much as javascript allows for
-		 *           that) - the target cell can be given by either node or coords.
-		 */
-		return function ( x, y, z ) {
-			if ( (x===null || typeof x == "number") &&
-				 (y===null || typeof y == "number") &&
-				 typeof z == "function" )
-			{
-				_fnEventAdd( sKey, x, y, z );
-			}
-			else if ( typeof x == "object" && typeof y == "function" )
-			{
-				var aCoords = _fnCoordsFromCell( x );
-				_fnEventAdd( sKey, aCoords[0], aCoords[1], y );
-			}
-			else
-			{
-				alert( "Unhandable event type was added: x" +x+ "  y:" +y+ "  z:" +z );
+			if ( ! cell.any() ) {
+				return;
 			}
-		};
-	}
 
+			that._focus( cell );
+		} );
 
-	/*
-	 * Function: _fnEventRemoveTemplate
-	 * Purpose:  Create a function (with closure for sKey) event removal API
-	 * Returns:  function: - template function
-	 * Inputs:   string:sKey - type of event to detect
-	 */
-	function _fnEventRemoveTemplate( sKey )
-	{
-		/*
-		 * Function: -
-		 * Purpose:  API function for removing event from cache
-		 * Returns:  int: - number of events removed
-		 * Inputs:   1. node:x - target node to remove event from
-		 *           2. function:y - callback function to apply
-		 *         or
-		 *           1. int:x - x coord. of target cell (can be null for live events)
-		 *           2. int:y - y coord. of target cell (can be null for live events)
-		 *           3. function:z - callback function to remove - optional
-		 * Notes:    This function is (interally) overloaded (in as much as javascript allows for
-		 *           that) - the target cell can be given by either node or coords and the function
-		 *           to remove is optional
-		 */
-		return function ( x, y, z ) {
-			if ( (x===null || typeof arguments[0] == "number") &&
-				 (y===null || typeof arguments[1] == "number" ) )
-			{
-				if ( typeof arguments[2] == "function" )
-				{
-					_fnEventRemove( sKey, x, y, z );
-				}
-				else
-				{
-					_fnEventRemove( sKey, x, y );
+		// Key events
+		$( document.body ).on( 'keydown.keyTable', function (e) {
+			that._key( e );
+		} );
+
+		// Click blur
+		if ( this.c.blurable ) {
+			$( document.body ).on( 'click.keyTable', function ( e ) {
+				// Click on the search input will blur focus
+				if ( $(e.target).parents( '.dataTables_filter' ).length ) {
+					that._blur();
 				}
-			}
-			else if ( typeof arguments[0] == "object" )
-			{
-				var aCoords = _fnCoordsFromCell( x );
-				if ( typeof arguments[1] == "function" )
-				{
-					_fnEventRemove( sKey, aCoords[0], aCoords[1], y );
+
+				// If the click was inside the DataTables container, don't blur
+				if ( $(e.target).parents().filter( dt.table().container() ).length ) {
+					return;
 				}
-				else
-				{
-					_fnEventRemove( sKey, aCoords[0], aCoords[1] );
+
+				// Don't blur in Editor form
+				if ( $(e.target).parents('div.DTE').length ) {
+					return;
 				}
-			}
-			else
-			{
-				alert( "Unhandable event type was removed: x" +x+ "  y:" +y+ "  z:" +z );
-			}
-		};
-	}
 
-	/* Use the template functions to add the event API functions */
-	for ( var sKey in _oaoEvents )
-	{
-		if ( sKey )
-		{
-			this.event[sKey] = _fnEventAddTemplate( sKey );
-			this.event.remove[sKey] = _fnEventRemoveTemplate( sKey );
+				that._blur();
+			} );
 		}
-	}
 
+		if ( this.c.editor ) {
+			dt.on( 'key.kt', function ( e, dt, key, cell, orig ) {
+				that._editor( key, orig );
+			} );
+		}
 
-	/*
-	 * Function: _fnEventAdd
-	 * Purpose:  Add an event to the internal cache
-	 * Returns:  -
-	 * Inputs:   string:sType - type of event to add, given by the available elements in _oaoEvents
-	 *           int:x - x-coords to add event to - can be null for "blanket" event
-	 *           int:y - y-coords to add event to - can be null for "blanket" event
-	 *           function:fn - callback function for when triggered
-	 */
-	function _fnEventAdd( sType, x, y, fn )
-	{
-		_oaoEvents[sType].push( {
-			"x": x,
-			"y": y,
-			"fn": fn
+		// Stave saving
+		if ( dt.settings()[0].oFeatures.bStateSave ) {
+			dt.on( 'stateSaveParams.keyTable', function (e, s, d) {
+				d.keyTable = that.s.lastFocus ?
+					that.s.lastFocus.index() :
+					null;
+			} );
+		}
+
+		dt.on( 'destroy.keyTable', function () {
+			dt.off( '.keyTable' );
+			$( dt.table().body() ).off( 'click.keyTable', 'th, td' );
+			$( document.body )
+				.off( 'keydown.keyTable' )
+				.off( 'click.keyTable' );
 		} );
-	}
 
+		// Initial focus comes from state or options
+		var state = dt.state.loaded();
 
-	/*
-	 * Function: _fnEventRemove
-	 * Purpose:  Remove an event from the event cache
-	 * Returns:  int: - number of matching events removed
-	 * Inputs:   string:sType - type of event to look for
-	 *           node:nTarget - target table cell
-	 *           function:fn - optional - remove this function. If not given all handlers of this
-	 *             type will be removed
-	 */
-	function _fnEventRemove( sType, x, y, fn )
-	{
-		var iCorrector = 0;
-
-		for ( var i=0, iLen=_oaoEvents[sType].length ; i<iLen-iCorrector ; i++ )
-		{
-			if ( typeof fn != 'undefined' )
-			{
-				if ( _oaoEvents[sType][i-iCorrector].x == x &&
-					 _oaoEvents[sType][i-iCorrector].y == y &&
-					   _oaoEvents[sType][i-iCorrector].fn == fn )
-				{
-					_oaoEvents[sType].splice( i-iCorrector, 1 );
-					iCorrector++;
-				}
-			}
-			else
-			{
-				if ( _oaoEvents[sType][i-iCorrector].x == x &&
-					 _oaoEvents[sType][i-iCorrector].y == y )
-				{
-					_oaoEvents[sType].splice( i, 1 );
-					return 1;
-				}
-			}
+		if ( state && state.keyTable ) {
+			dt.cell( state.keyTable ).focus();
 		}
-		return iCorrector;
-	}
-
-
-	/*
-	 * Function: _fnEventFire
-	 * Purpose:  Look thought the events cache and fire off the event of interest
-	 * Returns:  int:iFired - number of events fired
-	 * Inputs:   string:sType - type of event to look for
-	 *           int:x - x coord of cell
-	 *           int:y - y coord of  ell
-	 * Notes:    It might be more efficient to return after the first event has been tirggered,
-	 *           but that would mean that only one function of a particular type can be
-	 *           subscribed to a particular node.
-	 */
-	function _fnEventFire ( sType, x, y )
-	{
-		var iFired = 0;
-		var aEvents = _oaoEvents[sType];
-		for ( var i=0 ; i<aEvents.length ; i++ )
-		{
-			if ( (aEvents[i].x == x     && aEvents[i].y == y    ) ||
-				 (aEvents[i].x === null && aEvents[i].y == y    ) ||
-				 (aEvents[i].x == x     && aEvents[i].y === null ) ||
-				 (aEvents[i].x === null && aEvents[i].y === null )
-			)
-			{
-				aEvents[i].fn( _fnCellFromCoords(x,y), x, y );
-				iFired++;
-			}
+		else if ( this.c.focus ) {
+			dt.cell( this.c.focus ).focus();
 		}
-		return iFired;
-	}
+	},
+
 
 
 
-	/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
-	 * Focus functions
+	/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
+	 * Private methods
 	 */
 
-	/*
-	 * Function: _fnSetFocus
-	 * Purpose:  Set focus on a node, and remove from an old node if needed
-	 * Returns:  -
-	 * Inputs:   node:nTarget - node we want to focus on
-	 *           bool:bAutoScroll - optional - should we scroll the view port to the display
+	/**
+	 * Blur the control
+	 *
+	 * @private
 	 */
-	function _fnSetFocus( nTarget, bAutoScroll )
+	_blur: function ()
 	{
-		/* If node already has focus, just ignore this call */
-		if ( _nOldFocus == nTarget )
-		{
+		if ( ! this.s.enable || ! this.s.lastFocus ) {
 			return;
 		}
 
-		if ( typeof bAutoScroll == 'undefined' )
-		{
-			bAutoScroll = true;
-		}
+		var cell = this.s.lastFocus;
 
-		/* Remove old focus (with blur event if needed) */
-		if ( _nOldFocus !== null )
-		{
-			_fnRemoveFocus( _nOldFocus );
-		}
+		$( cell.node() ).removeClass( this.c.className );
+		this.s.lastFocus = null;
 
-		/* Add the new class to highlight the focused cell */
-		$(nTarget).addClass( _sFocusClass );
-		$(nTarget).parent().addClass( _sFocusClass );
-
-		/* If it's a DataTable then we need to jump the paging to the relevant page */
-		var oSettings;
-		if ( _oDatatable )
-		{
-			oSettings = _oDatatable;
-			var iRow = _fnFindDtCell( nTarget )[1];
-			var bKeyCaptureCache = _bKeyCapture;
-
-			/* Page forwards */
-			while ( iRow >= oSettings.fnDisplayEnd() )
-			{
-				if ( oSettings._iDisplayLength >= 0 )
-				{
-					/* Make sure we are not over running the display array */
-					if ( oSettings._iDisplayStart + oSettings._iDisplayLength < oSettings.fnRecordsDisplay() )
-					{
-						oSettings._iDisplayStart += oSettings._iDisplayLength;
-					}
-				}
-				else
-				{
-					oSettings._iDisplayStart = 0;
-				}
-				_oDatatable.oApi._fnCalculateEnd( oSettings );
-			}
+		this._emitEvent( 'key-blur', [ this.s.dt, cell ] );
+	},
 
-			/* Page backwards */
-			while ( iRow < oSettings._iDisplayStart )
-			{
-				oSettings._iDisplayStart = oSettings._iDisplayLength>=0 ?
-					oSettings._iDisplayStart - oSettings._iDisplayLength :
-					0;
 
-				if ( oSettings._iDisplayStart < 0 )
-				{
-				  oSettings._iDisplayStart = 0;
-				}
-				_oDatatable.oApi._fnCalculateEnd( oSettings );
+	/**
+	 * Get an array of the column indexes that KeyTable can operate on. This
+	 * is a merge of the user supplied columns and the visible columns.
+	 *
+	 * @private
+	 */
+	_columns: function ()
+	{
+		var dt = this.s.dt;
+		var user = dt.columns( this.c.columns ).indexes();
+		var out = [];
+
+		dt.columns( ':visible' ).every( function (i) {
+			if ( user.indexOf( i ) !== -1 ) {
+				out.push( i );
 			}
+		} );
 
-			/* Re-draw the table */
-			_oDatatable.oApi._fnDraw( oSettings );
+		return out;
+	},
 
-			/* Restore the key capture */
-			_bKeyCapture = bKeyCaptureCache;
-		}
 
-		/* Cache the information that we are interested in */
-		var aNewPos = _fnCoordsFromCell( nTarget );
-		_nOldFocus = nTarget;
-		_iOldX = aNewPos[0];
-		_iOldY = aNewPos[1];
-
-		var iViewportHeight, iViewportWidth, iScrollTop, iScrollLeft, iHeight, iWidth, aiPos;
-		if ( bAutoScroll )
-		{
-			/* Scroll the viewport such that the new cell is fully visible in the rendered window */
-			iViewportHeight = $(window).height();
-			iViewportWidth = $(window).width();
-			iScrollTop = $(document).scrollTop();
-			iScrollLeft = $(document).scrollLeft();
-			iHeight = nTarget.offsetHeight;
-			iWidth = nTarget.offsetWidth;
-			aiPos = _fnGetPos( nTarget );
-
-			/* Take account of scrolling in DataTables 1.7 - remove scrolling since that would add to
-			 * the positioning calculation
-			 */
-			if ( _oDatatable && typeof oSettings.oScroll != 'undefined' &&
-			  (oSettings.oScroll.sX !== "" || oSettings.oScroll.sY !== "") )
-			{
-				aiPos[1] -= $(oSettings.nTable.parentNode).scrollTop();
-				aiPos[0] -= $(oSettings.nTable.parentNode).scrollLeft();
-			}
+	/**
+	 * Perform excel like navigation for Editor by triggering an edit on key
+	 * press
+	 *
+	 * @param  {integer} key Key code for the pressed key
+	 * @param  {object} orig Original event
+	 * @private
+	 */
+	_editor: function ( key, orig )
+	{
+		var dt = this.s.dt;
+		var editor = this.c.editor;
 
-			/* Correct viewport positioning for vertical scrolling */
-			if ( aiPos[1]+iHeight > iScrollTop+iViewportHeight )
-			{
-				/* Displayed element if off the bottom of the viewport */
-				_fnSetScrollTop( aiPos[1]+iHeight - iViewportHeight );
-			}
-			else if ( aiPos[1] < iScrollTop )
-			{
-				/* Displayed element if off the top of the viewport */
-				_fnSetScrollTop( aiPos[1] );
-			}
+		orig.stopPropagation();
 
-			/* Correct viewport positioning for horizontal scrolling */
-			if ( aiPos[0]+iWidth > iScrollLeft+iViewportWidth )
-			{
-				/* Displayed element is off the bottom of the viewport */
-				_fnSetScrollLeft( aiPos[0]+iWidth - iViewportWidth );
-			}
-			else if ( aiPos[0] < iScrollLeft )
-			{
-				/* Displayed element if off the Left of the viewport */
-				_fnSetScrollLeft( aiPos[0] );
-			}
+		editor.inline( this.s.lastFocus.index() );
+
+		// Excel style - select all text
+		var input = $('div.DTE input');
+		if ( input.length ) {
+			input[0].select();
 		}
 
-		/* Take account of scrolling in DataTables 1.7 */
-		if ( _oDatatable && typeof oSettings.oScroll != 'undefined' &&
-		  (oSettings.oScroll.sX !== "" || oSettings.oScroll.sY !== "") )
-		{
-			var dtScrollBody = oSettings.nTable.parentNode;
-			iViewportHeight = dtScrollBody.clientHeight;
-			iViewportWidth = dtScrollBody.clientWidth;
-			iScrollTop = dtScrollBody.scrollTop;
-			iScrollLeft = dtScrollBody.scrollLeft;
-			iHeight = nTarget.offsetHeight;
-			iWidth = nTarget.offsetWidth;
-
-			/* Correct for vertical scrolling */
-			if ( nTarget.offsetTop + iHeight > iViewportHeight+iScrollTop )
-			{
-				dtScrollBody.scrollTop = (nTarget.offsetTop + iHeight) - iViewportHeight;
-			}
-			else if ( nTarget.offsetTop < iScrollTop )
-			{
-				dtScrollBody.scrollTop = nTarget.offsetTop;
-			}
+		// Reduce the keys the Keys listens for
+		dt.keys.enable( 'navigation-only' );
 
-			/* Correct for horizontal scrolling */
-			if ( nTarget.offsetLeft + iWidth > iViewportWidth+iScrollLeft )
-			{
-				dtScrollBody.scrollLeft = (nTarget.offsetLeft + iWidth) - iViewportWidth;
+		// On blur of the navigation submit
+		dt.one( 'key-blur.editor', function () {
+			if ( editor.displayed() ) {
+				editor.submit();
 			}
-			else if ( nTarget.offsetLeft < iScrollLeft )
-			{
-				dtScrollBody.scrollLeft = nTarget.offsetLeft;
-			}
-		}
-
-		/* Focused - so we want to capture the keys */
-		_fnCaptureKeys();
+		} );
 
-		/* Fire of the focus event if there is one */
-		_fnEventFire( "focus", _iOldX, _iOldY );
-	}
+		// Restore full key navigation on close
+		editor.one( 'close', function () {
+			dt.keys.enable( true );
+			dt.off( 'key-blur.editor' );
+		} );
+	},
 
 
-	/*
-	 * Function: _fnBlur
-	 * Purpose:  Blur focus from the whole table
-	 * Returns:  -
-	 * Inputs:   -
+	/**
+	 * Emit an event on the DataTable for listeners
+	 *
+	 * @param  {string} name Event name
+	 * @param  {array} args Event arguments
+	 * @private
 	 */
-	function _fnBlur()
+	_emitEvent: function ( name, args )
 	{
-		_fnRemoveFocus( _nOldFocus );
-		_iOldX = null;
-		_iOldY = null;
-		_nOldFocus = null;
-		_fnReleaseKeys();
-	}
+		this.s.dt.iterator( 'table', function ( ctx, i ) {
+			$(ctx.nTable).triggerHandler( name, args );
+		} );
+	},
 
 
-	/*
-	 * Function: _fnRemoveFocus
-	 * Purpose:  Remove focus from a cell and fire any blur events which are attached
-	 * Returns:  -
-	 * Inputs:   node:nTarget - cell of interest
+	/**
+	 * Focus on a particular cell, shifting the table's paging if required
+	 *
+	 * @param  {DataTables.Api|integer} row Can be given as an API instance that
+	 *   contains the cell to focus or as an integer. As the latter it is the
+	 *   visible row index - NOT the data index
+	 * @param  {integer} [column] Not required if a cell is given as the first
+	 *   parameter. Otherwise this is the column data index for the cell to
+	 *   focus on
+	 * @private
 	 */
-	function _fnRemoveFocus( nTarget )
+	_focus: function ( row, column )
 	{
-		$(nTarget).removeClass( _sFocusClass );
-		$(nTarget).parent().removeClass( _sFocusClass );
-		_fnEventFire( "blur", _iOldX, _iOldY );
-	}
+		var that = this;
+		var dt = this.s.dt;
+		var pageInfo = dt.page.info();
+		var lastFocus = this.s.lastFocus;
 
+		if ( ! this.s.enable ) {
+			return;
+		}
 
-	/*
-	 * Function: _fnClick
-	 * Purpose:  Focus on the element that has been clicked on by the user
-	 * Returns:  -
-	 * Inputs:   event:e - click event
-	 */
-	function _fnClick ( e )
-	{
-		var nTarget = this;
-		while ( nTarget.nodeName != "TD" )
-		{
-			nTarget = nTarget.parentNode;
+		if ( typeof row !== 'number' ) {
+			// Convert the cell to a row and column
+			var index = row.index();
+			column = index.column;
+			row = dt
+				.rows( { filter: 'applied', order: 'applied' } )
+				.indexes()
+				.indexOf( index.row );
+
+			// For server-side processing normalise the row by adding the start
+			// point, since `rows().indexes()` includes only rows that are
+			// available at the client-side
+			if ( pageInfo.serverSide ) {
+				row += pageInfo.start;
+			}
 		}
 
-		_fnSetFocus( nTarget );
-		_fnCaptureKeys();
-	}
+		// Is the row on the current page? If not, we need to redraw to show the
+		// page
+		if ( pageInfo.length !== -1 && (row < pageInfo.start || row >= pageInfo.start+pageInfo.length) ) {
+			dt
+				.one( 'draw', function () {
+					that._focus( row, column );
+				} )
+				.page( Math.floor( row / pageInfo.length ) )
+				.draw( false );
 
+			return;
+		}
 
+		// In the available columns?
+		if ( $.inArray( column, this._columns() ) === -1 ) {
+			return;
+		}
 
-	/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
-	 * Key events
-	 */
+		// De-normalise the server-side processing row, so we select the row
+		// in its displayed position
+		if ( pageInfo.serverSide ) {
+			row -= pageInfo.start;
+		}
+
+		var cell = dt.cell( ':eq('+row+')', column, {search: 'applied'} );
+
+		if ( lastFocus ) {
+			// Don't trigger a refocus on the same cell
+			if ( lastFocus.node() === cell.node() ) {
+				return;
+			}
+
+			// Otherwise blur the old focus
+			this._blur();
+		}
+
+		var node = $( cell.node() );
+		node.addClass( this.c.className );
+
+		// Shift viewpoint and page to make cell visible
+		this._scroll( $(window), $(document.body), node, 'offset' );
+
+		var bodyParent = dt.table().body().parentNode;
+		if ( bodyParent !== dt.table().header().parentNode ) {
+			var parent = $(bodyParent.parentNode);
+
+			this._scroll( parent, parent, node, 'position' );
+		}
+
+		// Event and finish
+		this.s.lastFocus = cell;
 
-	/*
-	 * Function: _fnKey
-	 * Purpose:  Deal with a key events, be it moving the focus or return etc.
-	 * Returns:  bool: - allow browser default action
-	 * Inputs:   event:e - key event
+		this._emitEvent( 'key-focus', [ this.s.dt, cell ] );
+		dt.state.save();
+	},
+
+
+	/**
+	 * Handle key press
+	 *
+	 * @param  {object} e Event
+	 * @private
 	 */
-	function _fnKey ( e )
+	_key: function ( e )
 	{
-		/* If user or system has blocked KeyTable from doing anything, just ignore this event */
-		if ( _that.block || !_bKeyCapture )
-		{
-			return true;
+		if ( ! this.s.enable ) {
+			return;
 		}
 
-		/* If a modifier key is pressed (exapct shift), ignore the event */
-		if ( e.metaKey || e.altKey || e.ctrlKey )
-		{
-			return true;
-		}
-		var
-			x, y,
-			iTableWidth = _nBody.getElementsByTagName('tr')[0].getElementsByTagName('td').length,
-			iTableHeight;
-
-		/* Get table height and width - done here so as to be dynamic (if table is updated) */
-		if ( _oDatatable )
-		{
-			/* 
-			 * Locate the current node in the DataTable overriding the old positions - the reason for
-			 * is is that there might have been some DataTables interaction between the last focus and
-			 * now
-			 */
-			iTableHeight = _oDatatable.aiDisplay.length;
-
-			var aDtPos = _fnFindDtCell( _nOldFocus );
-			if ( aDtPos === null )
-			{
-				/* If the table has been updated such that the focused cell can't be seen - do nothing */
-				return;
-			}
-			_iOldX = aDtPos[ 0 ];
-			_iOldY = aDtPos[ 1 ];
+		if ( e.keyCode === 0 || e.ctrlKey || e.metaKey || e.altKey ) {
+			return;
 		}
-		else
-		{
-			iTableHeight = _nBody.getElementsByTagName('tr').length;
+
+		// If not focused, then there is no key action to take
+		var cell = this.s.lastFocus;
+		if ( ! cell ) {
+			return;
 		}
 
-		/* Capture shift+tab to match the left arrow key */
-		var iKey = (e.keyCode == 9 && e.shiftKey) ? -1 : e.keyCode;
+		var that = this;
+		var dt = this.s.dt;
 
-		switch( iKey )
-		{
-			case 13: /* return */
-				e.preventDefault();
-				e.stopPropagation();
-				_fnEventFire( "action", _iOldX, _iOldY );
-				return true;
-
-			case 27: /* esc */
-				if ( !_fnEventFire( "esc", _iOldX, _iOldY ) )
-				{
-					/* Only lose focus if there isn't an escape handler on the cell */
-					_fnBlur();
-					return;
-				}
-				x = _iOldX;
-				y = _iOldY;
+		// If we are not listening for this key, do nothing
+		if ( this.c.keys && $.inArray( e.keyCode, this.c.keys ) === -1 ) {
+			return;
+		}
+
+		switch( e.keyCode ) {
+			case 9: // tab
+				this._shift( e, e.shiftKey ? 'left' : 'right', true );
 				break;
 
-			case -1:
-			case 37: /* left arrow */
-				if ( _iOldX > 0 ) {
-					x = _iOldX - 1;
-					y = _iOldY;
-				} else if ( _iOldY > 0 ) {
-					x = iTableWidth-1;
-					y = _iOldY - 1;
-				} else {
-					/* at start of table */
-					if ( iKey == -1 && _bForm )
-					{
-						/* If we are in a form, return focus to the 'input' element such that tabbing will
-						 * follow correctly in the browser
-						 */
-						_bInputFocused = true;
-						_nInput.focus();
-
-						/* This timeout is a little nasty - but IE appears to have some asyhnc behaviour for 
-						 * focus
-						 */
-						setTimeout( function(){ _bInputFocused = false; }, 0 );
-						_bKeyCapture = false;
-						_fnBlur();
-						return true;
-					}
-					else
-					{
-						return false;
-					}
+			case 27: // esc
+				if ( this.s.blurable && this.s.enable === true ) {
+					this._blur();
 				}
 				break;
 
-			case 38: /* up arrow */
-				if ( _iOldY > 0 ) {
-					x = _iOldX;
-					y = _iOldY - 1;
-				} else {
-					return false;
-				}
+			case 33: // page up (previous page)
+			case 34: // page down (next page)
+				e.preventDefault();
+				var index = dt.cells( {page: 'current'} ).nodes().indexOf( cell.node() );
+
+				dt
+					.one( 'draw', function () {
+						var nodes = dt.cells( {page: 'current'} ).nodes();
+
+						that._focus( dt.cell( index < nodes.length ?
+							nodes[ index ] :
+							nodes[ nodes.length-1 ]
+						) );
+					} )
+					.page( e.keyCode === 33 ? 'previous' : 'next' )
+					.draw( false );
 				break;
 
-			case 36: /* home */
-				x = _iOldX;
-				y = 0;
+			case 35: // end (end of current page)
+			case 36: // home (start of current page)
+				e.preventDefault();
+				var indexes = dt.cells( {page: 'current'} ).indexes();
+
+				this._focus( dt.cell(
+					indexes[ e.keyCode === 35 ? indexes.length-1 : 0 ]
+				) );
 				break;
 
-			case 33: /* page up */
-				x = _iOldX;
-				y = _iOldY - 10;
-				if (y < 0) {
-					y = 0;
-				}
+			case 37: // left arrow
+				this._shift( e, 'left' );
 				break;
 
-			case 9: /* tab */
-			case 39: /* right arrow */
-				if ( _iOldX < iTableWidth-1 ) {
-					x = _iOldX + 1;
-					y = _iOldY;
-				} else if ( _iOldY < iTableHeight-1 ) {
-					x = 0;
-					y = _iOldY + 1;
-				} else {
-					/* at end of table */
-					if ( iKey == 9 && _bForm )
-					{
-						/* If we are in a form, return focus to the 'input' element such that tabbing will
-						 * follow correctly in the browser
-						 */
-						_bInputFocused = true;
-						_nInput.focus();
-
-						/* This timeout is a little nasty - but IE appears to have some asyhnc behaviour for 
-						 * focus
-						 */
-						setTimeout( function(){ _bInputFocused = false; }, 0 );
-						_bKeyCapture = false;
-						_fnBlur();
-						return true;
-					}
-					else
-					{
-						return false;
-					}
-				}
+			case 38: // up arrow
+				this._shift( e, 'up' );
 				break;
 
-			case 40: /* down arrow */
-				if ( _iOldY < iTableHeight-1 ) {
-					x = _iOldX;
-					y = _iOldY + 1;
-				} else {
-					return false;
-				}
+			case 39: // right arrow
+				this._shift( e, 'right' );
 				break;
 
-			case 35: /* end */
-				x = _iOldX;
-				y = iTableHeight-1;
+			case 40: // down arrow
+				this._shift( e, 'down' );
 				break;
 
-			case 34: /* page down */
-				x = _iOldX;
-				y = _iOldY+10;
-				if (y > iTableHeight-1) {
-					y = iTableHeight-1;
+			default:
+				// Everything else - pass through only when fully enabled
+				if ( this.s.enable === true ) {
+					this._emitEvent( 'key', [ dt, e.keyCode, this.s.lastFocus, e ] );
 				}
 				break;
-
-			default: /* Nothing we are interested in */
-				return true;
 		}
-
-		_fnSetFocus( _fnCellFromCoords(x, y) );
-		return false;
-	}
+	},
 
 
-	/*
-	 * Function: _fnCaptureKeys
-	 * Purpose:  Start capturing key events for this table
-	 * Returns:  -
-	 * Inputs:   -
+	/**
+	 * Scroll a container to make a cell visible in it. This can be used for
+	 * both DataTables scrolling and native window scrolling.
+	 *
+	 * @param  {jQuery} container Scrolling container
+	 * @param  {jQuery} scroller  Item being scrolled
+	 * @param  {jQuery} cell      Cell in the scroller
+	 * @param  {string} posOff    `position` or `offset` - which to use for the
+	 *   calculation. `offset` for the document, otherwise `position`
+	 * @private
 	 */
-	function _fnCaptureKeys( )
+	_scroll: function ( container, scroller, cell, posOff )
 	{
-		if ( !_bKeyCapture )
-		{
-			_bKeyCapture = true;
+		var offset = cell[posOff]();
+		var height = cell.outerHeight();
+		var width = cell.outerWidth();
+
+		var scrollTop = scroller.scrollTop();
+		var scrollLeft = scroller.scrollLeft();
+		var containerHeight = container.height();
+		var containerWidth = container.width();
+
+		// Top correction
+		if ( offset.top < scrollTop ) {
+			scroller.scrollTop( offset.top );
 		}
-	}
+
+		// Left correction
+		if ( offset.left < scrollLeft ) {
+			scroller.scrollLeft( offset.left );
+		}
+
+		// Bottom correction
+		if ( offset.top + height > scrollTop + containerHeight ) {
+			scroller.scrollTop( offset.top + height - containerHeight );
+		}
+
+		// Right correction
+		if ( offset.left + width > scrollLeft + containerWidth ) {
+			scroller.scrollLeft( offset.left + width - containerWidth );
+		}
+	},
 
 
-	/*
-	 * Function: _fnReleaseKeys
-	 * Purpose:  Stop capturing key events for this table
-	 * Returns:  -
-	 * Inputs:   -
+	/**
+	 * Calculate a single offset movement in the table - up, down, left and
+	 * right and then perform the focus if possible
+	 *
+	 * @param  {object}  e           Event object
+	 * @param  {string}  direction   Movement direction
+	 * @param  {boolean} keyBlurable `true` if the key press can result in the
+	 *   table being blurred. This is so arrow keys won't blur the table, but
+	 *   tab will.
+	 * @private
 	 */
-	function _fnReleaseKeys( )
+	_shift: function ( e, direction, keyBlurable )
 	{
-		_bKeyCapture = false;
-	}
+		var that         = this;
+		var dt           = this.s.dt;
+		var pageInfo     = dt.page.info();
+		var rows         = pageInfo.recordsDisplay;
+		var currentCell  = this.s.lastFocus;
+		var columns      = this._columns();
+
+		if ( ! currentCell ) {
+			return;
+		}
 
+		var currRow = dt
+			.rows( { filter: 'applied', order: 'applied' } )
+			.indexes()
+			.indexOf( currentCell.index().row );
 
+		// When server-side processing, `rows().indexes()` only gives the rows
+		// that are available at the client-side, so we need to normalise the
+		// row's current position by the display start point
+		if ( pageInfo.serverSide ) {
+			currRow += pageInfo.start;
+		}
 
-	/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
-	 * Support functions
-	 */
+		var currCol = dt
+			.columns( columns )
+			.indexes()
+			.indexOf( currentCell.index().column );
 
-	/*
-	 * Function: _fnCellFromCoords
-	 * Purpose:  Calulate the target TD cell from x and y coordinates
-	 * Returns:  node: - TD target
-	 * Inputs:   int:x - x coordinate
-	 *           int:y - y coordinate
-	 */
-	function _fnCellFromCoords( x, y )
-	{
-		if ( _oDatatable )
-		{
-			if ( typeof _oDatatable.aoData[ _oDatatable.aiDisplay[ y ] ] != 'undefined' )
-			{
-				return _oDatatable.aoData[ _oDatatable.aiDisplay[ y ] ].nTr.getElementsByTagName('td')[x];
+		var
+			row = currRow,
+			column = columns[ currCol ]; // row is the display, column is an index
+
+		if ( direction === 'right' ) {
+			if ( currCol >= columns.length - 1 ) {
+				row++;
+				column = columns[0];
 			}
-			else
-			{
-				return null;
+			else {
+				column = columns[ currCol+1 ];
 			}
 		}
-		else
-		{
-			return $('tr:eq('+y+')>td:eq('+x+')', _nBody )[0];
+		else if ( direction === 'left' ) {
+			if ( currCol === 0 ) {
+				row--;
+				column = columns[ columns.length - 1 ];
+			}
+			else {
+				column = columns[ currCol-1 ];
+			}
+		}
+		else if ( direction === 'up' ) {
+			row--;
+		}
+		else if ( direction === 'down' ) {
+			row++;
 		}
-	}
 
+		if ( row >= 0 && row < rows && $.inArray( column, columns ) !== -1
+		) {
+			e.preventDefault();
 
-	/*
-	 * Function: _fnCoordsFromCell
-	 * Purpose:  Calculate the x and y position in a table from a TD cell
-	 * Returns:  array[2] int: [x, y]
-	 * Inputs:   node:n - TD cell of interest
-	 * Notes:    Not actually interested in this for DataTables since it might go out of date
-	 */
-	function _fnCoordsFromCell( n )
-	{
-		if ( _oDatatable )
-		{
-			return [
-				$('td', n.parentNode).index(n),
-				$('tr', n.parentNode.parentNode).index(n.parentNode) + _oDatatable._iDisplayStart
-			];
+			this._focus( row, column );
 		}
-		else
-		{
-			return [
-				$('td', n.parentNode).index(n),
-				$('tr', n.parentNode.parentNode).index(n.parentNode)
-			];
+		else if ( ! keyBlurable || ! this.c.blurable ) {
+			// No new focus, but if the table isn't blurable, then don't loose
+			// focus
+			e.preventDefault();
 		}
-	}
+		else {
+			this._blur();
+		}
+	},
 
 
-	/*
-	 * Function: _fnSetScrollTop
-	 * Purpose:  Set the vertical scrolling position
-	 * Returns:  -
-	 * Inputs:   int:iPos - scrolltop
-	 * Notes:    This is so nasty, but without browser detection you can't tell which you should set
-	 *           So on browsers that support both, the scroll top will be set twice. I can live with
-	 *           that :-)
+	/**
+	 * Create a hidden input element that can receive focus on behalf of the
+	 * table
+	 *
+	 * @private
 	 */
-	function _fnSetScrollTop( iPos )
+	_tabInput: function ()
 	{
-		document.documentElement.scrollTop = iPos;
-		document.body.scrollTop = iPos;
-	}
+		var that = this;
+		var dt = this.s.dt;
+		var tabIndex = this.c.tabIndex !== null ?
+			this.c.tabIndex :
+			dt.settings()[0].iTabIndex;
 
+		if ( tabIndex == -1 ) {
+			return;
+		}
 
-	/*
-	 * Function: _fnSetScrollLeft
-	 * Purpose:  Set the horizontal scrolling position
-	 * Returns:  -
-	 * Inputs:   int:iPos - scrollleft
-	 */
-	function _fnSetScrollLeft( iPos )
-	{
-		document.documentElement.scrollLeft = iPos;
-		document.body.scrollLeft = iPos;
+		var div = $('<div><input type="text" tabindex="'+tabIndex+'"/></div>')
+			.css( {
+				position: 'absolute',
+				height: 1,
+				width: 0,
+				overflow: 'hidden'
+			} )
+			.insertBefore( dt.table().node() );
+
+		div.children().on( 'focus', function () {
+			that._focus( dt.cell(':eq(0)', {page: 'current'}) );
+		} );
 	}
+} );
 
 
-	/*
-	 * Function: _fnGetPos
-	 * Purpose:  Get the position of an object on the rendered page
-	 * Returns:  array[2] int: [left, right]
-	 * Inputs:   node:obj - element of interest
+/**
+ * KeyTable default settings for initialisation
+ *
+ * @namespace
+ * @name KeyTable.defaults
+ * @static
+ */
+KeyTable.defaults = {
+	/**
+	 * Can focus be removed from the table
+	 * @type {Boolean}
 	 */
-	function _fnGetPos ( obj )
-	{
-		var iLeft = 0;
-		var iTop = 0;
-
-		if (obj.offsetParent)
-		{
-			iLeft = obj.offsetLeft;
-			iTop = obj.offsetTop;
-			obj = obj.offsetParent;
-			while (obj)
-			{
-				iLeft += obj.offsetLeft;
-				iTop += obj.offsetTop;
-				obj = obj.offsetParent;
-			}
-		}
-		return [iLeft,iTop];
-	}
+	blurable: true,
 
+	/**
+	 * Class to give to the focused cell
+	 * @type {String}
+	 */
+	className: 'focus',
 
-	/*
-	 * Function: _fnFindDtCell
-	 * Purpose:  Get the coords. of a cell from the DataTables internal information
-	 * Returns:  array[2] int: [x, y] coords. or null if not found
-	 * Inputs:   node:nTarget - the node of interest
+	/**
+	 * Columns that can be focused. This is automatically merged with the
+	 * visible columns as only visible columns can gain focus.
+	 * @type {String}
 	 */
-	function _fnFindDtCell( nTarget )
-	{
-		for ( var i=0, iLen=_oDatatable.aiDisplay.length ; i<iLen ; i++ )
-		{
-			var nTr = _oDatatable.aoData[ _oDatatable.aiDisplay[i] ].nTr;
-			var nTds = nTr.getElementsByTagName('td');
-			for ( var j=0, jLen=nTds.length ; j<jLen ; j++ )
-			{
-				if ( nTds[j] == nTarget )
-				{
-					return [ j, i ];
-				}
-			}
-		}
-		return null;
-	}
+	columns: '', // all
 
+	/**
+	 * Editor instance to automatically perform Excel like navigation
+	 * @type {Editor}
+	 */
+	editor: null,
 
+	/**
+	 * Select a cell to automatically select on start up. `null` for no
+	 * automatic selection
+	 * @type {cell-selector}
+	 */
+	focus: null,
 
-	/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
-	 * Initialisation
+	/**
+	 * Array of keys to listen for
+	 * @type {null|array}
 	 */
+	keys: null,
 
-	/*
-	 * Function: _fnInit
-	 * Purpose:  Initialise the KeyTable
-	 * Returns:  -
-	 * Inputs:   object:oInit - optional - Initalisation object with the following parameters:
-	 *   array[2] int:focus - x and y coordinates of the initial target
-	 *     or
-	 *     node:focus - the node to set initial focus on
-	 *   node:table - the table to use, if not given, first table with class 'KeyTable' will be used
-	 *   string:focusClass - focusing class to give to table elements
-	 *           object:that - focus
-	 *   bool:initScroll - scroll the view port on load, default true
-	 *   int:tabIndex - the tab index to give the hidden input element
+	/**
+	 * Tab index for where the table should sit in the document's tab flow
+	 * @type {integer|null}
 	 */
-	function _fnInit( table, datatable, oInit, that )
-	{
-		/* Save scope */
-		_that = that;
+	tabIndex: null
+};
 
-		/* Capture undefined initialisation and apply the defaults */
-		if ( typeof oInit == 'undefined' ) {
-			oInit = {};
-		}
 
-		if ( typeof oInit.focus == 'undefined' ) {
-			oInit.focus = [0,0];
-		}
 
-		oInit.table = table;
-		$(oInit.table).addClass('KeyTable');
+KeyTable.version = "2.1.0";
 
-		if ( typeof oInit.focusClass != 'undefined' ) {
-			_sFocusClass = oInit.focusClass;
-		}
 
-		if ( typeof datatable != 'undefined' ) {
-			_oDatatable = datatable;
-		}
+$.fn.dataTable.KeyTable = KeyTable;
+$.fn.DataTable.KeyTable = KeyTable;
 
-		if ( typeof oInit.initScroll == 'undefined' ) {
-			oInit.initScroll = true;
-		}
 
-		if ( typeof oInit.form == 'undefined' ) {
-			oInit.form = false;
-		}
-		_bForm = oInit.form;
-
-		/* Cache the tbody node of interest */
-		_nBody = oInit.table.getElementsByTagName('tbody')[0];
-
-		/* If the table is inside a form, then we need a hidden input box which can be used by the
-		 * browser to catch the browser tabbing for our table
-		 */
-		if ( _bForm )
-		{
-			var nDiv = document.createElement('div');
-			_nInput = document.createElement('input');
-			nDiv.style.height = "1px"; /* Opera requires a little something */
-			nDiv.style.width = "0px";
-			nDiv.style.overflow = "hidden";
-			if ( typeof oInit.tabIndex != 'undefined' )
-			{
-				_nInput.tabIndex = oInit.tabIndex;
-			}
-			nDiv.appendChild(_nInput);
-			oInit.table.parentNode.insertBefore( nDiv, oInit.table.nextSibling );
-
-			$(_nInput).focus( function () {
-				/* See if we want to 'tab into' the table or out */
-				if ( !_bInputFocused )
-				{
-					_bKeyCapture = true;
-					_bInputFocused = false;
-					if ( typeof oInit.focus.nodeName != "undefined" )
-					{
-						_fnSetFocus( oInit.focus, oInit.initScroll );
-					}
-					else
-					{
-						_fnSetFocus( _fnCellFromCoords( oInit.focus[0], oInit.focus[1]), oInit.initScroll );
-					}
-
-					/* Need to interup the thread for this to work */
-					setTimeout( function() { _nInput.blur(); }, 0 );
-				}
-			} );
-			_bKeyCapture = false;
-		}
-		else
-		{
-			/* Set the initial focus on the table */
-			if ( typeof oInit.focus.nodeName != "undefined" )
-			{
-				_fnSetFocus( oInit.focus, oInit.initScroll );
-			}
-			else
-			{
-				_fnSetFocus( _fnCellFromCoords( oInit.focus[0], oInit.focus[1]), oInit.initScroll );
-			}
-			_fnCaptureKeys();
+DataTable.Api.register( 'cell.blur()', function () {
+	return this.iterator( 'table', function (ctx) {
+		if ( ctx.keytable ) {
+			ctx.keytable.blur();
 		}
+	} );
+} );
 
-		/* Add event listeners */
-		$(document).bind( "keydown", _fnKey );
-
-		if ( _oDatatable )
-		{
-			$(_oDatatable.nTable).on( 'click', 'td', _fnClick );
+DataTable.Api.register( 'cell().focus()', function () {
+	return this.iterator( 'cell', function (ctx, row, column) {
+		if ( ctx.keytable ) {
+			ctx.keytable.focus( row, column );
 		}
-		else
-		{
-			$(_nBody).on( 'click', 'td', _fnClick );
+	} );
+} );
+
+DataTable.Api.register( 'keys.disable()', function () {
+	return this.iterator( 'table', function (ctx) {
+		if ( ctx.keytable ) {
+			ctx.keytable.enable( false );
 		}
+	} );
+} );
 
-		/* Loose table focus when click outside the table */
-		$(document).click( function(e) {
-			var nTarget = e.target;
-			var bTableClick = false;
-			while ( nTarget )
-			{
-				if ( nTarget == oInit.table )
-				{
-					bTableClick = true;
-					break;
-				}
-				nTarget = nTarget.parentNode;
-			}
-			if ( !bTableClick )
-			{
-				_fnBlur();
-			}
-		} );
-	}
+DataTable.Api.register( 'keys.enable()', function ( opts ) {
+	return this.iterator( 'table', function (ctx) {
+		if ( ctx.keytable ) {
+			ctx.keytable.enable( opts === undefined ? true : opts );
+		}
+	} );
+} );
 
-	var table, datatable;
+// Cell selector
+DataTable.ext.selector.cell.push( function ( settings, opts, cells ) {
+	var focused = opts.focused;
+	var kt = settings.keytable;
+	var out = [];
 
-	if ( oInit === undefined ) {
-		table = $('table.KeyTable')[0];
-		datatable = null;
-	}
-	else if ( $.isPlainObject( oInit ) ) {
-		table = oInit.table;
-		datatable = oInit.datatable;
-	}
-	else {
-		datatable = new $.fn.dataTable.Api( oInit ).settings()[0];
-		table = datatable.nTable;
+	if ( ! kt || focused === undefined ) {
+		return cells;
 	}
-	/* Initialise our new object */
-	_fnInit( table, datatable, oInit, this );
-};
 
+	for ( var i=0, ien=cells.length ; i<ien ; i++ ) {
+		if ( (focused === true &&  kt.focused( cells[i] ) ) ||
+			 (focused === false && ! kt.focused( cells[i] ) )
+		) {
+			out.push( cells[i] );
+		}
+	}
 
-KeyTable.version = "1.2.1";
-
+	return out;
+} );
 
-$.fn.dataTable.KeyTable = KeyTable;
-$.fn.DataTable.KeyTable = KeyTable;
 
+// Attach a listener to the document which listens for DataTables initialisation
+// events so we can automatically initialise
+$(document).on( 'preInit.dt.dtk', function (e, settings, json) {
+	if ( e.namespace !== 'dt' ) {
+		return;
+	}
 
-return KeyTable;
-}; // /factory
+	var init = settings.oInit.keys;
+	var defaults = DataTable.defaults.keys;
 
+	if ( init || defaults ) {
+		var opts = $.extend( {}, init, defaults );
 
-// Define as an AMD module if possible
-if ( typeof define === 'function' && define.amd ) {
-	define( ['jquery', 'datatables'], factory );
-}
-else if ( typeof exports === 'object' ) {
-    // Node/CommonJS
-    factory( require('jquery'), require('datatables') );
-}
-else if ( jQuery && !jQuery.fn.dataTable.KeyTable ) {
-	// Otherwise simply initialise as normal, stopping multiple evaluation
-	factory( jQuery, jQuery.fn.dataTable );
-}
+		if ( init !== false ) {
+			new KeyTable( settings, opts  );
+		}
+	}
+} );
 
 
-})(window, document);
+return KeyTable;
+}));