diff DataTables-1.9.4/media/src/api/api.static.js @ 0:ac5f9272033b draft

first upload
author saskia-hiltemann
date Tue, 01 Jul 2014 11:42:23 -0400
parents
children
line wrap: on
line diff
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/DataTables-1.9.4/media/src/api/api.static.js	Tue Jul 01 11:42:23 2014 -0400
@@ -0,0 +1,98 @@
+
+
+/**
+ * Provide a common method for plug-ins to check the version of DataTables being used, in order
+ * to ensure compatibility.
+ *  @param {string} sVersion Version string to check for, in the format "X.Y.Z". Note that the
+ *    formats "X" and "X.Y" are also acceptable.
+ *  @returns {boolean} true if this version of DataTables is greater or equal to the required
+ *    version, or false if this version of DataTales is not suitable
+ *  @static
+ *  @dtopt API-Static
+ *
+ *  @example
+ *    alert( $.fn.dataTable.fnVersionCheck( '1.9.0' ) );
+ */
+DataTable.fnVersionCheck = function( sVersion )
+{
+	/* This is cheap, but effective */
+	var fnZPad = function (Zpad, count)
+	{
+		while(Zpad.length < count) {
+			Zpad += '0';
+		}
+		return Zpad;
+	};
+	var aThis = DataTable.ext.sVersion.split('.');
+	var aThat = sVersion.split('.');
+	var sThis = '', sThat = '';
+	
+	for ( var i=0, iLen=aThat.length ; i<iLen ; i++ )
+	{
+		sThis += fnZPad( aThis[i], 3 );
+		sThat += fnZPad( aThat[i], 3 );
+	}
+	
+	return parseInt(sThis, 10) >= parseInt(sThat, 10);
+};
+
+
+/**
+ * Check if a TABLE node is a DataTable table already or not.
+ *  @param {node} nTable The TABLE node to check if it is a DataTable or not (note that other
+ *    node types can be passed in, but will always return false).
+ *  @returns {boolean} true the table given is a DataTable, or false otherwise
+ *  @static
+ *  @dtopt API-Static
+ *
+ *  @example
+ *    var ex = document.getElementById('example');
+ *    if ( ! $.fn.DataTable.fnIsDataTable( ex ) ) {
+ *      $(ex).dataTable();
+ *    }
+ */
+DataTable.fnIsDataTable = function ( nTable )
+{
+	var o = DataTable.settings;
+
+	for ( var i=0 ; i<o.length ; i++ )
+	{
+		if ( o[i].nTable === nTable || o[i].nScrollHead === nTable || o[i].nScrollFoot === nTable )
+		{
+			return true;
+		}
+	}
+
+	return false;
+};
+
+
+/**
+ * Get all DataTable tables that have been initialised - optionally you can select to
+ * get only currently visible tables.
+ *  @param {boolean} [bVisible=false] Flag to indicate if you want all (default) or 
+ *    visible tables only.
+ *  @returns {array} Array of TABLE nodes (not DataTable instances) which are DataTables
+ *  @static
+ *  @dtopt API-Static
+ *
+ *  @example
+ *    var table = $.fn.dataTable.fnTables(true);
+ *    if ( table.length > 0 ) {
+ *      $(table).dataTable().fnAdjustColumnSizing();
+ *    }
+ */
+DataTable.fnTables = function ( bVisible )
+{
+	var out = [];
+
+	jQuery.each( DataTable.settings, function (i, o) {
+		if ( !bVisible || (bVisible === true && $(o.nTable).is(':visible')) )
+		{
+			out.push( o.nTable );
+		}
+	} );
+
+	return out;
+};
+