# API
本节主要介绍新增/扩展的一些方法、属性
# 方法
- 以下是对layui.table的扩展
| 方法名 | 入参 | 出参 | 备注 |
|---|---|---|---|
| reload | (tableId, config) | 进行扩展 | |
| getInstance | (tableId) | TableInstance | 获取表格实例 |
| getColConfigByField | (tableId, field) | Column | 获取列配置 |
| addRow | (tableId, rowIndex, data) | Row | 新增行 |
| renderSpecRow | (tableId, rowIndex, data) | 重新渲染指定行 | |
| getRows | (tableId) | Row[] | 获取表格所有行 |
| deleteRow | (tableId,rowIndex) | 删除行 | |
| mergeCell | (tableId, field) | 合并单元格,只支持行合并 |
使用示例:layui.table.getInstance('tableId'')
- 以下是对表格校验、监听方面的扩展
| 方法名 | 入参 | 出参 | 备注 |
|---|---|---|---|
| watch | (tableId) | 监听表格,当表格的可编辑内容(文本框、下拉框、复选框等) 值改变后,同步更新表格缓存的值。表格渲染完成后使用 | |
| validateAllRows | (tableId,callback ) | 校验表格所有行,callback = (valid, errors) => {} | |
| validateSingleRow | (tableId,rowIndex, callback ) | 校验单行,callback = (valid, errors) => {} |
使用示例:$editable.watch('tableId'')
# 属性
- 表格属性
| 属性名 | 类型 | 默认值 | 备注 |
|---|---|---|---|
| time | boolean | true | 当启用分页时,显示加载耗时 |
| extToolbar | Array | [] | 扩展工具栏,取值范围: ['excel', 'csv'] ,当使用 toolbar属性时 时开启 |
| excel | Object | {} | excel配置, 取值: {templateUrl: '导出模板URL',exportUrl: '导出URL', importUrl: '导入URL', params: {}} |
- 列属性