layui 的 table模块是一个重头,在基础参数方面尽可能地做到友好,即:保证功能的前提而又避免过于繁杂的配置。基础参数一般出现在以下几种场景中:

1 场景一:下述 lay-data 里面的内容即为基础参数项,切记:值要用单引号2 
3
4 场景二:下述方法中的键值即为基础参数项5 table.render({6 height: 300
7 ,url: '/api/data'
8 });9
10 更多场景:下述options即为含有基础参数项的对象11 > table.init('filter', options); //转化静态表格
12 > var tableObj =table.render({});13 tableObj.reload(options); //重载表格
接下来看一下基础元素有哪些?
1、elem - 绑定元素是指定原始table容器,只适用于 table.render()的渲染方式
1 HTML:2 
3
4 JS:5 table.render({ //其它参数在此省略
6 elem: '#test' //或 elem: document.getElementById('test') 等
7 });
2、设置表头,这里包含很多值,是一个二维数组。如果你采用表格的“方法级渲染”,那么你需要借助该参数来设定表格。如:
1 JS:2 table.render({3 cols: [[ //标题栏
4 {checkbox: true}5 ,{field: 'id', title: 'ID', width: 80}6 ,{field: 'username', title: '用户名', width: 120}7 ]]8 });9
10 它等价于:11 
12 
13 
14 
15 
ID 
 
16 
用户名 
 
17 
18 
19 
下面是一个二级表头的例子:
JS:
table.render({
cols: [[//标题栏
{field: 'username', title: '联系人', width: 80, rowspan: 2} //rowspan即纵向跨越的单元格数
,{field: 'amount', title: '金额', width: 80, rowspan: 2}
,{align:'center', title: '地址', colspan: 3} //colspan即横跨的单元格数,这种情况下不用设置field和width
], [
{field:'province', title: '省', width: 80}
,{field:'city', title: '市', width: 120}
,{field:'county', title: '详细', width: 300}
]]
});
它等价于:
联系人金额地址省市详细
需要说明的是,table模块支持无限极表头,你可按照上述的方式继续扩充。核心点在于 rowspan 和 colspan 两个参数的
接下来就是表头里的一些参数设置
<1> field:设定字段名
1 table.render({2 cols: [[3 {field: 'id'} //其它参数在此省略
4 ,{field: 'username'}5 ]]6 });7
8 等价于:9 
10 
<2> title:设定标题名称
1 table.render({2 cols: [[3 {title: '邮箱'} //其它参数在此省略
4 ,{title: '签名'}5 ]]6 });7
8 等价于:9 
邮箱 (PS:也可以把标题写在lay-data里面,即 title:'邮箱') 
 
10 
签名 
 
<3> width:设定列宽。列宽的设定也通常是必须的(“特殊列”除外,如:复选框列、工具列等),它关系到表格的整体美观程度。
1 table.render({2 cols: [[3 {width: 80} //其它参数在此省略
4 ,{width: 120}5 ]]6 });7
8 等价于:9 
10 
<4> checkbox:设定复选框。如果设置 true,则表示该列内容为复选框,通常它被放在第一列。
1 table.render({2 cols: [[3 {checkbox: true} //其它参数在此省略
4 ,{field: 'id', title:'ID', width: 100}5 ]]6 });7
8 等价于:9 
10 
ID 
 
还有需要注意的是,这里的LAY_CHECKED是和checkbox搭配使用的,如果设置 true,则表示复选框默认全部选中。
1 table.render({2 cols: [[3 {checkbox: true, LAY_CHECKED: true} //其它参数在此省略
4 ,{field: 'id', title:'ID', width: 100}5 ]]6 });7
8 等价于:9 
10 
ID 
 
<5> space:设定空隙列。如果设置 true,则定义一个 15px 宽度无任何内容的列。
1 table.render({2 cols: [[ //其它参数在此省略
3 {space: true}4 ,{field: 'id', title:'ID', width: 100}5 ]]6 });7
8 等价于:9 
10 
ID 
 
<6> sort:是否需要排序。如果设置 true,则在对应的表头显示排序icon,从而对列开启排序功能。
注意:不推荐对值存在:数字和普通字符的列开启排序,因为会进入字典序比对。比如:'贤心' > '2' > '100',这可能并不是你想要的结果,但字典序排列算法(ASCII码比对)就是这样的,具体你也可以去了解一下字典序方面的知识。
1 table.render({2 cols: [[3 {sort:true} //其它参数在此省略
4 ,{field:'id', title:'ID', width:100}5 ]]6 });7
8 等价于:9 
10 
ID 
 
<7> fixed:是否需要固定列。如果设置 true 或 'right',则对应的列将会被固定在左或右,不随滚动条而滚动。
1 table.render({2 cols: [[3 {fixed:true} //其它参数在此省略
4 ,{field:'id', title:'ID', width:100}5 ,{field:'username', title:'姓名', width:120, fixed:'right'} //固定列在右
6 ]]7 });8
9 等价于:10 
11 
ID 
 
12 
姓名 
 
<8> edit:是否允许编辑。如果设置 true,则对应列的单元格将会被允许编辑,目前只支持type="text"的input编辑。
1 table.render({2 cols: [[3 {edit:'text'} //其它参数在此省略
4 ,{field:'id', title:'ID', width:100}5 ]]6 });7
8 等价于:9 
10 
ID 
 
<9> templet:自定义模版。在默认情况下,单元格的内容是完全按照数据接口返回的content原样输出的,如果你想对某列的单元格添加链接等其它元素,你可以借助该参数来轻松实现。这是一个非常实用的功能,你的表格内容会因此而丰富多样。
1 table.render({2 cols: [[3 {field:'title', title: '文章标题', width: 200, templet: '#titleTpl'} //这里的templet值是模板元素的选择器
4 ,{field:'id', title:'ID', width:100}5 ]]6 });7
8 等价于:9 
文章标题 
 
10 
ID 
 
事实上,templet也可以直接是一段html内容,如:
1 templet: '
 
 
 
  {{d.title}} 
 
' 
 
2
3 注意:这里一定要被一层 
<10> toolbar:绑定工具条。通常你需要在表格的每一行加上 查看、编辑、删除 这样类似的操作按钮,而 tool 参数就是为此而生,你因此可以非常便捷地实现各种操作功能。tool 参数和 templet 参数的使用方式完全类似,通常接受的是一个选择器,也可以是一段HTML字符。
1 table.render({2 cols: [[3 {field:'id', title:'ID', width:100}4 ,{fixed: 'right', width:150, align:'center', toolbar: '#barDemo'} //这里的toolbar值是模板元素的选择器
5 ]]6 });7
8 等价于:9 
ID 
 
10 
下述是 toolbar 对应的模板,它可以存放在页面的任意位置:
1 
2 查看
3 编辑
4 删除
5
6 
7 {{# if(d.auth > 2){ }}8 审核
9 {{# } }}10 
11
12 注意:属性 lay-event="" 是模板的关键所在,值可随意定义。
接下来我们借助table模块的工具条事件,完成不同的操作功能:
1 //监听工具条
2 table.on('tool(test)', function(obj){ //注:tool是工具条事件名,test是table原始容器的属性 lay-filter="对应的值"
3 var data = obj.data; //获得当前行数据
4 var layEvent = obj.event; //获得 lay-event 对应的值
5 var tr = obj.tr; //获得当前行 tr 的DOM对象
6
7 if(layEvent === 'detail'){ //查看
8 //do somehing
9 } else if(layEvent === 'del'){ //删除
10 layer.confirm('真的删除行么', function(index){11 obj.del(); //删除对应行(tr)的DOM结构,并更新缓存
12 layer.close(index);13 //向服务端发送删除指令
14 });15 } else if(layEvent === 'edit'){ //编辑
16 //do something
17
18 //同步更新缓存对应的值
19 obj.update({20 username: '123'
21 ,title: 'xxx'
22 });23 }24 });

今天先写到这里,主要是对table的一些必要元素进行的理解与记录。