source: TI12-security/trunk/NDGSecurity/python/Tests/openid-provider/op/op/public/js/yui/datatable/README @ 7080

Subversion URL: http://proj.badc.rl.ac.uk/svn/ndg/TI12-security/trunk/NDGSecurity/python/Tests/openid-provider/op/op/public/js/yui/datatable/README@7080
Revision 7080, 11.4 KB checked in by pjkersha, 9 years ago (diff)
  • Property svn:keywords set to Id
Line 
1DataTable Release Notes
2
3*** version 2.4.0 ***
4
5* No changes.
6
7
8
9*** version 2.3.1 ***
10
11* For better support of resizeable Columns, the following core CSS changes have been
12made:
13
14- applied "table-layout:fixed" to TABLE elements
15- removed "overflow:hidden" from TH and TD elements
16- removed "white-space:nowrap" from TD elements
17
18As a result, implementers may notice a change in the widths of their rendered
19DataTables, which should be resolved by setting widths explicitly via CSS or
20your Column definitions.
21
22* Selection model issues have been addressed by clearing up ambiguous ID and
23index usage. Record instances are now assigned globally unique and immutable ID
24strings (no longer numbers). Record indexes are numbers that are mutable in order
25to represent Record order within a RecordSet instance. TR elements are assigned
26DOM ID strings that are *unrelated* to Record instance IDs and Record indexes. Be
27aware that DOM element IDs will get reused when sorting and paginating. Furthermore,
28Column instances are assigned globally unique and immutable ID strings
29(no longer numbers). Column indexes are numbers that are mutable and represent
30Column order within a ColumnSet instance. Please refer to the API documentation
31for details on when to use Record/Column instance IDs, DOM element IDs, and
32Record/Column index numbers.
33
34* Enabling row or cell selection no longer breaks clicks on links and form elements.
35
36
37
38*** version 2.3.0 ***
39
40* DataSource requests over XHR no longer automatically insert a "?" in the URIs
41between the host and the query. Implementers should explicitly include the
42question mark if it is required by your server. Please refer to the XHR
43examples for implementation details.
44
45* Applied new skinning model.
46
47* The MVC model has been stabilized and many APIs have been renamed or changed
48quite a bit from the previous version. Implementers should now only use
49DataTable APIs and not use any Record or RecordSet APIs to add/delete/update
50rows, Records, and DOM elements. RecordSet synchronization will be managed for
51you under the hood. For example, myDataTable.addRow() now accepts an object
52literal of data and will create a Record and update the DOM. Calling
53myDataTable.deleteRow() will delete the appropriate Record and update the DOM.
54Please refer to the API reference for full details on property and method names and
55argument signatures. When possible, Logger messages will provide deprecation warnings,
56so implementers upgrading from the previous version are encouraged to use the debug
57build of DataTable.
58
59* The DataTable constructor signature has changed in 2 major ways:
601) Do not pass in a ColumnSet instance. Instead, pass in an array of Column
61definitions directly, and a ColumnSet instance will be created for you under the hood.
622) In the progressive enhancement case, first instantiate a DataSource pointing
63to your HTML TABLE element, and then pass in that DataSource instance to your
64DataTable constructor. Please refer to the progressive enhancement example
65for implementation details.
66
67* DataTable now extends Element, which has become a required dependency. Implementers
68should now use the myDataTable.set("propertyName", newValue) syntax instead of direct
69dot notation of any properties.
70
71* The underlying pagination architecture and API have been revised. Specifically,
72the property paginator has been deprecated in favor of paginated,
73paginatorOptions has been deprecated in favor of paginator, and related events
74and method names have been changed. Please see the pagination examples for
75implementation details. Please refer to the API reference for full details on
76new property and method names and argument signatures.
77
78* There is a known pagination bug where changing the rows-per-page dropdown while
79on a page number that is out of bounds of the new range, the current page value
80fails to get reset to an appropriate default value.
81
82* There is a known pagination bug where custom containers are ignored.
83
84* There is a known bug where row and cell selections are not tracked correctly in
85paginated DataTables.
86
87* The underlying editing architecture and API have been revised. Specifically, the
88ColumnEditor class is no longer used, the method editCell() has been deprecated
89in favor of showCellEditor(), and the Custom Event "cellEditEvent" is now
90"editorSaveEvent". Please see the inline editing example for
91implementation details. Please refer to the API reference for full details on
92property and method names and argument signatures.
93
94* There is a known issue where the built-in date editor throws a JavaScript
95exception when encountering a null or non-Date value. Implementers using the built-in
96date editor should validate for type Date and avoid null values in these data
97fields.
98
99* The underlying sort architecture, including YAHOO.util.Sort, has been modified
100to accept a single sort function rather than separate functions for ascending
101and descending sorts.
102
103* Scrolling a DataTable with an active Cell Editor will cancel the edit to
104to prevent the Cell Editor's position from getting out of sync with its
105associated TD element.
106
107* The following static methods are executed in the scope of the DataTable
108instance: DataTable.validateNumber(), DataTable.formatButton(),
109DataTable.formatCheckbox(), DataTable.formatCurrency(), DataTable.formatDate(),
110DataTable.formatDropdown(), DataTable.formatEmail(), DataTable.formatLink(),
111DataTable.formatNumber(), DataTable.formatRadio(), DataTable.formatText(),
112DataTable.formatTextarea(), DataTable.formatTextbox().
113
114* The following DataTable APIs have changed:
115- The following static constants have been removed: CLASS_CURRENCY, CLASS_CURRENTPAGE,
116CLASS_DATE, CLASS_EMAIL, CLASS_FIRSTLINK, CLASS_FIRSTPAGE, CLASS_HEADCONTAINER,
117CLASS_HEADRESIZER, CLASS_HEADTEXT, CLASS_HIGHLIGHT, CLASS_LASTLINK, CLASS_LASTPAGE,
118CLASS_LINK, CLASS_NEXTLINK, CLASS_NEXTPAGE, CLASS_NUMBER, CLASS_PAGELINK,
119CLASS_PAGELINKS, CLASS_PAGESELECT, CLASS_PREVLINK, CLASS_PREVPAGE, CLASS_SORTEDBYASC,
120CLASS_SORTEDBYDESC, CLASS_STRING.
121- The following static constants have been added: CLASS_ASC, CLASS_BUTTON,
122CLASS_DEFAULT, CLASS_DESC, CLASS_DISABLED, CLASS_DROPDOWN, CLASS_HEADER,
123CLASS_HIGHLIGHTED, CLASS_LABEL, CLASS_NEXT, CLASS_PAGE, CLASS_PREVIOUS,
124CLASS_RESIZER
125- The property contextMenu is no longer supported.
126- The property dataSource has been deprecated in favor of the accessor method
127getDataSource().
128- The property fixedWidth is not fully supported.
129- The property sortedBy now defines key instead of colKey.
130- The property rowSingleSelect has been deprecated in favor of selectionMode.
131
132* The following Record APIs have changed:
133- Record data values are no longer accessible with oRecord[key] or oRecord.key.
134Implementers should now use oRecord.getData(key).
135- The property yuiRecordId has been deprecated in favor of the accessor method
136getId().
137
138* The following RecordSet APIs have changed:
139- The method getRecordBy() is not implemented.
140- The method insert() has been deprecated in favor of addRecord() and addRecords().
141- The method replace() has been renamed replaceRecords().
142- The method sort() has been deprecated in favor of sortRecords().
143
144* The following Column APIs have changed:
145- Column type has been deprecated in favor of formatter. In your Column
146definitions, please change type:"date" to formatter:"date", type:"currency" to
147formatter:"currency", etc.
148- The property parser is no longer used. Implementers should use the static
149DataSource methods DataSource.parseDate(), DataSource.parseNumber(), and
150DataSource.parseString() for type conversion functionality.
151- The methods getColSpan() and getRowSpan() have been renamed to getColspan()
152and getRowspan().
153- The return value for the method getId() has been changed.
154- The following methods are no longer implemented: parse(), parseCheckbox(),
155parseDate(), parseNumber(), parseSelect(). Implementers should now use a
156DataSource with a data type of HTML TABLE element.
157- The showEditor() method is no longer implemented. Implementers should now use
158the DataTable method showCellEditor().
159- All static formatter functions have been moved from the Column class to the
160DataTable class.
161
162* The DataTable method getColumn() has a known issue where instead of accepting
163a Column's key index value, the method accepts a Column's ID value. Until this
164issue is fixed, implementers can use the following workaround:
165
166    // Instead of this:
167    // var oColumn = myDataTable.getColumn(0);
168
169    // Use this:
170    var oColumn = myDataTable.getColumn(myDataTable.getFirstTrEl().cells[0].yuiColumnId);
171
172
173
174
175
176
177
178
179
180
181*** version 2.2.2 ***
182
183* Removed workaround for a fixed Dom.getXY() bug that was causing a positioning
184problem for inline editors on scrolled pages.
185
186
187
188**** version 2.2.1 ***
189
190* Changed default pagination from enabled to disabled. Must set property
191paginator to true to enable built-in client-side pagination.
192* Removed deleteSelectedRows() and added deleteRows().
193* Deprecated properties isEmpty and isLoading, and methods showLoadingMessage(),
194showEmptyMessage(), and hideTableMessages(). Implementers should now use
195showTableMessage() and hideTableMessage().
196* Deprecated methods paginateRows() and onDataReturnPaginateRows(). Implementers
197should now use popualateTable() and onDataReturnPopulateTable().
198* Deprecated pagination properties pageCurrent, rowsPerPage, startRecordIndex,
199pageLinksLength, rowsPerPageDropdown, pageLinksStart, and pagers.
200* Fixed unclickable links.
201* Fix to support data values of 0 (zero).
202* Fixed broken validation in multiple places when the value 0 (zero) is passed
203in as an argument.
204* Fixed incorrect month output in formatDate().
205* Fixed broken empty message when there are zero rows.
206* Allow implementers to use data with field name "id".
207* Fixed Column resizeability in -min builds.
208* Fixed Column sorting of null, undefined, and empty values.
209* Fixed Column sorting of nested headers.
210* Fixed paginator dropdowns to stay in sync when paginating.
211* Fixed rowSingleSelect for paginated DataTable.
212* Fix for currency values with more than 2 decimal places.
213* Fixed broken TR ID assignments in replaceRows().
214* Fixed Opera UI artifacting problem when repaginating via dropdowns.
215* Fixed orphaned ColumnEditor during pagination or other de facto blur
216interaction. Data gets saved.
217* Extracted non-foundational CSS for scrollable DataTables to make UI easier to
218customize.
219* Updated methods select() and unselect() to also accept an array of elements or
220an array of strings.
221* Improved row selection behavior to model the desktop paradigm (i.e., require
222CONTROL and/or SHIFT keys to multi-select).
223* Tweaked inline editing for better Mac performance.
224* Refactored pagination code to be easier to implement, configure, and extend.
225* Accept an error boolean from DataSource in case of data error and show error
226message.
227* The CustomEvent rowDeleteEvent is now only fired once per deleted row and
228its argument signature has been modified.
229* Added selectRow(), rowSelectEvent, unselectRow(), rowUnselectEvent, rowAddEvent,
230and rowUpdateEvent.
231* Added constants CLASS_TABLE, CLASS_EDITOR, CLASS_FIRST, and CLASS_LAST.
232* Added ColumnEditor class moveContainerTo().
233* Add IDs and class hooks to TABLE element and ColumnEditor's container DIV.
234* Add class hooks to first and last TR elements.
235* Added hook to doBeforeLoadData() for the not-from-markup constructor flow.
236* Added properties paginator and paginatorOptions, as well as method getPaginator().
237* Added methods saveEditorData() and cancelEditorData().
238* Improved type checking with YAHOO.lang.
239
240
241
242**** version 2.2.0 ***
243
244* Beta release.
245* Caption is not supported when scrolling is enabled.
246* Resizeability is not supported for fixed-width DataTables.
Note: See TracBrowser for help on using the repository browser.