## DataTable : object 前端数据模型对象 * [DataTable](#DataTable) : object * _instance_ * [.id](#DataTable+id) : string * [.strict](#DataTable+strict) : boolean * [.meta](#DataTable+meta) : object * [.enable](#DataTable+enable) : boolean * [.pageSize](#DataTable+pageSize) : number * [.pageIndex](#DataTable+pageIndex) : number * [.totalPages](#DataTable+totalPages) : number * [.pageCache](#DataTable+pageCache) : boolean * [.params](#DataTable+params) : object * [.master](#DataTable+master) : string * [.dateNoConvert](#DataTable+dateNoConvert) : boolean * _static_ * [.copyRow(index, row)](#DataTable.copyRow) * [.copyRows(index, rows)](#DataTable.copyRows) * [.setData(data, options)](#DataTable.setData) * [.setValue(fieldName, value, [row], [ctx])](#DataTable.setValue) * [.isEnable([fieldName])](#DataTable.isEnable) ⇒ boolean * [.setEnable(enable)](#DataTable.setEnable) * [.getCurrentRow()](#DataTable.getCurrentRow) ⇒ null | u.Row * [.getCurrentIndex()](#DataTable.getCurrentIndex) ⇒ number * [.getData()](#DataTable.getData) ⇒ array * [.getDataByRule(rule)](#DataTable.getDataByRule) ⇒ array * [.getRow(index)](#DataTable.getRow) ⇒ object * [.getRowByRowId(rowid)](#DataTable.getRowByRowId) ⇒ Row * [.getRowIndex(需要获取索引的row对象)](#DataTable.getRowIndex) ⇒ \* * [.getRowsByField(field, value)](#DataTable.getRowsByField) ⇒ array * [.getRowByField(field, value)](#DataTable.getRowByField) ⇒ u.Row * [.getAllRows()](#DataTable.getAllRows) ⇒ array * [.getAllPageRows()](#DataTable.getAllPageRows) ⇒ array * [.getChangedDatas(withEmptyRow)](#DataTable.getChangedDatas) ⇒ array * [.getChangedRows()](#DataTable.getChangedRows) ⇒ array * [.getValue(fieldName, [row])](#DataTable.getValue) ⇒ string * [.getIndexByRowId(rowId)](#DataTable.getIndexByRowId) * [.getAllDatas()](#DataTable.getAllDatas) ⇒ array * [.getRowIdsByIndices(indices)](#DataTable.getRowIdsByIndices) ⇒ array * [.getFocusRow()](#DataTable.getFocusRow) ⇒ u.Row * [.getFocusIndex()](#DataTable.getFocusIndex) ⇒ number * [.getMeta([fieldName], [key])](#DataTable.getMeta) ⇒ object * [.getRowMeta([fieldName], [key])](#DataTable.getRowMeta) ⇒ object * [.getParam(key)](#DataTable.getParam) ⇒ \* * [.getSelectedIndex()](#DataTable.getSelectedIndex) ⇒ number * [.getSelectedIndices()](#DataTable.getSelectedIndices) ⇒ array * [.getSelectedDatas([withEmptyRow])](#DataTable.getSelectedDatas) ⇒ array * [.getSelectedRows()](#DataTable.getSelectedRows) ⇒ array * [.getSimpleData([options])](#DataTable.getSimpleData) ⇒ array * [.setMeta(fieldName, key, value)](#DataTable.setMeta) * [.updateMeta(meta)](#DataTable.updateMeta) * [.addParam(key, value)](#DataTable.addParam) * [.addParams(params)](#DataTable.addParams) * [.refSelectedRows(fieldName)](#DataTable.refSelectedRows) * [.ref(fieldName)](#DataTable.ref) * [.refMeta(fieldName, key)](#DataTable.refMeta) * [.refRowMeta(fieldName, key)](#DataTable.refRowMeta) * [.refEnable(fieldName)](#DataTable.refEnable) * [.removeRowByRowId(rowId)](#DataTable.removeRowByRowId) * [.removeRow(index)](#DataTable.removeRow) * [.removeAllRows()](#DataTable.removeAllRows) * [.removeRows(indices)](#DataTable.removeRows) * [.clear()](#DataTable.clear) * [.addRow(row)](#DataTable.addRow) * [.addRows(rows)](#DataTable.addRows) * [.insertRow(index, row)](#DataTable.insertRow) * [.insertRows(index, rows)](#DataTable.insertRows) * [.createEmptyRow()](#DataTable.createEmptyRow) ⇒ u.Row * [.setAllRowsSelect()](#DataTable.setAllRowsSelect) * [.setRowSelect(index)](#DataTable.setRowSelect) * [.setRowsSelect(indices)](#DataTable.setRowsSelect) * [.addRowSelect(index)](#DataTable.addRowSelect) * [.addRowsSelect(indices)](#DataTable.addRowsSelect) * [.setAllRowsUnSelect([options])](#DataTable.setAllRowsUnSelect) * [.setRowUnSelect(index)](#DataTable.setRowUnSelect) * [.setRowsUnSelect(indices)](#DataTable.setRowsUnSelect) * [.toggleAllSelect()](#DataTable.toggleAllSelect) * [.setRowFocus(index, [quiet], [force])](#DataTable.setRowFocus) * [.setRowUnFocus()](#DataTable.setRowUnFocus) * [.setSimpleData(data, [options])](#DataTable.setSimpleData) * [.addSimpleData(data, status)](#DataTable.addSimpleData) * [.on(name, [callback], [one])](#DataTable.on) ⇒ [DataTable](#DataTable) * [.off(name, [callback])](#DataTable.off) ⇒ [DataTable](#DataTable) * [.one(name, [callback])](#DataTable.one) * [.trigger(name)](#DataTable.trigger) ⇒ [DataTable](#DataTable) ### dataTable.id : string DataTable对应的唯一标识 ### dataTable.strict : boolean 在设置数据时是否自动创建对应字段，如果为true则不自动创建，如果为false则自动创建缺失的字段 **Default**: false ### dataTable.meta : object DataTable的所有字段属性信息 ### dataTable.enable : boolean DataTable的是否支持编辑功能 **Default**: true ### dataTable.pageSize : number DataTable支持翻页功能时每页显示数据条数 **Default**: 20 ### dataTable.pageIndex : number DataTable支持翻页功能时当前页码 **Default**: 0 ### dataTable.totalPages : number DataTable支持翻页功能时总页数 **Default**: 0 ### dataTable.pageCache : boolean DataTable的是否支持前端缓存，支持前端缓存则前端会存储所有页的数据信息，否则只保存当前页的数据信息。如果使用前端缓存则需要使用框架封装的fire方法来与后台进行交互 **Default**: false ### dataTable.params : object 使用者自定义的属性合集，框架内部不会针对此属性进行特殊处理，仅用于设置及获取 ### dataTable.master : string 使用者自定义的属性，框架内部不会针对此属性进行特殊处理，仅用于设置及获取。 ### dataTable.dateNoConvert : boolean 通过getSimpleData获取数据时，日期字段是否转化为long型，如果为true时不进行转化，为false时转化为long型 **Default**: false ### DataTable.copyRow(index, row) 在指定index位置插入单条数据行 | 参数 | 类型 | 描述 | | --- | --- | --- | | index | number | 数据行插入之后的位置 | | row | object | 数据行信息 | **Example** ```js var row = { field1:'value1' } datatable.copyRow(1,row) ``` ### DataTable.copyRows(index, rows) 在指定index位置插入多条数据行 | 参数 | 类型 | 描述 | | --- | --- | --- | | index | number | 数据行插入之后的位置 | | rows | array | 存储数据行信息的数组 | **Example** ```js var row1 = { field1:'value1' } var row2 = { field1:'value1' } datatable.copyRow(1,[row1,row2]) ``` ### DataTable.setData(data, options) 设置数据信息 | 参数 | 类型 | Default | 描述 | | --- | --- | --- | --- | | data | object | | 需要设置的数据信息，必须包含rows或者pages属性 | | [data.rows] | array | | 数据信息中的行信息数组 | | [data.pages] | array | | 数据信息中的page对象数组 | | [data.pageIndex] | number | DataTable对象当前的页码 | 数据信息中的当前页码 | | [data.pageSize] | number | DataTable对象当前的每页显示条数 | 数据信息中的每页显示条数 | | [data.totalPages] | number | DataTable对象当前的总页数 | 数据信息中的总页数 | | [data.totalRow] | number | 如果存在rows则为rows的长度，否则为DataTable对象当前的总条数 | 数据信息中的总条数 | | [data.select] | number | | 数据信息中的选中行行号 | | [data.focus] | number | | 数据信息中的focus行行号 | | options | object | | 设置数据时的配置参数 | | options.unSelect | boolean | false | 是否默认选中第一行，如果为true则不选中第一行，否则选中第一行 | **Example** ```js var data = { rows:[{ filed1:'value1', field2:'value2' },{ filed1:'value11', field2:'value21' }], select:0, } var op = { unSelect:true } datatable.setData(data,op) ``` ### DataTable.setValue(fieldName, value, [row], [ctx]) 设置对应行对应字段的值 | 参数 | 类型 | Default | 描述 | | --- | --- | --- | --- | | fieldName | string | | 需要设置的字段 | | value | string | | 需要设置的值 | | [row] | u.row | 当前行 | 需要设置的u.row对象， | | [ctx] | \* | | 自定义属性，在valuechange监听传入对象中可通过ctx获取此处设置 | **Example** ```js datatable.setValue('filed1','value1') //设置当前行字段值 var row = datatable.getRow(1) datatable.setValue('filed1','value1',row) //设置在指定行字段值 datatable.setValue('filed1','value1',row,'ctx') //设置在指定行字段值，同时传入自定义数据 ``` ### DataTable.isEnable([fieldName]) ⇒ boolean 判断DataTable或指定字段是否可修改 **返回值**: boolean - DataTable/指定字段是否可修改 | 参数 | 类型 | 描述 | | --- | --- | --- | | [fieldName] | string | 需要进行判断的字段值 | **Example** ```js datatable.isEnable() //获取datatable是否可修改 datatable.isEnable('field1') //获取字段field1是否可修改 ``` ### DataTable.setEnable(enable) 设置DataTable是否可修改 | 参数 | 类型 | 描述 | | --- | --- | --- | | enable | boolean | true表示可修改，否则表示不可修改 | **Example** ```js datatable.setEnable(true) ``` ### DataTable.getCurrentRow() ⇒ null | u.Row 获取DataTable对象的当前行 **返回值**: null | u.Row - DataTable对象的当前行 **Example** ```js datatable.getCurrentRow() ``` ### DataTable.getCurrentIndex() ⇒ number 获取DataTable对象的当前行对应的index **返回值**: number - DataTable对象的当前行对应的index **Example** ```js datatable.getCurrentIndex() ``` ### DataTable.getData() ⇒ array 获取DataTable的数据信息 **返回值**: array - 数据信息对应的数组，每项对应一条数据 **Example** ```js datatable.getData() ``` ### DataTable.getDataByRule(rule) ⇒ array 按照特定规则获取数据 **返回值**: array - 按照规则获取到的数据信息 | 参数 | 类型 | 描述 | | --- | --- | --- | | rule | string | DataTable.SUBMIT.current('current') ：当前选中行 DataTable.SUBMIT.focus('focus') ：当前focus行 DataTable.SUBMIT.all('all') ：所有行 DataTable.SUBMIT.select('select') ：当前页选中行 DataTable.SUBMIT.change('change') ：发生改变的行 DataTable.SUBMIT.empty('empty') ：不获取数据，返回空数组 DataTable.SUBMIT.allSelect('allSelect') ：所有页选中行 DataTable.SUBMIT.allPages('allPages') ：所有页的数据 | **Example** ```js datatable.getDataByRule(‘all’) ``` ### DataTable.getRow(index) ⇒ object 根据索引获取指定行数据信息 **返回值**: object - 获取到的指定行数据信息 | 参数 | 类型 | 描述 | | --- | --- | --- | | index | number | 需要获取的数据信息的索引 | **Example** ```js datatable.getRow(1) ``` ### DataTable.getRowByRowId(rowid) ⇒ Row 根据rowid获取Row对象 | 参数 | 类型 | 描述 | | --- | --- | --- | | rowid | string | 需要获取的Row对应的rowid | **Example** ```js datatable.getRowByRowId('rowid') ``` ### DataTable.getRowIndex(需要获取索引的row对象) ⇒ \* 获取Row对象对应的索引 | 参数 | 类型 | | --- | --- | | 需要获取索引的row对象 | u.Row | **Example** ```js var row = datatable.getRow(1) datatable.getRowIndex(row) // 1 ``` ### DataTable.getRowsByField(field, value) ⇒ array 根据字段及字段值获取所有数据行 **返回值**: array - 根据字段及字段值获取的所有数据行 | 参数 | 类型 | 描述 | | --- | --- | --- | | field | string | 需要获取行的对应字段 | | value | string | 需要获取行的对应字段值 | **Example** ```js datatable.getRowsByField('field1','value1') ``` ### DataTable.getRowByField(field, value) ⇒ u.Row 根据字段及字段值获取第一条数据行 **返回值**: u.Row - 根据字段及字段值获取第一条数据行 | 参数 | 类型 | 描述 | | --- | --- | --- | | field | string | 需要获取行的对应字段 | | value | string | 需要获取行的对应字段值 | **Example** ```js datatable.getRowByField('field1','value1') ``` ### DataTable.getAllRows() ⇒ array 获取当前页的所有数据行 **返回值**: array - 获取到的数据行 **Example** ```js datatable.getAllRows() ``` ### DataTable.getAllPageRows() ⇒ array 获取所有页的所有数据行 **返回值**: array - 获取到的数据行 **Example** ```js datatable.getAllPageRows() ``` ### DataTable.getChangedDatas(withEmptyRow) ⇒ array 获取发生变化的数据信息 **返回值**: array - 发生变化的数据信息 | 参数 | 类型 | Default | 描述 | | --- | --- | --- | --- | | withEmptyRow | boolean | false | 未发生变化的数据是否使用空行代替，true表示以空行代替未发生变化行，false相反 | **Example** ```js datatable.getChangedDatas() ``` ### DataTable.getChangedRows() ⇒ array 获取发生改变的Row对象 **返回值**: array - 发生改变的Row对象 **Example** ```js datatable.getChangedRows() ``` ### DataTable.getValue(fieldName, [row]) ⇒ string 根据字段获取对应Row对象的字段值 **返回值**: string - 获取到的字段值 | 参数 | 类型 | Default | 描述 | | --- | --- | --- | --- | | fieldName | string | | 需要获取的值对应的字段 | | [row] | u.Row | 默认为当前行 | 对应的数据行 | **Example** ```js datatable.getValue('field1') var row = datatable.getRow(1) datatable.getValue('field1',row) ``` ### DataTable.getIndexByRowId(rowId) 根据行号获取行索引 | 参数 | 类型 | | --- | --- | | rowId | String | **Example** ```js datatable.getIndexByRowId('rowid') ``` ### DataTable.getAllDatas() ⇒ array 获取所有行数据信息 **返回值**: array - 所有行数据信息 **Example** ```js datatable.getAllDatas() ``` ### DataTable.getRowIdsByIndices(indices) ⇒ array 根据索引获取rowid **返回值**: array - 获取到的rowid | 参数 | 类型 | 描述 | | --- | --- | --- | | indices | array | 需要获取rowid的索引值 | **Example** ```js datatable.getRowIdsByIndices([1,2,5]) ``` ### DataTable.getFocusRow() ⇒ u.Row 获取焦点行 **返回值**: u.Row - 焦点行 **Example** ```js datatable.getFocusRow() ``` ### DataTable.getFocusIndex() ⇒ number 获取焦点行索引 **返回值**: number - 焦点行索引 **Example** ```js datatable.getFocusIndex() ``` ### DataTable.getMeta([fieldName], [key]) ⇒ object 获取meta信息 **返回值**: object - meta信息 | 参数 | 类型 | 描述 | | --- | --- | --- | | [fieldName] | string | 需要获取的字段 | | [key] | string | 需要获取的字段指定meta信息 | **Example** ```js datatable.getMeta() // 获取所有meta信息 datatable.getMeta('field1') // 获取field1所有meta信息 datatable.getMeta('field1','type') // 获取field1的key信息 ``` ### DataTable.getRowMeta([fieldName], [key]) ⇒ object 获取当前行的meta信息，如果不存在当前行则获取DataTable的meta信息 **返回值**: object - meta信息 | 参数 | 类型 | 描述 | | --- | --- | --- | | [fieldName] | string | 需要获取的字段 | | [key] | string | 需要获取的字段指定meta信息 | **Example** ```js datatable.getRowMeta() // 获取当前行所有meta信息 datatable.getRowMeta('field1') // 获取当前行field1所有meta信息 datatable.getRowMeta('field1','type') // 获取当前行field1的key信息 ``` ### DataTable.getParam(key) ⇒ \* 获取参数参数值 **返回值**: \* - 参数参数值 | 参数 | 类型 | 描述 | | --- | --- | --- | | key | string | 参数对应的key | **Example** ```js datatable.getParam('param1') ``` ### DataTable.getSelectedIndex() ⇒ number 获取选中行索引，多选时，只返回第一个行索引 **返回值**: number - 选中行索引 **Example** ```js datatable.getSelectedIndex() ``` ### DataTable.getSelectedIndices() ⇒ array 获取选中的所有行索引数组 **返回值**: array - 所有行索引数组 **Example** ```js datatable.getSelectedIndices() ``` ### DataTable.getSelectedDatas([withEmptyRow]) ⇒ array 获取选中行的数据信息 **返回值**: array - 发生变化的数据信息 | 参数 | 类型 | Default | 描述 | | --- | --- | --- | --- | | [withEmptyRow] | boolean | false | 未选中的数据是否使用空行代替，true表示以空行代替未选中行，false相反 | **Example** ```js datatable.getSelectedDatas() datatable.getSelectedDatas(true) ``` ### DataTable.getSelectedRows() ⇒ array 获取选中的Row对象 **返回值**: array - 选中的Row对象 **Example** ```js datatable.getSelectedRows() ``` ### DataTable.getSimpleData([options]) ⇒ array 获取数据信息，只获取字段名与字段值 **返回值**: array - 获取到的数据信息 | 参数 | 类型 | Default | 描述 | | --- | --- | --- | --- | | [options] | object | | [description] | | [options.type] | string | "all" | 获取数据的规则 all：所有数据 current：当前行数据 focus：焦点行数据 select：选中行数据 change：发生改变的数据 | | [options.fields] | array | | 需要获取数据的字段名数组 | **Example** ```js datatable.getSimpleData() // 获取所有数据信息 datatable.getSimpleData({type:'current'}) // 获取当前行数据信息 datatable.getSimpleData({type:'current','fields':['filed1','field3']}) // 获取当前行field1和filed3数据信息 ``` ### DataTable.setMeta(fieldName, key, value) 设置meta信息 | 参数 | 类型 | 描述 | | --- | --- | --- | | fieldName | string | 需要设置meta信息的字段名 | | key | string | meta信息的key | | value | string | meta信息的值 | **Example** ```js datatable.setMeta('filed1','type','string') ``` ### DataTable.updateMeta(meta) 更新meta信息 | 参数 | 类型 | 描述 | | --- | --- | --- | | meta | object | 需要更新的meta信息 | **Example** ```js var metaObj = {supplier: {meta: {precision:'3', default: '0239900x', display:'显示名称'}}} datatable.updateMeta(metaObj) ``` ### DataTable.addParam(key, value) 增加参数参数 | 参数 | 类型 | 描述 | | --- | --- | --- | | key | string | 需要增加的key值 | | value | \* | 需要增加的具体指 | **Example** ```js datatable.addParam('precision','3') ``` ### DataTable.addParams(params) 增加多个参数参数 | 参数 | 类型 | 描述 | | --- | --- | --- | | params | object | 需要增加的参数对象 | **Example** ```js var paramsObj = { 'precision':'3', 'default':'1.234' } datatable.addParams(paramsObj) ``` ### DataTable.refSelectedRows(fieldName) 为选中行绑定监听，当选中行发生改变时触发对应方法 | 参数 | 类型 | 描述 | | --- | --- | --- | | fieldName | string | 绑定的字段名 | **Example** ```js datatable.refSelectedRows().subscribe(function(){}) ``` ### DataTable.ref(fieldName) 为某个字段绑定监听，当字段发生改变时触发对应方法 | 参数 | 类型 | 描述 | | --- | --- | --- | | fieldName | string | 绑定的字段名 | **Example** ```js datatable.ref('field1').subscribe(function(){}) ``` ### DataTable.refMeta(fieldName, key) 绑定字段属性，当字段属性发生改变时触发对应方法 | 参数 | 类型 | 描述 | | --- | --- | --- | | fieldName | string | 绑定的字段名 | | key | string | 绑定的属性key | **Example** ```js datatable.refMeta('field1','type').subscribe(function(){}) ``` ### DataTable.refRowMeta(fieldName, key) 绑定当前行的字段属性，当字段属性发生改变时触发对应方法 | 参数 | 类型 | 描述 | | --- | --- | --- | | fieldName | string | 绑定的字段名 | | key | string | 绑定的属性key | **Example** ```js datatable.refRowMeta('field1','type').subscribe(function(){}) ``` ### DataTable.refEnable(fieldName) 绑定字段是否可修改属性，当字段可修改属性发生改变时触发对应方法 | 参数 | 类型 | 描述 | | --- | --- | --- | | fieldName | string | 绑定的字段名 | **Example** ```js datatable.refEnable('field1').subscribe(function(){}) ``` ### DataTable.removeRowByRowId(rowId) 根据rowId删除指定行 | 参数 | 类型 | 描述 | | --- | --- | --- | | rowId | string | 需要删除行的rowId | **Example** ```js datatable.removeRowByRowId('rowid1') ``` ### DataTable.removeRow(index) 根据索引删除指定行 | 参数 | 类型 | 描述 | | --- | --- | --- | | index | number | 需要删除行的索引 | **Example** ```js datatable.removeRow(1) ``` ### DataTable.removeAllRows() 删除所有行 **Example** ```js datatable.removeAllRows(); ``` ### DataTable.removeRows(indices) 根据索引数据删除多条数据行 | 参数 | 类型 | 描述 | | --- | --- | --- | | indices | array | 需要删除的数据行对应索引数组 | **Example** ```js datatable.removeRows([1,2]) ``` ### DataTable.clear() 清空datatable的所有数据以及分页数据以及index **Example** ```js datatable.clear() ``` ### DataTable.addRow(row) 在最后位置添加一条数据行 | 参数 | 类型 | 描述 | | --- | --- | --- | | row | u.Row | 数据行 | **Example** ```js var row1 = new Row({parent: datatable}) row1.setData({ field1: 'value1', field2: 'value2' }) datatable.addRow(row1) ``` ### DataTable.addRows(rows) 在最后位置添加多条数据行 | 参数 | 类型 | 描述 | | --- | --- | --- | | rows | array | 数据行数组 | **Example** ```js var row1 = new Row({parent: datatable}) row1.setData({ field1: 'value1', field2: 'value2' }) var row2 = new Row({parent: datatable}) row2.setData({ field1: 'value11', field2: 'value22' }) datatable.addRow([row1,row2]) ``` ### DataTable.insertRow(index, row) 在指定索引位置添加一条数据行 | 参数 | 类型 | 描述 | | --- | --- | --- | | index | number | 指定索引 | | row | u.Row | 数据行 | **Example** ```js var row1 = new Row({parent: datatable}) row1.setData({ field1: 'value1', field2: 'value2' }) datatable.insertRow(1,row1) ``` ### DataTable.insertRows(index, rows) 在指定索引位置添加多条数据行 | 参数 | 类型 | 描述 | | --- | --- | --- | | index | number | 指定索引 | | rows | array | 数据行数组 var row1 = new Row({parent: datatable}) row1.setData({ field1: 'value1', field2: 'value2' }) var row2 = new Row({parent: datatable}) row2.setData({ field1: 'value11', field2: 'value22' }) datatable.insertRows(1,[row1,row2]) | ### DataTable.createEmptyRow() ⇒ u.Row 创建空行 **返回值**: u.Row - 空行对象 **Example** ```js datatable.createEmptyRow(); ``` ### DataTable.setAllRowsSelect() 设置所有行选中 **Example** ```js datatable.setAllRowsSelect() ``` ### DataTable.setRowSelect(index) 根据索引设置选中行，清空之前已选中的所有行 | 参数 | 类型 | 描述 | | --- | --- | --- | | index | number | 需要选中行的索引 | **Example** ```js datatable.setRowSelect(1) ``` ### DataTable.setRowsSelect(indices) 根据索引数组设置选中行，清空之前已选中的所有行 | 参数 | 类型 | 描述 | | --- | --- | --- | | indices | array | 需要选中行的索引数组 | **Example** ```js datatable.setRowsSelect([1,2]) ``` ### DataTable.addRowSelect(index) 根据索引添加选中行，不会清空之前已选中的行 | 参数 | 类型 | 描述 | | --- | --- | --- | | index | number | 需要选中行的索引 | **Example** ```js datatable.addRowSelect(1) ``` ### DataTable.addRowsSelect(indices) 根据索引数组添加选中行，不会清空之前已选中的行 | 参数 | 类型 | 描述 | | --- | --- | --- | | indices | array | 需要选中行的索引数组 | **Example** ```js datatabel.addRowsSelect([1,2]) ``` ### DataTable.setAllRowsUnSelect([options]) 全部取消选中 | 参数 | 类型 | 描述 | | --- | --- | --- | | [options] | object | 可选参数 | | [options.quiet] | boolean | 如果为true则不触发事件，否则触发事件 | **Example** ```js datatable.setAllRowsUnSelect() // 全部取消选中 datatable.setAllRowsUnSelect({quiet:true}) // 全部取消选中,不触发事件 ``` ### DataTable.setRowUnSelect(index) 根据索引取消选中 | 参数 | 类型 | 描述 | | --- | --- | --- | | index | number | 需要取消选中的行索引 | **Example** ```js datatable.setRowUnSelect(1) ``` ### DataTable.setRowsUnSelect(indices) 根据索引数组取消选中 | 参数 | 类型 | 描述 | | --- | --- | --- | | indices | array | 需要取消选中的行索引数组 | **Example** ```js datatable.setRowsUnSelect([1,2]) ``` ### DataTable.toggleAllSelect() 当全部选中时取消选中，否则全部选中 ### DataTable.setRowFocus(index, [quiet], [force]) 设置焦点行 | 参数 | 类型 | 描述 | | --- | --- | --- | | index | number | u.Row | 行对象或者行index | | [quiet] | boolean | 如果为true则不触发事件，否则触发事件 | | [force] | boolean | 如果为true当index行与已focus的行相等时，仍然触发事件，否则不触发事件 | **Example** ```js datatable.setRowFocus(1) // 设置第二行为焦点行 datatable.setRowFocus(1,true) // 设置第二行为焦点行，不触发事件 datatable.setRowFocus(1,false,true) // 设置第二行为焦点行，如果当前焦点行为第二行，仍旧触发事件 ``` ### DataTable.setRowUnFocus() 焦点行反选 **Example** ```js datatable.setRowUnFocus() ``` ### DataTable.setSimpleData(data, [options]) 设置数据, 只设置字段值 | 参数 | 类型 | Default | 描述 | | --- | --- | --- | --- | | data | array | | 数据信息 | | [options] | boject | | 可配置参数 | | [options.unSelect] | boject | true | 是否默认选中第一行，如果为true则不选中第一行，否则选中第一行 | **Example** ```js var data = [{ filed1:'value1', field2:'value2' },{ filed1:'value11', field2:'value21' }] datatable.setSimpleData(data) datatable.setSimpleData(data,{unSelect:false}) ``` ### DataTable.addSimpleData(data, status) 追加数据, 只设置字段值 | 参数 | 类型 | 描述 | | --- | --- | --- | | data | array | 数据信息 | | status | string | 追加数据信息的状态，参照Row对象的状态介绍 | **Example** ```js var data = [{ filed1:'value1', field2:'value2' },{ filed1:'value11', field2:'value21' }] datatable.addSimpleData(data,Row.STATUS.NEW) ``` ### DataTable.on(name, [callback], [one]) ⇒ [DataTable](#DataTable) 为DataTable对象添加监听 **返回值**: [DataTable](#DataTable) - 当前的DataTable对象 | 参数 | 类型 | 描述 | | --- | --- | --- | | name | string | array | object | 针对不同用法分别对应监听名称、监听名称对应的数组、监听名称及对应的回调组成的对象 | | [callback] | function | 监听对应的回调函数 | | [one] | boolean | 是否只执行一次监听，为true则表示只执行一次回调函数，否则每次触发监听都是执行回调函数 | **Example** ```js datatable.on(u.DataTable.ON_ROW_FOCUS, function() {}) // 普通 datatable.on([u.DataTable.ON_INSERT, u.DataTable.ON_DELETE], function() {}) // 数组 datatable.on({u.DataTable.ON_INSERT: function() {}, u.DataTable.ON_DELETE: function() {}}) // map ``` ### DataTable.off(name, [callback]) ⇒ [DataTable](#DataTable) 为DataTable对象取消监听 **返回值**: [DataTable](#DataTable) - 当前的DataTable对象 | 参数 | 类型 | 描述 | | --- | --- | --- | | name | string | array | object | 针对不同用法分别对应监听名称、监听名称对应的数组、监听名称及对应的回调组成的对象 | | [callback] | function | 监听对应的回调函数 | **Example** ```js datatable.off(u.DataTable.ON_ROW_FOCUS, function() {}) // 普通 datatable.off([u.DataTable.ON_INSERT, u.DataTable.ON_DELETE], function() {}) // 数组 datatable.off({u.DataTable.ON_INSERT: function() {}, u.DataTable.ON_DELETE: function() {}}) // map ``` ### DataTable.one(name, [callback]) 为DataTable对象添加只执行一次的监听 | 参数 | 类型 | 描述 | | --- | --- | --- | | name | string | array | object | 针对不同用法分别对应监听名称、监听名称对应的数组、监听名称及对应的回调组成的对象 | | [callback] | function | 监听对应的回调函数 | **Example** ```js datatable.one(u.DataTable.ON_ROW_FOCUS, function() {}) // 普通 datatable.one([u.DataTable.ON_INSERT, u.DataTable.ON_DELETE], function() {}) // 数组 datatable.one({u.DataTable.ON_INSERT: function() {}, u.DataTable.ON_DELETE: function() {}}) // map ``` ### DataTable.trigger(name) ⇒ [DataTable](#DataTable) 触发DataTable对象绑定的事件监听 **返回值**: [DataTable](#DataTable) - 当前的DataTable对象 | 参数 | 类型 | 描述 | | --- | --- | --- | | name | string | 需要触发的事件监听对应的名称 | **Example** ```js datatable.trigger('valuechange') ```