### Layuitable回调函数详解
#### 一、概述
Layuitable是一款基于layui框架的表格插件，它不仅外观精美、易于使用，而且提供了强大的自定义配置能力与丰富的事件监听功能。其中，回调函数是layuitable的一项重要特性，它允许开发者在表格的各种关键操作（如数据加载、排序、分页等）时进行自定义处理，以此实现更为灵活的功能需求。
#### 二、回调函数类型
Layuitable支持多种类型的回调函数，下面将逐一详细介绍：
1. **done**：
- **功能说明**：当表格渲染完成后触发的回调函数。
- **应用场景**：可用于执行表格渲染后的初始化操作，比如设置额外的样式、绑定事件或进行二次数据处理等。
- **示例代码**：
```javascript
table.render({
elem: '#demo',
url: 'data.json',
done: function(res, curr, count){
// res 即服务端返回的数据；curr 当前页；count 数据总数
console.log(res);
}
});
```
2. **toolbar**：
- **功能说明**：当用户点击表格工具栏上的按钮时触发的回调函数。
- **应用场景**：用于处理工具栏上按钮的点击事件，如添加、删除、导出等操作。
- **示例代码**：
```javascript
table.on('toolbar(demo)', function(obj){
switch(obj.event){
case 'add':
layer.open({content: '添加'});
break;
case 'delete':
layer.confirm('确定删除选中项？', function(index){
// 执行删除操作
layer.close(index);
});
break;
};
});
```
3. **sort**：
- **功能说明**：当用户对表格进行排序时触发的回调函数。
- **应用场景**：可用于自定义排序逻辑，比如按照特定字段进行排序。
- **示例代码**：
```javascript
table.on('sort(demo)', function(obj){
// 获取排序参数 obj.field 和 obj.type
var params = {
field: obj.field,
type: obj.type,
page: 1
};
// 重新请求数据
table.reload('demo', {initSort: obj, where: params});
});
```
4. **page**：
- **功能说明**：当用户进行分页操作时触发的回调函数。
- **应用场景**：用于自定义分页行为，例如调整每页显示的数据量或跳转至特定页码。
- **示例代码**：
```javascript
table.on('page(demo)', function(obj){
// 重载表格数据
table.reload('demo', {
page: {
curr: obj.curr // 获取当前页码
},
where: {
page: obj.curr, // 传递页码参数
limit: obj.limit // 传递每页显示条数
}
});
});
```
5. **checkbox**：
- **功能说明**：当表格中的复选框状态发生变化时触发的回调函数。
- **应用场景**：通常用于响应用户的批量选择行为，比如批量删除、批量更新等操作。
- **示例代码**：
```javascript
table.on('checkbox(demo)', function(obj){
// 获取所有被选中的数据
var checkStatus = table.checkStatus('demo');
console.log(checkStatus.data); // 输出选中行数据
});
```
6. **tool**：
- **功能说明**：当用户点击表格行内的工具按钮时触发的回调函数。
- **应用场景**：常用于实现行级的操作，比如查看、编辑或删除单条记录。
- **示例代码**：
```javascript
table.on('tool(demo)', function(obj){
if(obj.event === 'detail'){
layer.open({title: '详情', content: JSON.stringify(obj.data)});
} else if(obj.event === 'edit'){
layer.prompt({formType: 1}, function(value, index){
obj.data.name = value; // 更新数据
table.updateObj(obj); // 刷新数据
layer.close(index);
});
} else if(obj.event === 'del'){
layer.confirm('确认删除？', function(index){
obj.del(); // 删除该行
layer.close(index);
});
}
});
```
#### 三、API接口
除了上述回调函数之外，layuitable还提供了一系列API接口，使得开发者能够更加灵活地控制表格的各项功能：
- **table.reload()**：用于重新加载表格数据。
- **table.set()**：设置表格的全局配置项。
- **table.get()**：获取表格的全局配置项。
- **table.updateObj()**：更新表格中某一行的数据。
- **table.removeObj()**：删除表格中某一行的数据。
- **table.checkStatus()**：获取表格的选中状态。
#### 四、总结
通过以上介绍，我们可以看出layuitable回调函数的强大之处在于它们为开发者提供了极大的灵活性，能够根据实际需求定制化表格的行为。无论是简单的数据展示还是复杂的业务逻辑处理，layuitable都能够轻松应对。对于寻求美观、高效且功能全面的表格解决方案的开发者而言，layuitable无疑是一个值得推荐的选择。
