Project

General

Profile

Download (10.6 KB) Statistics
| Branch: | Tag: | Revision:
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

    
    (1-1/1)