datatable-base-debug.js revision 76ca635d61eb3f9fb7c9d788a44fa8b1690aa138
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass CLASS_COLUMNS = YgetClassName(DATATABLE, "columns"),
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass TEMPLATE_THEAD = '<thead class="'+CLASS_COLUMNS+'"></thead>',
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass TEMPLATE_TBODY = '<tbody class="'+CLASS_DATA+'"></tbody>',
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass TEMPLATE_TH = '<th id="{id}" rowspan="{rowspan}" colspan="{colspan}" class="{classnames}" abbr="{abbr}"><div class="'+CLASS_LINER+'">{value}</div></th>',
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass TEMPLATE_TD = '<td headers="{headers}" class="{classnames}"><div class="'+CLASS_LINER+'">{value}</div></td>',
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass TEMPLATE_MSG = '<tbody class="'+CLASS_MSG+'"></tbody>';
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * The Column class defines and manages attributes of Columns for DataTable.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @class Column
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @extends Widget
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @constructor
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass Column.superclass.constructor.apply(this, arguments);
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass/////////////////////////////////////////////////////////////////////////////
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass// STATIC PROPERTIES
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass/////////////////////////////////////////////////////////////////////////////
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * Class name.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @property NAME
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @type String
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @value "column"
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass/////////////////////////////////////////////////////////////////////////////
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass// ATTRIBUTES
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass/////////////////////////////////////////////////////////////////////////////
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @attribute id
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @description Unique internal identifier, used to stamp ID on TH element.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @type String
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @attribute key
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @description User-supplied identifier. Defaults to id.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @type String
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @attribute field
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @description Points to underlying data field (for sorting or formatting,
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * for example). Useful when column doesn't hold any data itself, but is
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * just a visual representation of data from another column or record field.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * Defaults to key.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @type String
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @attribute label
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @description Display label for column header. Defaults to key.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @type String
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @attribute children
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @description Array of child column definitions (for nested headers).
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @type String
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @attribute abbr
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @description TH abbr attribute.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @type String
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass //TODO: support custom classnames
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass // TH CSS classnames
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass // Column formatter
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass //requires datatable-sort
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass //sortOptions:defaultDir, sortFn, field
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass //TODO: support editable columns
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass // Column editor
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass //TODO: support resizeable columns
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass //TODO: support setting widths
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass // requires datatable-colresize
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass/////////////////////////////////////////////////////////////////////////////
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass/////////////////////////////////////////////////////////////////////////////
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass /////////////////////////////////////////////////////////////////////////////
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass // ATTRIBUTE HELPERS
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass /////////////////////////////////////////////////////////////////////////////
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @method _defaultId
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @description Return ID for instance.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @returns String
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass _defaultId: function() {
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @method _defaultKey
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @description Return key for instance. Defaults to ID if one was not
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @returns String
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @method _defaultField
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @description Return field for instance. Defaults to key if one was not
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @returns String
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @method _defaultLabel
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @description Return label for instance. Defaults to key if one was not
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @returns String
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * Updates the UI if changes are made to abbr.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @method _afterAbbrChange
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @param e {Event} Custom event for the attribute change.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass _afterAbbrChange: function (e) {
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass /////////////////////////////////////////////////////////////////////////////
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass // PROPERTIES
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass /////////////////////////////////////////////////////////////////////////////
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * Reference to Column's current position index within its Columnset's keys
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * array, if applicable. This property only applies to non-nested and bottom-
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * level child Columns. Value is set by Columnset code.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @property keyIndex
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @type Number
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @property headers
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @description Array of TH IDs associated with this column, for TD "headers"
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * attribute. Value is set by Columnset code
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @type String[]
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * Number of cells the header spans. Value is set by Columnset code.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @property colSpan
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @type Number
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @default 1
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * Number of rows the header spans. Value is set by Columnset code.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @property rowSpan
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @type Number
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @default 1
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * Column's parent Column instance, if applicable. Value is set by Columnset
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @property parent
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @type Y.Column
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * The Node reference to the associated TH element.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @property thNode
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @type Y.Node
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * The Node reference to the associated liner element.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @property thLinerNode
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @type Y.Node
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass thLinerNode: null,*/
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass /////////////////////////////////////////////////////////////////////////////
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass /////////////////////////////////////////////////////////////////////////////
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * Initializer.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @method initializer
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @param config {Object} Config object.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * Destructor.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @method destructor
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass destructor: function() {
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * Returns classnames for Column.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @method _getClassnames
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass _getClassnames: function () {
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass return Y.ClassNameManager.getClassName(COLUMN, this.get("id"));
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass /*var allClasses;
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass // Add CSS classes
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass if(lang.isString(oColumn.className)) {
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass // Single custom class
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass allClasses = [oColumn.className];
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass else if(lang.isArray(oColumn.className)) {
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass // Array of custom classes
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass allClasses = oColumn.className;
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass // no custom classes
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass allClasses = [];
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass // Hook for setting width with via dynamic style uses key since ID is too disposable
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass allClasses[allClasses.length] = this.getId() + "-col-" +oColumn.getSanitizedKey();
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass // Column key - minus any chars other than "A-Z", "a-z", "0-9", "_", "-", ".", or ":"
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass allClasses[allClasses.length] = "yui-dt-col-" +oColumn.getSanitizedKey();
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass var isSortedBy = this.get("sortedBy") || {};
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass if(oColumn.key === isSortedBy.key) {
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass allClasses[allClasses.length] = isSortedBy.dir || '';
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass if(oColumn.hidden) {
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass allClasses[allClasses.length] = DT.CLASS_HIDDEN;
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass if(oColumn.selected) {
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass allClasses[allClasses.length] = DT.CLASS_SELECTED;
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass if(oColumn.sortable) {
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass allClasses[allClasses.length] = DT.CLASS_SORTABLE;
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass // Resizeable
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass if(oColumn.resizeable) {
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass allClasses[allClasses.length] = DT.CLASS_RESIZEABLE;
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass if(oColumn.editor) {
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass allClasses[allClasses.length] = DT.CLASS_EDITABLE;
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass // Addtnl classes, including First/Last
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass if(aAddClasses) {
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass allClasses = allClasses.concat(aAddClasses);
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass return allClasses.join(' ');*/
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass ////////////////////////////////////////////////////////////////////////////
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass ////////////////////////////////////////////////////////////////////////////
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * Syncs UI to intial state.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @method syncUI
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass syncUI: function() {
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * Updates abbr.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @method _uiSetAbbr
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @param val {String} New abbr.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @protected
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * The Columnset class defines and manages a collection of Columns.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @class Columnset
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @extends Base
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @constructor
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass Columnset.superclass.constructor.apply(this, arguments);
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass/////////////////////////////////////////////////////////////////////////////
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass// STATIC PROPERTIES
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass/////////////////////////////////////////////////////////////////////////////
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * Class name.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @property NAME
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @type String
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @value "columnset"
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass /////////////////////////////////////////////////////////////////////////////
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass // ATTRIBUTES
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass /////////////////////////////////////////////////////////////////////////////
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @attribute definitions
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @description Array of column definitions that will populate this Columnset.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @type Array
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass/////////////////////////////////////////////////////////////////////////////
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass/////////////////////////////////////////////////////////////////////////////
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass /////////////////////////////////////////////////////////////////////////////
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass // ATTRIBUTE HELPERS
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass /////////////////////////////////////////////////////////////////////////////
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @method _setDefinitions
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @description Clones definitions before setting.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @param definitions {Array} Array of column definitions.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @returns Array
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass /////////////////////////////////////////////////////////////////////////////
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass // PROPERTIES
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass /////////////////////////////////////////////////////////////////////////////
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * Top-down tree representation of Column hierarchy. Used to create DOM
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @property tree
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @type Y.Column[]
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * Hash of all Columns by ID.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @property idHash
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @type Object
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * Hash of all Columns by key.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @property keyHash
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @type Object
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * Array of only Columns that are meant to be displayed in DOM.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @property keys
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @type Y.Column[]
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass /////////////////////////////////////////////////////////////////////////////
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass /////////////////////////////////////////////////////////////////////////////
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * Initializer. Generates all internal representations of the collection of
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @method initializer
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @param config {Object} Config object.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass initializer: function() {
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass // DOM tree representation of all Columns
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass // Hash of all Columns by ID
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass // Hash of all Columns by key
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass // Flat representation of only Columns that are meant to display data
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass // Original definitions
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass // Internal recursive function to define Column instances
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass function parseColumns(depth, currentDefinitions, parent) {
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass // One level down
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass // Create corresponding dom node if not already there for this depth
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass // Parse each node at this depth for attributes and any children
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass for(; i<len; ++i) {
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass currentDefinition = YLang.isString(currentDefinition) ? {key:currentDefinition} : currentDefinition;
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass // Instantiate a new Column for each node
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass // Cross-reference Column ID back to the original object literal definition
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass // Add the new Column to the hash
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass // Assign its parent as an attribute, if applicable
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass // The Column has descendants
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass self._cascadePropertiesToChildren(column, currentChildren);
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass // The children themselves must also be parsed for Column instances
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass // This Column does not have any children
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass // Default is already 1
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass //column.colSpan = 1;
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass // Add the Column to the top-down dom tree
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass // Parse out Column instances from the array of object literals
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass // Save to the Columnset instance
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * Destructor.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @method destructor
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass destructor: function() {
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass /////////////////////////////////////////////////////////////////////////////
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass // COLUMN HELPERS
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass /////////////////////////////////////////////////////////////////////////////
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * Cascade certain properties to children if not defined on their own.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @method _cascadePropertiesToChildren
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass _cascadePropertiesToChildren: function(column, currentChildren) {
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass //TODO: this is all a giant todo
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass // Cascade certain properties to children if not defined on their own
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass for(; i<len; ++i) {
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass if(column.get("className") && (child.className === undefined)) {
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass if(column.get("editor") && (child.editor === undefined)) {
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass if(column.get("formatter") && (child.formatter === undefined)) {
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass if(column.get("resizeable") && (child.resizeable === undefined)) {
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass if(column.get("sortable") && (child.sortable === undefined)) {
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass if(column.get("width") && (child.width === undefined)) {
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass if(column.get("minWidth") && (child.minWidth === undefined)) {
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass if(column.get("maxAutoWidth") && (child.maxAutoWidth === undefined)) {
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @method _setColSpans
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @description Calculates and sets colSpan attribute on given Column.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @param column {Array} Column instance.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @param definition {Object} Column definition.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass // Determine COLSPAN value for this Column
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass // Drill down each branch and count terminal nodes
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass for(; i<len; ++i) {
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass // Keep drilling down
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass // Reached branch terminus
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @method _setRowSpans
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @description Calculates and sets rowSpan attribute on all Columns.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass // Determine ROWSPAN value for each Column in the DOM tree
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass // Calculate the max depth of descendants for this row
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass for(; i<len; ++i) {
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass // Column has children, so keep counting
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass // Column has children, so keep counting
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass else if(col.get && YLang.isArray(col.get("children"))) {
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass countMaxRowDepth(col.get("children"), tmpRowDepth);
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass // No children, is it the max depth?
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass // Count max row depth for each row
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass // Assign the right ROWSPAN values to each Column in the row
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass if(!YLang.isArray(currentColumn.get("children"))) {
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass // Default is already 1
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass // else currentColumn.rowSpan =1;
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass // Reset counter for next row
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @method _setHeaders
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @description Calculates and sets headers attribute on all Columns.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass _setHeaders: function() {
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass function recurseAncestorsForHeaders(headers, column) {
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass recurseAncestorsForHeaders(headers, column.parent);
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass for(; i<len; ++i) {
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass getColumn: function() {
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * The DataTable widget provides a progressively enhanced DHTML control for
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * displaying tabular data across A-grade browsers.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @module datatable
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * Provides the base DataTable implementation, which can be extended to add
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * additional functionality, such as sorting or scrolling.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @module datatable
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @submodule datatable-base
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * Base class for the DataTable widget.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @class DataTable.Base
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @extends Widget
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @constructor
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass DTBase.superclass.constructor.apply(this, arguments);
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass/////////////////////////////////////////////////////////////////////////////
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass// STATIC PROPERTIES
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass/////////////////////////////////////////////////////////////////////////////
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * Class name.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @property NAME
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @type String
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @value "dataTable"
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass/////////////////////////////////////////////////////////////////////////////
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass// ATTRIBUTES
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass/////////////////////////////////////////////////////////////////////////////
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @attribute columnset
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @description Pointer to Columnset instance.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @type Array | Y.Columnset
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @attribute recordset
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @description Pointer to Recordset instance.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @type Array | Y.Recordset
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @attribute state
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @description Internal state.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass value: new Y.State(),
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass readOnly: true
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @attribute summary
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @description Summary.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @type String
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @attribute caption
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @description Caption
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @type String
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @attribute thValueTemplate
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @description Tokenized markup template for TH value.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @type String
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @default '{value}'
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @attribute tdValueTemplate
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @description Tokenized markup template for TD value.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @type String
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @default '{value}'
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @attribute trTemplate
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @description Tokenized markup template for TR node creation.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @type String
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @default '<tr id="{id}"></tr>'
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass/////////////////////////////////////////////////////////////////////////////
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass// TODO: HTML_PARSER
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass/////////////////////////////////////////////////////////////////////////////
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass /*caption: function (srcNode) {
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass/////////////////////////////////////////////////////////////////////////////
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass/////////////////////////////////////////////////////////////////////////////
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @property thTemplate
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @description Tokenized markup template for TH node creation.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @type String
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @default '<th id="{id}" rowspan="{rowspan}" colspan="{colspan}" class="{classnames}" abbr="{abbr}"><div class="'+CLASS_LINER+'">{value}</div></th>'
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @property tdTemplate
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @description Tokenized markup template for TD node creation.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @type String
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @default '<td headers="{headers}"><div class="'+CLASS_LINER+'">{value}</div></td>'
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @property _theadNode
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @description Pointer to THEAD node.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @type Y.Node
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @property _tbodyNode
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @description Pointer to TBODY node.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @type Y.Node
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @property _msgNode
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @description Pointer to message display node.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @type Y.Node
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass /////////////////////////////////////////////////////////////////////////////
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass // ATTRIBUTE HELPERS
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass /////////////////////////////////////////////////////////////////////////////
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @method _setColumnset
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @description Converts Array to Y.Columnset.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @param columns {Array | Y.Columnset}
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @returns Y.Columnset
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass return YLang.isArray(columns) ? new Y.Columnset({definitions:columns}) : columns;
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * Updates the UI if Columnset is changed.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @method _afterColumnsetChange
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @param e {Event} Custom event for the attribute change.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @protected
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @method _setRecordset
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @description Converts Array to Y.Recordset.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @param records {Array | Y.Recordset}
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @returns Y.Recordset
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * Updates the UI if Recordset is changed.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @method _afterRecordsetChange
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @param e {Event} Custom event for the attribute change.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @protected
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * Updates the UI if summary is changed.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @method _afterSummaryChange
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @param e {Event} Custom event for the attribute change.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @protected
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass _afterSummaryChange: function (e) {
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * Updates the UI if caption is changed.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @method _afterCaptionChange
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @param e {Event} Custom event for the attribute change.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @protected
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass _afterCaptionChange: function (e) {
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass /////////////////////////////////////////////////////////////////////////////
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass /////////////////////////////////////////////////////////////////////////////
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * Initializer.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @method initializer
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @param config {Object} Config object.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass this.after("columnsetChange", this._afterColumnsetChange);
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass this.after("recordsetChange", this._afterRecordsetChange);
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass this.after("summaryChange", this._afterSummaryChange);
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass this.after("captionChange", this._afterCaptionChange);
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * Destructor.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @method destructor
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass destructor: function() {
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass ////////////////////////////////////////////////////////////////////////////
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass ////////////////////////////////////////////////////////////////////////////
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * Renders UI.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @method renderUI
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass renderUI: function() {
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass return (this._addTableNode(this.get("contentBox")) &&
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass // Primary TBODY
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass // Message TBODY
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * Creates and attaches TABLE element to given container.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @method _addTableNode
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @param containerNode {Y.Node} Parent node.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @protected
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @returns Y.Node
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass this._tableNode = containerNode.appendChild(Ycreate(TEMPLATE_TABLE));
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * Creates and attaches COLGROUP element to given TABLE.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @method _addColgroupNode
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @param tableNode {Y.Node} Parent node.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @protected
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @returns Y.Node
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass // Add COLs to DOCUMENT FRAGMENT
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass for(; i<len; ++i) {
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass // Create COLGROUP
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass this._colgroupNode = tableNode.insertBefore(Ycreate(allCols.join("")), tableNode.get("firstChild"));
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * Creates and attaches THEAD element to given container.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @method _addTheadNode
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @param tableNode {Y.Node} Parent node.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @protected
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @returns Y.Node
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass this._theadNode = tableNode.insertBefore(Ycreate(TEMPLATE_THEAD), this._colgroupNode.next());
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * Creates and attaches TBODY element to given container.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @method _addTbodyNode
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @param tableNode {Y.Node} Parent node.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @protected
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @returns Y.Node
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass this._tbodyNode = tableNode.appendChild(Ycreate(TEMPLATE_TBODY));
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * Creates and attaches message display element to given container.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @method _addMessageNode
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @param tableNode {Y.Node} Parent node.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @protected
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @returns Y.Node
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass this._msgNode = tableNode.insertBefore(Ycreate(TEMPLATE_MSG), this._tbodyNode);
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * Creates and attaches CAPTION element to given container.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @method _addCaptionNode
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @param tableNode {Y.Node} Parent node.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @protected
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @returns Y.Node
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass ////////////////////////////////////////////////////////////////////////////
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass ////////////////////////////////////////////////////////////////////////////
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * Binds events.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @method bindUI
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass bindUI: function() {
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass var theadFilter = "thead."+CLASS_COLUMNS+">tr>th",
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass //TODO: is this necessary?
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass this.get("boundingBox").delegate.apply(this.get("boundingBox"), arguments);
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass this.get("contentBox").delegate.apply(this.get("contentBox"), arguments);
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass ////////////////////////////////////////////////////////////////////////////
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass ////////////////////////////////////////////////////////////////////////////
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * Syncs UI to intial state.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @method syncUI
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass syncUI: function() {
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass // THEAD ROWS
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass // DATA ROWS
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * Updates summary.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @method _uiSetSummary
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @param val {String} New summary.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @protected
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * Updates caption.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @method _uiSetCaption
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @param val {String} New caption.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @protected
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass ////////////////////////////////////////////////////////////////////////////
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass // THEAD/COLUMNSET FUNCTIONALITY
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass ////////////////////////////////////////////////////////////////////////////
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * Updates THEAD.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @method _uiSetColumnset
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @param cs {Y.Columnset} New Columnset.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @protected
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass // Move THEAD off DOM
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass // Iterate tree of columns to add THEAD rows
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass for(; i<len; ++i) {
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass this._addTheadTrNode({thead:thead, columns:tree[i]}, (i === 0), (i === len-1));
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass // Column helpers needs _theadNode to exist
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass //this._createColumnHelpers();
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass // Re-attach THEAD to DOM
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * Creates and attaches header row element.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @method _addTheadTrNode
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @param o {Object} {thead, columns}.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @param isFirst {Boolean} Is first row.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @param isFirst {Boolean} Is last row.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @protected
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass o.tr = this._createTheadTrNode(o, isFirst, isLast);
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * Creates header row element.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @method _createTheadTrNode
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @param o {Object} {thead, columns}.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @param isFirst {Boolean} Is first row.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @param isLast {Boolean} Is last row.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @protected
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @returns Y.Node
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass _createTheadTrNode: function(o, isFirst, isLast) {
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass //TODO: custom classnames
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass var tr = Ycreate(Ysubstitute(this.get("trTemplate"), o)),
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass // Set FIRST/LAST class
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass for(; i<len; ++i) {
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass this._addTheadThNode({value:column.get("label"), column: column, tr:tr});
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * Attaches header row element.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @method _attachTheadTrNode
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @param o {Object} {thead, columns, tr}.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @protected
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * Creates and attaches header cell element.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @method _addTheadThNode
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @param o {Object} {value, column, tr}.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @protected
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass _addTheadThNode: function(o) {
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass //TODO: assign all node pointers: thNode, thLinerNode, thLabelNode
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * Creates header cell element.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @method _createTheadThNode
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @param o {Object} {value, column, tr}.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @protected
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @returns Y.Node
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass // Populate template object
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass o.id = column.get("id");//TODO: validate 1 column ID per document
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass o.value = Ysubstitute(this.get("thValueTemplate"), o);
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass // Clear minWidth on hidden Columns
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass if(column.get("hidden")) {
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass //this._clearMinWidth(column);
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * Attaches header cell element.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @method _attachTheadThNode
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @param o {Object} {value, column, tr}.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @protected
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass ////////////////////////////////////////////////////////////////////////////
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass // TBODY/RECORDSET FUNCTIONALITY
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass ////////////////////////////////////////////////////////////////////////////
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * Updates TBODY.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @method _uiSetRecordset
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @param rs {Y.Recordset} New Recordset.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @protected
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass len = rs.getLength(), //TODOthis.get("state.pageLength")
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass // Replace TBODY with a new one
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass //TODO: split _addTbodyNode into create/attach
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass // Iterate Recordset to use existing TR when possible or add new TR
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass for(; i<len; ++i) {
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass this._addTbodyTrNode(o); //TODO: sometimes rowindex != recordindex
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass // TBODY to DOM
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * Creates and attaches data row element.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @method _addTbodyTrNode
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @param o {Object} {tbody, record}
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @protected
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass _addTbodyTrNode: function(o) {
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass o.tr = tbody.one("#"+record.get("id")) || this._createTbodyTrNode(o);
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * Creates data row element.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @method _createTbodyTrNode
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @param o {Object} {tbody, record}
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @protected
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @returns Y.Node
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass var tr = Ycreate(Ysubstitute(this.get("trTemplate"), {id:o.record.get("id")})),
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass for(; i<len; ++i) {
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * Attaches data row element.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @method _attachTbodyTrNode
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @param o {Object} {tbody, record, tr}.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @protected
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass nextSibling = tbody.get("children").item(index) || null,
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * Creates and attaches data cell element.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @method _addTbodyTdNode
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @param o {Object} {record, column, tr}.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @protected
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass _addTbodyTdNode: function(o) {
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * Creates data cell element.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @method _createTbodyTdNode
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @param o {Object} {record, column, tr}.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @protected
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @returns Y.Node
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass //TODO: attributes? or methods?
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * Attaches data cell element.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @method _attachTbodyTdNode
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @param o {Object} {record, column, tr, headers, classnames, value}.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @protected
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * Returns markup to insert into data cell element.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @method formatDataCell
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @param @param o {Object} {record, column, tr, headers, classnames}.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass formatDataCell: function(o) {
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass Ysubstitute(this.get("tdValueTemplate"), o); // Default template
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass _initRecordset: function () {
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass}, '@VERSION@' ,{requires:['recordset-base','widget','substitute','event-mouseenter']});