annotate DataTables-1.9.4/media/src/api/api.static.js @ 2:3c160414da2e default tip

initial upload
author shiltemann
date Thu, 26 Feb 2015 14:05:23 +0100
parents
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
2
3c160414da2e initial upload
shiltemann
parents:
diff changeset
1
3c160414da2e initial upload
shiltemann
parents:
diff changeset
2
3c160414da2e initial upload
shiltemann
parents:
diff changeset
3 /**
3c160414da2e initial upload
shiltemann
parents:
diff changeset
4 * Provide a common method for plug-ins to check the version of DataTables being used, in order
3c160414da2e initial upload
shiltemann
parents:
diff changeset
5 * to ensure compatibility.
3c160414da2e initial upload
shiltemann
parents:
diff changeset
6 * @param {string} sVersion Version string to check for, in the format "X.Y.Z". Note that the
3c160414da2e initial upload
shiltemann
parents:
diff changeset
7 * formats "X" and "X.Y" are also acceptable.
3c160414da2e initial upload
shiltemann
parents:
diff changeset
8 * @returns {boolean} true if this version of DataTables is greater or equal to the required
3c160414da2e initial upload
shiltemann
parents:
diff changeset
9 * version, or false if this version of DataTales is not suitable
3c160414da2e initial upload
shiltemann
parents:
diff changeset
10 * @static
3c160414da2e initial upload
shiltemann
parents:
diff changeset
11 * @dtopt API-Static
3c160414da2e initial upload
shiltemann
parents:
diff changeset
12 *
3c160414da2e initial upload
shiltemann
parents:
diff changeset
13 * @example
3c160414da2e initial upload
shiltemann
parents:
diff changeset
14 * alert( $.fn.dataTable.fnVersionCheck( '1.9.0' ) );
3c160414da2e initial upload
shiltemann
parents:
diff changeset
15 */
3c160414da2e initial upload
shiltemann
parents:
diff changeset
16 DataTable.fnVersionCheck = function( sVersion )
3c160414da2e initial upload
shiltemann
parents:
diff changeset
17 {
3c160414da2e initial upload
shiltemann
parents:
diff changeset
18 /* This is cheap, but effective */
3c160414da2e initial upload
shiltemann
parents:
diff changeset
19 var fnZPad = function (Zpad, count)
3c160414da2e initial upload
shiltemann
parents:
diff changeset
20 {
3c160414da2e initial upload
shiltemann
parents:
diff changeset
21 while(Zpad.length < count) {
3c160414da2e initial upload
shiltemann
parents:
diff changeset
22 Zpad += '0';
3c160414da2e initial upload
shiltemann
parents:
diff changeset
23 }
3c160414da2e initial upload
shiltemann
parents:
diff changeset
24 return Zpad;
3c160414da2e initial upload
shiltemann
parents:
diff changeset
25 };
3c160414da2e initial upload
shiltemann
parents:
diff changeset
26 var aThis = DataTable.ext.sVersion.split('.');
3c160414da2e initial upload
shiltemann
parents:
diff changeset
27 var aThat = sVersion.split('.');
3c160414da2e initial upload
shiltemann
parents:
diff changeset
28 var sThis = '', sThat = '';
3c160414da2e initial upload
shiltemann
parents:
diff changeset
29
3c160414da2e initial upload
shiltemann
parents:
diff changeset
30 for ( var i=0, iLen=aThat.length ; i<iLen ; i++ )
3c160414da2e initial upload
shiltemann
parents:
diff changeset
31 {
3c160414da2e initial upload
shiltemann
parents:
diff changeset
32 sThis += fnZPad( aThis[i], 3 );
3c160414da2e initial upload
shiltemann
parents:
diff changeset
33 sThat += fnZPad( aThat[i], 3 );
3c160414da2e initial upload
shiltemann
parents:
diff changeset
34 }
3c160414da2e initial upload
shiltemann
parents:
diff changeset
35
3c160414da2e initial upload
shiltemann
parents:
diff changeset
36 return parseInt(sThis, 10) >= parseInt(sThat, 10);
3c160414da2e initial upload
shiltemann
parents:
diff changeset
37 };
3c160414da2e initial upload
shiltemann
parents:
diff changeset
38
3c160414da2e initial upload
shiltemann
parents:
diff changeset
39
3c160414da2e initial upload
shiltemann
parents:
diff changeset
40 /**
3c160414da2e initial upload
shiltemann
parents:
diff changeset
41 * Check if a TABLE node is a DataTable table already or not.
3c160414da2e initial upload
shiltemann
parents:
diff changeset
42 * @param {node} nTable The TABLE node to check if it is a DataTable or not (note that other
3c160414da2e initial upload
shiltemann
parents:
diff changeset
43 * node types can be passed in, but will always return false).
3c160414da2e initial upload
shiltemann
parents:
diff changeset
44 * @returns {boolean} true the table given is a DataTable, or false otherwise
3c160414da2e initial upload
shiltemann
parents:
diff changeset
45 * @static
3c160414da2e initial upload
shiltemann
parents:
diff changeset
46 * @dtopt API-Static
3c160414da2e initial upload
shiltemann
parents:
diff changeset
47 *
3c160414da2e initial upload
shiltemann
parents:
diff changeset
48 * @example
3c160414da2e initial upload
shiltemann
parents:
diff changeset
49 * var ex = document.getElementById('example');
3c160414da2e initial upload
shiltemann
parents:
diff changeset
50 * if ( ! $.fn.DataTable.fnIsDataTable( ex ) ) {
3c160414da2e initial upload
shiltemann
parents:
diff changeset
51 * $(ex).dataTable();
3c160414da2e initial upload
shiltemann
parents:
diff changeset
52 * }
3c160414da2e initial upload
shiltemann
parents:
diff changeset
53 */
3c160414da2e initial upload
shiltemann
parents:
diff changeset
54 DataTable.fnIsDataTable = function ( nTable )
3c160414da2e initial upload
shiltemann
parents:
diff changeset
55 {
3c160414da2e initial upload
shiltemann
parents:
diff changeset
56 var o = DataTable.settings;
3c160414da2e initial upload
shiltemann
parents:
diff changeset
57
3c160414da2e initial upload
shiltemann
parents:
diff changeset
58 for ( var i=0 ; i<o.length ; i++ )
3c160414da2e initial upload
shiltemann
parents:
diff changeset
59 {
3c160414da2e initial upload
shiltemann
parents:
diff changeset
60 if ( o[i].nTable === nTable || o[i].nScrollHead === nTable || o[i].nScrollFoot === nTable )
3c160414da2e initial upload
shiltemann
parents:
diff changeset
61 {
3c160414da2e initial upload
shiltemann
parents:
diff changeset
62 return true;
3c160414da2e initial upload
shiltemann
parents:
diff changeset
63 }
3c160414da2e initial upload
shiltemann
parents:
diff changeset
64 }
3c160414da2e initial upload
shiltemann
parents:
diff changeset
65
3c160414da2e initial upload
shiltemann
parents:
diff changeset
66 return false;
3c160414da2e initial upload
shiltemann
parents:
diff changeset
67 };
3c160414da2e initial upload
shiltemann
parents:
diff changeset
68
3c160414da2e initial upload
shiltemann
parents:
diff changeset
69
3c160414da2e initial upload
shiltemann
parents:
diff changeset
70 /**
3c160414da2e initial upload
shiltemann
parents:
diff changeset
71 * Get all DataTable tables that have been initialised - optionally you can select to
3c160414da2e initial upload
shiltemann
parents:
diff changeset
72 * get only currently visible tables.
3c160414da2e initial upload
shiltemann
parents:
diff changeset
73 * @param {boolean} [bVisible=false] Flag to indicate if you want all (default) or
3c160414da2e initial upload
shiltemann
parents:
diff changeset
74 * visible tables only.
3c160414da2e initial upload
shiltemann
parents:
diff changeset
75 * @returns {array} Array of TABLE nodes (not DataTable instances) which are DataTables
3c160414da2e initial upload
shiltemann
parents:
diff changeset
76 * @static
3c160414da2e initial upload
shiltemann
parents:
diff changeset
77 * @dtopt API-Static
3c160414da2e initial upload
shiltemann
parents:
diff changeset
78 *
3c160414da2e initial upload
shiltemann
parents:
diff changeset
79 * @example
3c160414da2e initial upload
shiltemann
parents:
diff changeset
80 * var table = $.fn.dataTable.fnTables(true);
3c160414da2e initial upload
shiltemann
parents:
diff changeset
81 * if ( table.length > 0 ) {
3c160414da2e initial upload
shiltemann
parents:
diff changeset
82 * $(table).dataTable().fnAdjustColumnSizing();
3c160414da2e initial upload
shiltemann
parents:
diff changeset
83 * }
3c160414da2e initial upload
shiltemann
parents:
diff changeset
84 */
3c160414da2e initial upload
shiltemann
parents:
diff changeset
85 DataTable.fnTables = function ( bVisible )
3c160414da2e initial upload
shiltemann
parents:
diff changeset
86 {
3c160414da2e initial upload
shiltemann
parents:
diff changeset
87 var out = [];
3c160414da2e initial upload
shiltemann
parents:
diff changeset
88
3c160414da2e initial upload
shiltemann
parents:
diff changeset
89 jQuery.each( DataTable.settings, function (i, o) {
3c160414da2e initial upload
shiltemann
parents:
diff changeset
90 if ( !bVisible || (bVisible === true && $(o.nTable).is(':visible')) )
3c160414da2e initial upload
shiltemann
parents:
diff changeset
91 {
3c160414da2e initial upload
shiltemann
parents:
diff changeset
92 out.push( o.nTable );
3c160414da2e initial upload
shiltemann
parents:
diff changeset
93 }
3c160414da2e initial upload
shiltemann
parents:
diff changeset
94 } );
3c160414da2e initial upload
shiltemann
parents:
diff changeset
95
3c160414da2e initial upload
shiltemann
parents:
diff changeset
96 return out;
3c160414da2e initial upload
shiltemann
parents:
diff changeset
97 };
3c160414da2e initial upload
shiltemann
parents:
diff changeset
98