1
|
/**
|
2
|
* @summary DataTables
|
3
|
* @description Paginate, search and sort HTML tables
|
4
|
* @version 1.9.4
|
5
|
* @file jquery.dataTables.js
|
6
|
* @author Allan Jardine (www.sprymedia.co.uk)
|
7
|
* @contact www.sprymedia.co.uk/contact
|
8
|
*
|
9
|
* @copyright Copyright 2008-2012 Allan Jardine, all rights reserved.
|
10
|
*
|
11
|
* This source file is free software, under either the GPL v2 license or a
|
12
|
* BSD style license, available at:
|
13
|
* http://datatables.net/license_gpl2
|
14
|
* http://datatables.net/license_bsd
|
15
|
*
|
16
|
* This source file is distributed in the hope that it will be useful, but
|
17
|
* WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
|
18
|
* or FITNESS FOR A PARTICULAR PURPOSE. See the license files for details.
|
19
|
*
|
20
|
* For details please refer to: http://www.datatables.net
|
21
|
*/
|
22
|
|
23
|
/*jslint evil: true, undef: true, browser: true */
|
24
|
/*globals $, jQuery,define,_fnExternApiFunc,_fnInitialise,_fnInitComplete,_fnLanguageCompat,_fnAddColumn,_fnColumnOptions,_fnAddData,_fnCreateTr,_fnGatherData,_fnBuildHead,_fnDrawHead,_fnDraw,_fnReDraw,_fnAjaxUpdate,_fnAjaxParameters,_fnAjaxUpdateDraw,_fnServerParams,_fnAddOptionsHtml,_fnFeatureHtmlTable,_fnScrollDraw,_fnAdjustColumnSizing,_fnFeatureHtmlFilter,_fnFilterComplete,_fnFilterCustom,_fnFilterColumn,_fnFilter,_fnBuildSearchArray,_fnBuildSearchRow,_fnFilterCreateSearch,_fnDataToSearch,_fnSort,_fnSortAttachListener,_fnSortingClasses,_fnFeatureHtmlPaginate,_fnPageChange,_fnFeatureHtmlInfo,_fnUpdateInfo,_fnFeatureHtmlLength,_fnFeatureHtmlProcessing,_fnProcessingDisplay,_fnVisibleToColumnIndex,_fnColumnIndexToVisible,_fnNodeToDataIndex,_fnVisbleColumns,_fnCalculateEnd,_fnConvertToWidth,_fnCalculateColumnWidths,_fnScrollingWidthAdjust,_fnGetWidestNode,_fnGetMaxLenString,_fnStringToCss,_fnDetectType,_fnSettingsFromNode,_fnGetDataMaster,_fnGetTrNodes,_fnGetTdNodes,_fnEscapeRegex,_fnDeleteIndex,_fnReOrderIndex,_fnColumnOrdering,_fnLog,_fnClearTable,_fnSaveState,_fnLoadState,_fnCreateCookie,_fnReadCookie,_fnDetectHeader,_fnGetUniqueThs,_fnScrollBarWidth,_fnApplyToChildren,_fnMap,_fnGetRowData,_fnGetCellData,_fnSetCellData,_fnGetObjectDataFn,_fnSetObjectDataFn,_fnApplyColumnDefs,_fnBindAction,_fnCallbackReg,_fnCallbackFire,_fnJsonString,_fnRender,_fnNodeToColumnIndex,_fnInfoMacros,_fnBrowserDetect,_fnGetColumns*/
|
25
|
|
26
|
(/** @lends <global> */function( window, document, undefined ) {
|
27
|
|
28
|
(function( factory ) {
|
29
|
"use strict";
|
30
|
|
31
|
// Define as an AMD module if possible
|
32
|
if ( typeof define === 'function' && define.amd )
|
33
|
{
|
34
|
define( ['jquery'], factory );
|
35
|
}
|
36
|
/* Define using browser globals otherwise
|
37
|
* Prevent multiple instantiations if the script is loaded twice
|
38
|
*/
|
39
|
else if ( jQuery && !jQuery.fn.dataTable )
|
40
|
{
|
41
|
factory( jQuery );
|
42
|
}
|
43
|
}
|
44
|
(/** @lends <global> */function( $ ) {
|
45
|
"use strict";
|
46
|
/**
|
47
|
* DataTables is a plug-in for the jQuery Javascript library. It is a
|
48
|
* highly flexible tool, based upon the foundations of progressive
|
49
|
* enhancement, which will add advanced interaction controls to any
|
50
|
* HTML table. For a full list of features please refer to
|
51
|
* <a href="http://datatables.net">DataTables.net</a>.
|
52
|
*
|
53
|
* Note that the <i>DataTable</i> object is not a global variable but is
|
54
|
* aliased to <i>jQuery.fn.DataTable</i> and <i>jQuery.fn.dataTable</i> through which
|
55
|
* it may be accessed.
|
56
|
*
|
57
|
* @class
|
58
|
* @param {object} [oInit={}] Configuration object for DataTables. Options
|
59
|
* are defined by {@link DataTable.defaults}
|
60
|
* @requires jQuery 1.3+
|
61
|
*
|
62
|
* @example
|
63
|
* // Basic initialisation
|
64
|
* $(document).ready( function {
|
65
|
* $('#example').dataTable();
|
66
|
* } );
|
67
|
*
|
68
|
* @example
|
69
|
* // Initialisation with configuration options - in this case, disable
|
70
|
* // pagination and sorting.
|
71
|
* $(document).ready( function {
|
72
|
* $('#example').dataTable( {
|
73
|
* "bPaginate": false,
|
74
|
* "bSort": false
|
75
|
* } );
|
76
|
* } );
|
77
|
*/
|
78
|
var DataTable = function( oInit )
|
79
|
{
|
80
|
require('core.columns.js');
|
81
|
require('core.data.js');
|
82
|
require('core.draw.js');
|
83
|
require('core.ajax.js');
|
84
|
require('core.filter.js');
|
85
|
require('core.info.js');
|
86
|
require('core.init.js');
|
87
|
require('core.length.js');
|
88
|
require('core.page.js');
|
89
|
require('core.processing.js');
|
90
|
require('core.scrolling.js');
|
91
|
require('core.sizing.js');
|
92
|
require('core.sort.js');
|
93
|
require('core.state.js');
|
94
|
require('core.support.js');
|
95
|
|
96
|
require('api.methods.js');
|
97
|
require('api.internal.js');
|
98
|
|
99
|
var _that = this;
|
100
|
this.each(function() {
|
101
|
require('core.constructor.js');
|
102
|
} );
|
103
|
_that = null;
|
104
|
return this;
|
105
|
};
|
106
|
|
107
|
require('api.static.js');
|
108
|
|
109
|
/**
|
110
|
* Version string for plug-ins to check compatibility. Allowed format is
|
111
|
* a.b.c.d.e where: a:int, b:int, c:int, d:string(dev|beta), e:int. d and
|
112
|
* e are optional
|
113
|
* @member
|
114
|
* @type string
|
115
|
* @default Version number
|
116
|
*/
|
117
|
DataTable.version = "1.9.4";
|
118
|
|
119
|
/**
|
120
|
* Private data store, containing all of the settings objects that are created for the
|
121
|
* tables on a given page.
|
122
|
*
|
123
|
* Note that the <i>DataTable.settings</i> object is aliased to <i>jQuery.fn.dataTableExt</i>
|
124
|
* through which it may be accessed and manipulated, or <i>jQuery.fn.dataTable.settings</i>.
|
125
|
* @member
|
126
|
* @type array
|
127
|
* @default []
|
128
|
* @private
|
129
|
*/
|
130
|
DataTable.settings = [];
|
131
|
|
132
|
/**
|
133
|
* Object models container, for the various models that DataTables has available
|
134
|
* to it. These models define the objects that are used to hold the active state
|
135
|
* and configuration of the table.
|
136
|
* @namespace
|
137
|
*/
|
138
|
DataTable.models = {};
|
139
|
require('model.ext.js');
|
140
|
require('model.search.js');
|
141
|
require('model.row.js');
|
142
|
require('model.column.js');
|
143
|
require('model.defaults.js');
|
144
|
require('model.defaults.columns.js');
|
145
|
require('model.settings.js');
|
146
|
|
147
|
/**
|
148
|
* Extension object for DataTables that is used to provide all extension options.
|
149
|
*
|
150
|
* Note that the <i>DataTable.ext</i> object is available through
|
151
|
* <i>jQuery.fn.dataTable.ext</i> where it may be accessed and manipulated. It is
|
152
|
* also aliased to <i>jQuery.fn.dataTableExt</i> for historic reasons.
|
153
|
* @namespace
|
154
|
* @extends DataTable.models.ext
|
155
|
*/
|
156
|
DataTable.ext = $.extend( true, {}, DataTable.models.ext );
|
157
|
require('ext.classes.js');
|
158
|
require('ext.paging.js');
|
159
|
require('ext.sorting.js');
|
160
|
require('ext.types.js');
|
161
|
|
162
|
// jQuery aliases
|
163
|
$.fn.DataTable = DataTable;
|
164
|
$.fn.dataTable = DataTable;
|
165
|
$.fn.dataTableSettings = DataTable.settings;
|
166
|
$.fn.dataTableExt = DataTable.ext;
|
167
|
|
168
|
|
169
|
// Information about events fired by DataTables - for documentation.
|
170
|
/**
|
171
|
* Draw event, fired whenever the table is redrawn on the page, at the same point as
|
172
|
* fnDrawCallback. This may be useful for binding events or performing calculations when
|
173
|
* the table is altered at all.
|
174
|
* @name DataTable#draw
|
175
|
* @event
|
176
|
* @param {event} e jQuery event object
|
177
|
* @param {object} o DataTables settings object {@link DataTable.models.oSettings}
|
178
|
*/
|
179
|
|
180
|
/**
|
181
|
* Filter event, fired when the filtering applied to the table (using the build in global
|
182
|
* global filter, or column filters) is altered.
|
183
|
* @name DataTable#filter
|
184
|
* @event
|
185
|
* @param {event} e jQuery event object
|
186
|
* @param {object} o DataTables settings object {@link DataTable.models.oSettings}
|
187
|
*/
|
188
|
|
189
|
/**
|
190
|
* Page change event, fired when the paging of the table is altered.
|
191
|
* @name DataTable#page
|
192
|
* @event
|
193
|
* @param {event} e jQuery event object
|
194
|
* @param {object} o DataTables settings object {@link DataTable.models.oSettings}
|
195
|
*/
|
196
|
|
197
|
/**
|
198
|
* Sort event, fired when the sorting applied to the table is altered.
|
199
|
* @name DataTable#sort
|
200
|
* @event
|
201
|
* @param {event} e jQuery event object
|
202
|
* @param {object} o DataTables settings object {@link DataTable.models.oSettings}
|
203
|
*/
|
204
|
|
205
|
/**
|
206
|
* DataTables initialisation complete event, fired when the table is fully drawn,
|
207
|
* including Ajax data loaded, if Ajax data is required.
|
208
|
* @name DataTable#init
|
209
|
* @event
|
210
|
* @param {event} e jQuery event object
|
211
|
* @param {object} oSettings DataTables settings object
|
212
|
* @param {object} json The JSON object request from the server - only
|
213
|
* present if client-side Ajax sourced data is used</li></ol>
|
214
|
*/
|
215
|
|
216
|
/**
|
217
|
* State save event, fired when the table has changed state a new state save is required.
|
218
|
* This method allows modification of the state saving object prior to actually doing the
|
219
|
* save, including addition or other state properties (for plug-ins) or modification
|
220
|
* of a DataTables core property.
|
221
|
* @name DataTable#stateSaveParams
|
222
|
* @event
|
223
|
* @param {event} e jQuery event object
|
224
|
* @param {object} oSettings DataTables settings object
|
225
|
* @param {object} json The state information to be saved
|
226
|
*/
|
227
|
|
228
|
/**
|
229
|
* State load event, fired when the table is loading state from the stored data, but
|
230
|
* prior to the settings object being modified by the saved state - allowing modification
|
231
|
* of the saved state is required or loading of state for a plug-in.
|
232
|
* @name DataTable#stateLoadParams
|
233
|
* @event
|
234
|
* @param {event} e jQuery event object
|
235
|
* @param {object} oSettings DataTables settings object
|
236
|
* @param {object} json The saved state information
|
237
|
*/
|
238
|
|
239
|
/**
|
240
|
* State loaded event, fired when state has been loaded from stored data and the settings
|
241
|
* object has been modified by the loaded data.
|
242
|
* @name DataTable#stateLoaded
|
243
|
* @event
|
244
|
* @param {event} e jQuery event object
|
245
|
* @param {object} oSettings DataTables settings object
|
246
|
* @param {object} json The saved state information
|
247
|
*/
|
248
|
|
249
|
/**
|
250
|
* Processing event, fired when DataTables is doing some kind of processing (be it,
|
251
|
* sort, filter or anything else). Can be used to indicate to the end user that
|
252
|
* there is something happening, or that something has finished.
|
253
|
* @name DataTable#processing
|
254
|
* @event
|
255
|
* @param {event} e jQuery event object
|
256
|
* @param {object} oSettings DataTables settings object
|
257
|
* @param {boolean} bShow Flag for if DataTables is doing processing or not
|
258
|
*/
|
259
|
|
260
|
/**
|
261
|
* Ajax (XHR) event, fired whenever an Ajax request is completed from a request to
|
262
|
* made to the server for new data (note that this trigger is called in fnServerData,
|
263
|
* if you override fnServerData and which to use this event, you need to trigger it in
|
264
|
* you success function).
|
265
|
* @name DataTable#xhr
|
266
|
* @event
|
267
|
* @param {event} e jQuery event object
|
268
|
* @param {object} o DataTables settings object {@link DataTable.models.oSettings}
|
269
|
* @param {object} json JSON returned from the server
|
270
|
*/
|
271
|
|
272
|
/**
|
273
|
* Destroy event, fired when the DataTable is destroyed by calling fnDestroy or passing
|
274
|
* the bDestroy:true parameter in the initialisation object. This can be used to remove
|
275
|
* bound events, added DOM nodes, etc.
|
276
|
* @name DataTable#destroy
|
277
|
* @event
|
278
|
* @param {event} e jQuery event object
|
279
|
* @param {object} o DataTables settings object {@link DataTable.models.oSettings}
|
280
|
*/
|
281
|
}));
|
282
|
|
283
|
}(window, document));
|
284
|
|