1
0
mirror of https://github.com/DataTables/DataTables.git synced 2024-12-03 15:24:10 +01:00
Commit Graph

164 Commits

Author SHA1 Message Date
Ciro Duran Santilli
f78ce70580 Update examples/api/multi_filter.html
minor improvement: calculate index based on the element's parent th.

this is better because it allows to have some columns that are not searchable (like when the first row is a checkbox row)
2012-11-06 09:08:09 -02:00
Allan Jardine
3ac3cedf53 Fix: When sorting numerically, '-' and '' should be treated as -Infinity rather than as 0, since negative numbers could also be used int he column and this would split the numbers. 2012-10-30 21:05:15 +00:00
Allan Jardine
a0455fa858 New: The primary public interface for DataTables' initialisation options is now camel case parameters rather than the Hungarian notation that was used before. There are a number of reasons for doing this, the primary one being that the Hungarian notation used by DataTables is actively stopping people from using the library due to their aversion to using Hungarian notation. Without doubt the Hungarian notation used was a mistake (the reason it was used was that when DataTables was originally written, the company I worked for at the time required the use of Hungarian notation, and thus I was trained in it...).
Backwards compatibility issues: The main goal here (other than to use camel-case notation!) is to preserve backwards compatibility. Unfortunately this isn't 100% possible:
	- DataTable.defaults.columns has been renamed to be DataTable.defaults.column
		- Otherwise it conflicts with aoColumns in the defaults.

Without doubt this is going to be a long process - for example the unit tests and examples need to be completely updated for this change. The JSDoc comments have been updated, so the site should take care of itself for the most part, when released.

In terms of implementation, it is important to note that I have not broken backwards compatibility here - the way it is does is that the current defaults are retained, and a camel-case to Hungarian mapping is automatically generated and then applied to the objects given by the end user. This adds around 0.5K to the size of DataTables, but writing the mapping manually would require at least 3K, and changing DataTables wholesale to camel-case would utterly break backwards compatibility. This is the least 'evil' way to accomplish this. It is important to note that this is a step along the roadmap for DataTables - come v2 Hungarian notation will likely be dropped completely.

One important note to make about this mapping is that if you use camel-case DataTables will copy the value from the camel-case properties to their Hungarian counterparts, so you will end up with additional properties on your source object. As I say, this appears to be to be the least 'evil' option, although still not perfect itself. The challenges of working with legacy software and installs...!
2012-10-07 11:50:29 +01:00
Allan Jardine
f6401f062a Update: Examples - remove all reference of fnRender, instead granting preference to mRender. 2012-09-09 12:05:37 +01:00
Allan Jardine
93b0c9ede7 Examples: update - bind the 'xhr' event to the table without calling DataTables - no need for that call to be made. 2012-09-02 09:48:45 +01:00
Allan Jardine
660e8cb374 Update - examples: Witht he change in name from mDataProp to mData, this change is now refelected in the examples to encorage mData usage (do remember that mDataProp will still work, but use of mData is encoraged). 2012-08-08 22:30:26 +01:00
Allan Jardine
9c51aa0ad7 New: xhr event 2012-08-08 16:27:42 +01:00
John Kristensen
3be6982a63 Fix typos in examples/api/multi_filter_select.html 2012-07-05 15:31:18 +10:00
Allan Jardine
dc3f9b148e Fix - examples: Security updates to the server-side processing demo scripts from Chris Wright - specifically no MySQL error strings are shown to the end user. 2012-06-12 10:44:10 +01:00
Allan Jardine
90edd0bd94 Example - update: Use $ and fnUpdate in the index column example - 9840 2012-05-10 18:52:25 +01:00
Allan Jardine
09a9755540 Fix - examples: The global filter in the example PHP scripts wasn't taking into account the bSearchable_{i} flag - it was only being checked on individual column filtering - 8949 2012-04-20 08:14:48 +01:00
Allan Jardine
1fa1ef94a8 Update - examples: Update XRegExp to 1.5.1 with IE8 fix 2012-04-16 18:42:21 +01:00
Allan Jardine
43f7878fab Fix - examples: Remove debug code 2012-04-16 18:42:01 +01:00
Allan Jardine
dc59830454 Update: Update the text for the two jEditable examples 2012-04-13 15:20:09 +01:00
Allan Jardine
2a60a96177 New: Static API method - fnVersionCheck same as the version check that is already available as an instance method, but here available as a static API method attached to $.fn.dataTable
New: Static API method - fnIsDataTable - check if a TABLE node is a DataTable or not
New: Static API method - fnTables - get the DataTables that are initialised on the table (optionally limit to just the visible tables)
Examples update - Tabs and scrolling updated to use the new static fnTables method
Fix: Settings object model was missing the nScrollHead and nScrollFoot properties from the documentation
2012-04-13 10:44:25 +01:00
Allan Jardine
4be9b362c8 Fix: When scrolling and row height collapse was enabled, it was possible that the table column width applied would be too small due to the fact that a scrollbar would be shown for a fraction of a second, due to the height of the scroll body container enforced by the scroll collapse. Fix is to take into account the header height before the width calculation is done 2012-04-12 17:27:05 +01:00
Allan Jardine
d7912b09a0 Examples - fix: Single row selection could have a JS error if deleting a row when no rows selected 2012-03-11 17:56:55 +00:00
Allan Jardine
c09b0b89ea Examples update: Update the JSONP and pipelining examples to store the returned jqXHR object int he settings object. Helpful for the debugger so we can see what the sever says 2012-03-08 19:00:22 +00:00
Allan Jardine
b6709c017b Examples: When the node to show the XHR return is not available, don't try to use it 2012-03-03 13:49:13 +00:00
Allan Jardine
126a4fe44e Fix: When scrolling is enabled the initial width of the header was being set to 150% which was a bit random and could result in the header flashing its display in the wrong place when loading. The fix is to use 100% unless x-scrolling is being forced, at which point it needs to match the inner table - 8332 2012-02-25 07:56:27 +00:00
Allan Jardine
aa0ff53ee5 Examples: Update demo SSP PHP code 2012-02-24 06:55:44 +00:00
Allan Jardine
273aab7e59 Examples: Update - Scrolling paging plug-in now uses A tags (based on the updated two button paging for 1.9), has full accessaibility and jQuery UI support 2012-02-16 13:26:09 +00:00
Allan Jardine
d3c2fd551b Fix - examples: Remove link to custom column ordering - now recommended mDataProp 2012-02-10 07:38:45 +00:00
Allan Jardine
019b235b0e Examples: Fix: SyntaxHighlighter was having problems with copy and paste in webkit browsers - fix pushed to syntax highlighter here: https://github.com/alexgorbatchev/SyntaxHighlighter/pull/86 - this is the commit of that fix to the local copy 2012-01-28 10:08:43 +00:00
Allan Jardine
fbab63b7b5 Removed: Column reordering example using sName - it is much better to use mDataProp for this kind of thing now and column reordering is depricated in the 1.9 release of DataTables, so remove the example showing how it might be done to stop new users using it. 2012-01-21 07:43:47 +00:00
Allan Jardine
ccb99b3305 Add the localstorage example to the links list 2012-01-14 12:02:34 +00:00
Allan Jardine
368585da1e Add localstorage example 2012-01-14 10:09:25 +00:00
Allan Jardine
7eb80ac7e9 Dev change: For jQuery convention, call the DataTables CSS file jquery.dataTables.css (and similar for themeroller compatible file)
New: Base demos using the two new stylesheets
2012-01-08 20:53:42 +00:00
Allan Jardine
94976c2554 Fix: IE7 issue with xregexp 2012-01-07 16:58:01 +00:00
Allan Jardine
e92739fb1f Fix: jEditable calculated width could cause column to resize - just force width to be 100% of the cell, rather than calculated 2012-01-03 09:07:14 +00:00
Allan Jardine
e8c4436132 Update examples list with new custom events demo link 2011-12-28 11:55:39 +00:00
Allan Jardine
e4af1643a0 New: Events demo 2011-12-28 11:49:21 +00:00
Allan Jardine
11557abf0d Remove debug testing in example 2011-12-28 11:13:59 +00:00
Allan Jardine
cb014e81d7 New: Add unit tests for fnCreatedCell and fnCreatedRow
New: New init option fnCreatedRow - very similar to fnCreatedCell but in this case used for TR elements
Updated: fnCreatedCell now also gets the column index passed in
2011-12-28 11:12:30 +00:00
Allan Jardine
8c9f0b61e8 Updated: Nearly all callbacks now use an array and fire an event using the use DataTables standard method for dealing with callbacks. row, header, footer, init and pre-draw callback have been added to this new method. Only aoStateSave does not use method yet. fnCookieCallback and fnInfoCallback will not use the new methods.
Update: fnRowCallback - no need to return the TR element - it was a fairly pointless thing to do - if you want to replace the element then you need to do it with fnDrawCallback
2011-12-27 13:02:18 +00:00
Allan Jardine
d18b68d067 Tabs and spaced mixed in the custom vars example 2011-12-25 11:52:56 +00:00
Allan Jardine
94542c810a New: fnRender update - data object now also contains mDataProp along with the other information from before. There is also a second parameter passed to the function - the current value of the cell (was possible to get it from the data array, but this makes life a little easier if you want to get just that, which is the most common usage here). 2011-12-23 18:31:25 +00:00
Allan Jardine
2213cef905 Typo in pipelining example 2011-12-23 17:59:33 +00:00
Allan Jardine
6f5ef7ef07 Update row details examples to use fnIsOpen - 7758 2011-12-15 20:43:06 +00:00
Allan Jardine
699dabeec8 Simplify select row code 2011-12-15 12:35:43 +00:00
Allan Jardine
9720130cbc Update example links with new flexible width example 2011-12-15 10:19:24 +00:00
Allan Jardine
aa39fc2b96 New: Flexible width example 2011-12-15 10:17:36 +00:00
Allan Jardine
91858f9e86 Updated: Modification to the way table width is handled - if the 'width' attribute is on the table tag, then we use that to size the table. This makes having a table width of 100% much easier than before. The reason we need to do this is that there just doesn't appear to be a good way to get the relative width from stylesheets across browsers. 2011-12-15 09:43:31 +00:00
Allan Jardine
f1a74f3c25 Merge branch '1_9_DEV' of github.com:DataTables/DataTables into 1_9_DEV 2011-12-14 18:07:08 +00:00
Allan Jardine
cf0bfe0145 Update documentation links to add defaults example and remove fnGetNodes from post-init description 2011-12-14 18:05:57 +00:00
Allan Jardine
f4ff79bfba Update the select row examples to use the $ API method 2011-12-14 17:59:53 +00:00
Allan Jardine
4bfe3d7c89 Update highlight example to use $ API method 2011-12-14 17:51:06 +00:00
Allan Jardine
9ebabaf089 Update: Modify the form example to use the new $ API method 2011-12-14 17:47:22 +00:00
Allan Jardine
5088e48b80 Update editable example to use $ API method 2011-12-14 17:45:19 +00:00
Allan Jardine
5a506746bb Fix: Alter how the selector for the $ API method works so that it works on the TR elements and their decendants
Update: modify the api_in_init.html example to use the $ API method
2011-12-14 17:42:25 +00:00
Allan Jardine
22bffbb014 Update post init events example to use $ API method - easlier than fnGetNodes 2011-12-14 16:40:17 +00:00
Allan Jardine
f547513227 New: Example showing how to set defaults 2011-12-14 16:28:37 +00:00
Allan Jardine
8eb722271e Update the styling of the default pagination to make it more attractive. Also remove the previous change to use A tags - concerned about backwards compatibility and developers needing to update styles. Impact on accessibility to be evaluated, when ARIA button roles are added. 2011-12-10 10:33:00 +00:00
Allan Jardine
486315a25c Fix: Was only binding xhr event where there was more than one table! Doh! 2011-12-06 17:09:39 +00:00
Allan Jardine
8795d97194 Fix: Add field quotes (`) to the main server-side processing script. For most cases this will make no difference, but some columns might have a special character in them (- for example) and need this quoting. 2011-12-06 10:59:20 +00:00
Allan Jardine
edabb3febe Dev fix: Oops - committed code from a test to the zero config example! 2011-11-18 16:17:32 +00:00
Allan Jardine
58f85fc601 New: Add "sServerMethod" initialisation option to make it easy to change from GET to POST for server-side requests. Needing to supply a custom fnServerData just to get POST was a bit of a pain - this is now no longer needed. In theory fnServerData should generally not be needed now (with fnServerParams, mDataProp and this new parameter making set up much more flexible). 2011-11-09 08:50:30 +00:00
Allan Jardine
af16d8016c Don't initialise the xhr listener if there is no DataTable on the page 2011-11-08 10:13:03 +00:00
Allan Jardine
9b0bc1bbf9 New: Update SyntaxHighlighter to include a submit button to run the example directly in JSBin (live.datables.net) 2011-11-01 12:09:08 +00:00
Allan Jardine
1ae7f81a11 Dev update: Slight modification of style for the inner functions in the pagination controls 2011-10-15 09:01:27 +01:00
Allan Jardine
7e9d5eb537 Examples: Add JSONP examples for the 'id's and 'objects' sever-side scripts. Might make all JSONP compatible at some point... 2011-09-30 19:42:09 +01:00
Allan Jardine
efa3209654 Fix example: Need element scope to calculate TD index! - 6647 2011-09-20 19:37:17 +01:00
Allan Jardine
1d2db4d5e9 New: All examples which show Ajax requests now show the JSON response from the server (highlighted to be readiable JSON formatting) and the responses shown will update with each additional request. The idea is to make the formatting that DataTables expects / can cope with more obvious 2011-09-10 08:53:02 +01:00
Allan Jardine
a444026985 New: In the syntax highlighting also pickout DataTables' API methods and link them to the reference page 2011-09-05 19:24:18 +01:00
Allan Jardine
f788dd28d3 New: Syntax highlighting for the examples and provide a link for DataTables initialisation options to the reference page 2011-09-05 19:14:02 +01:00
Allan Jardine
0c296ca76e New: fnServerParams callback function - this allows additional parameters to be added to the XHR for server-side processing or Ajax sourced, client-side processed data, with ease. Previously it was required to override the fnServerData method just to add a couple of parameters, but the built in fnServerData method is quite comperhensive and you don't want to have to reproduce all of that unless you need to. Now you don't need to :-). fnServerParams is called on each request, so it is ideal for adding extra parameters such as search parameters which can be updated by users. 2011-09-02 16:01:56 +01:00
Allan Jardine
127339549e Fix: Examples - Typo for aaData reference - 6096 2011-08-09 21:52:28 +01:00
Allan Jardine
1c8f1e3465 Fix typo in example code 2011-08-05 19:53:13 +01:00
Allan Jardine
b61466cca4 Examples fix: Only include jQuery once... 2011-07-03 17:02:09 +01:00
Allan Jardine
0d94f1af0c Update: For objects, consider mDataProp which is sent from DataTables for sorting and filtering to get the correct order of the rows. This is useful for ColReorder and more generally it increases the flexability of the whole table 2011-06-25 08:34:54 +01:00
Allan Jardine
bb26e08b4e Examples fix: Details table has one extra column in it at the start, so this needs to be taken into account when sorting - 5422 2011-06-21 06:48:21 +01:00
Allan Jardine
839f5418a9 Fix: A couple of typos in the examples 2011-06-11 18:10:21 +01:00
Allan Jardine
3ae5367ddc Dev fix: Committed test case my mistake - reverting 2011-05-14 10:58:00 +01:00
Allan Jardine
fa85d34b24 Fix: Update Ajax data source demo with new location for the data source file 2011-05-04 18:37:25 +01:00
Allan Jardine
ed00eac7f5 Updated: Update the links on all examples to include the new examples for 1.8 and general tidy up of examples 2011-04-26 07:30:31 +01:00
Allan Jardine
a9b9dc4ffe New: New examples for the various features of DataTables 1.8 2011-04-25 19:07:57 +01:00
Allan Jardine
e9adba0802 Dev change: mDataSource renames to mDataProp. Reason for the change is that in future we could have mSortProp and mFilterProp if we wanted to sort / filter on something other than the main data. Also we are refering to a property of the source object (or an index of the source array - hence keeping the 'm' prefix) 2011-04-23 10:38:00 +01:00
Allan Jardine
1f681d81ac Dev fix: Again with the destroy... 2011-04-23 09:00:37 +01:00
Allan Jardine
707953a285 Fix: fnDestory would put the table back into the DOM in the wrong place if the table wasn't the the only (or last) element in the parent (i.e. it was just doing an append) - 4751 2011-04-23 08:58:58 +01:00
Allan Jardine
22f0ebb26f Dev fix: Remove destroy call from example! 2011-04-23 08:41:58 +01:00
Allan Jardine
8481826407 Fix: Sort wrapper on the header wasn't being removed on fnDestroy - 4617
New: Span elements in the header when using JUI themes, now have the class of DataTables_sort_icon applied to them automatically
2011-04-23 08:40:34 +01:00
Allan Jardine
d419c4ef66 New: JSONP example to show how it might be done - 4746 2011-04-23 07:00:25 +01:00
Allan Jardine
80c7663851 Dev fix: Correct typo 2011-04-23 07:00:10 +01:00
Allan Jardine
d60b9fd923 New: Add deferred loading example 2011-04-23 06:49:34 +01:00
Allan Jardine
2d0aff2b39 New: The ability to customise the property that is read when obtaining Ajax information from the server, for the data to insert into the table. The new initailisation parameter is sAjaxDataProp. It can be used with Ajax sourced data or server-side processing. When Ajax sourced data is used, it can be an empty string in which case it is assumed that an array has been passed into DataTables directly. Note also that it uses the same object data processor as mDataSource, so you can use dot notation to read from nested information (e.g. 'my.data'). 2011-04-21 18:37:36 +01:00
Allan Jardine
a6c8a13e6a New: Unit tests for column visibility with complex headers and fnSetColumnVis 2011-04-20 20:05:14 +01:00
Allan Jardine
f172ef5383 New: Significant change to how data is handled by DataTables. DataTables now has the ability to deal with complex objects as data sourced, which is particularly useful for dealing with Ajax data, and other data which doesn't belong in the visible table (db IDs for example). See the examples/ajax/ files that are in this commit for examples on how this works. More unit tests and further tidy up to come. Detailed examples will also be added in future - the current examples are mainly for testing 2011-04-19 19:35:33 +01:00
Allan Jardine
70305b1831 Updated: Move the various server-side example support scripts into the server_side/scripts directory 2011-04-17 10:54:14 +01:00
Allan Jardine
77ba6c790a Fix: Remove tailing comma for IE6/7 2011-03-22 18:23:44 +00:00
Allan Jardine
a99c64bea8 Fixed: Typo 2011-03-18 18:01:28 +00:00
Allan Jardine
07b3557c53 Fix: With all warnings enabled in PHP, there were certain DataTables initialisations which could trigger warnings in the example server porecessing script. 2011-03-01 21:44:43 +00:00
Allan Jardine
e2f8a1375a Documentation: typo "it's" should be "its" 2011-01-27 19:09:55 +00:00
Allan Jardine
1f65b1187f Updated: Server-side example scripts brought up-to-date 2011-01-25 18:06:36 +00:00
Allan Jardine
1e9436cc5e Updated: jEditable source to v1.7.1 2011-01-18 19:02:33 +00:00
Allan Jardine
eec881b8ac Fixed: Remove the 'sNames' parameter that was introduced for server-side processing in 1.7.4. The parameter 'sColumns' actually performs exactly this task already. Doh. Also update the example PHP to take this into account - 3218 2010-10-31 17:16:35 +00:00
Allan Jardine
a6365b3f69 Updated: Server-side processing script for column re-ordering has been updated to take account of sNames parameter which is sent in from DataTables, and also brought up to date with the main server-side processing script.
Changed: From the previous commit sNames sent from the client to server is now a comma seperated list of sNames and is always sent regardless of if names are given or not. This matches the sName formatting for the server-to-client return.
2010-10-29 08:48:13 +01:00
Allan Jardine
17d7d3b270 Fixed: Highlight via CSS example had incorrect documentation - 3155 2010-10-25 18:51:06 +01:00
Allan Jardine
27627b287d Updated: Trivial change to update hte favicon used by the DataTables examples from the SpryMedia icon to DataTables 2010-10-08 21:15:17 +01:00
Allan Jardine
af94c4b217 Updated: server-side processing example script updated to use json_encode, so this version will now require PHP 5.2 or newer. A version for older PHP versions can be found here: http://datatables.net/development/server-side/php_mysql4 2010-10-07 18:09:04 +01:00
Allan Jardine
35b7655bec Fixed: server-side processing demo script now takes account of strings which new line characters 2010-10-07 17:53:48 +01:00