【WEB前端开辟】layui中的table模块中的基本参数运用

layui 的 table模块是一个重头,在基本参数方面尽量地做到友爱,即:保证功用的条件而又防止过于冗杂的设置。

基本参数平常出现在以下几种场景中:

场景一:下述 lay-data 内里的内容即为基本参数项,牢记:值要用单引号

<table lay-data="{height:300, url:'/api/data'}" lay-filter="demo"> …… </table>

场景二:下述要领中的键值即为基本参数项

table.render({
  height: 300
  ,url: '/api/data'
});

更多场景:下述options即为含有基本参数项的对象

> table.init('filter', options); //转化静态表格
> var tableObj = table.render({});
  tableObj.reload(options); //重载表格

接下来看一下基本元素有哪些?

1、elem - 绑定元素是指定原始table容器,只适用于 table.render()的衬着体式格局

HTML:
<table id="test"></table>     
 
JS:
table.render({ //别的参数在此省略
  elem: '#test' //或 elem: document.getElementById('test') 等
});

2、设置表头,这里包括很多值,是一个二维数组。假如你采纳表格的“要领级衬着”,那末你须要借助该参数来设定表格。如:

JS:
table.render({
  cols:  [[ //题目栏
    {checkbox: true}
    ,{field: 'id', title: 'ID', width: 80}
    ,{field: 'username', title: '用户名', width: 120}
  ]]
});
 
它等价于:
<table class="layui-table" lay-data="{基本参数}" lay-filter="test">
  <thead>
    <tr>
      <th lay-data="{checkbox:true}"></th>
      <th lay-data="{field:'id', width:80}">ID</th>
      <th lay-data="{field:'username', width:180}">用户名</th>
    </tr>
  </thead>
</table>

下面是一个二级表头的例子:

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 class="layui-table" lay-data="{基本参数}">
  <thead>
    <tr>
      <th lay-data="{field:'username', width:80}" rowspan="2">联系人</th>
      <th lay-data="{field:'amount', width:120}" rowspan="2">金额</th>
      <th lay-data="{align:'center'}" colspan="3">地点</th>
    </tr>
    <tr>
      <th lay-data="{field:'province', width:80}">省</th>
      <th lay-data="{field:'city', width:120}">市</th>
      <th lay-data="{field:'county', width:300}">细致</th>
    </tr>
  </thead>
</table>

须要申明的是,table模块支撑无限极表头,你可根据上述的体式格局继承扩大。中心点在于 rowspan 和 colspan 两个参数的

接下来就是表头里的一些参数设置

<1> field:设定字段名

table.render({
  cols: [[
    {field: 'id'} //别的参数在此省略
    ,{field: 'username'}
  ]]
});
 
等价于:
<th lay-data="{field:'id'}"></th>
<th lay-data="{field:'username'}"></th>

<2> title:设定题目称号

table.render({
  cols: [[
    {title: '邮箱'} //别的参数在此省略
    ,{title: '署名'}
  ]]
});
 
等价于:
<th lay-data="{}">邮箱</th> (PS:也能够把题目写在lay-data内里,即 title:'邮箱')
<th lay-data="{}">署名</th>

<3> width:设定列宽。列宽的设定也一般是必需的(“特别列”除外,如:复选框列、东西列等),它关系到表格的团体雅观水平。

table.render({
  cols: [[
    {width: 80} //别的参数在此省略
    ,{width: 120}
  ]]
});
 
等价于:
<th lay-data="{width:80}"></th>
<th lay-data="{width:120}"></th>

<4> checkbox:设定复选框。假如设置 true,则示意该列内容为复选框,一般它被放在第一列。

table.render({
  cols: [[
    {checkbox: true} //别的参数在此省略
    ,{field: 'id', title:'ID', width: 100}
  ]]
});
 
等价于:
<th lay-data="{checkbox:true}"></th>
<th lay-data="{field:'id', width:100}">ID</th>

另有须要注重的是,这里的LAY_CHECKED是和checkbox搭配运用的,假如设置 true,则示意复选框默许悉数选中。

table.render({
  cols: [[
    {checkbox: true, LAY_CHECKED: true} //别的参数在此省略
    ,{field: 'id', title:'ID', width: 100}
  ]]
});
 
等价于:
<th lay-data="{checkbox:true, LAY_CHECKED: true}"></th>
<th lay-data="{field:'id', width:100}">ID</th>

<5> space:设定闲暇列。假如设置 true,则定义一个 15px 宽度无任何内容的列。

table.render({
  cols: [[ //别的参数在此省略
    {space: true}
    ,{field: 'id', title:'ID', width: 100}
  ]]
});
 
等价于:
<th lay-data="{space:true}"></th>
<th lay-data="{field:'id', width:100}">ID</th>

<6> sort:是不是须要排序。假如设置 true,则在对应的表头显现排序icon,从而对列开启排序功用。

注重:不引荐对值存在:数字和一般字符的列开启排序,由于会进入字典序比对。比方:'贤心' > '2' > '100',这能够并非你想要的效果,但字典序分列算法(ASCII码比对)就是如许的,详细你也能够去相识一下字典序方面的学问。

table.render({
  cols: [[
    {sort:true} //别的参数在此省略
    ,{field:'id', title:'ID', width:100}
  ]]
});
 
等价于:
<th lay-data="{sort:true}"></th>
<th lay-data="{field:'id', width:100}">ID</th>

<7> fixed:是不是须要牢固列。假如设置 true 或 'right',则对应的列将会被牢固在左或右,不随转动条而转动。

table.render({
  cols: [[
    {fixed:true} //别的参数在此省略
    ,{field:'id', title:'ID', width:100}
    ,{field:'username', title:'姓名', width:120, fixed:'right'} //牢固列在右
  ]]
});
 
等价于:
<th lay-data="{sort:true}"></th>
<th lay-data="{field:'id', width:100}">ID</th>
<th lay-data="{field:'username', width:120, fixed:'right'}">姓名</th>

<8> edit:是不是许可编辑。假如设置 true,则对应列的单元格将会被许可编辑,现在只支撑type="text"的input编辑。

table.render({
  cols: [[
    {edit:'text'} //别的参数在此省略
    ,{field:'id', title:'ID', width:100}
  ]]
});
 
等价于:
<th lay-data="{edit:'text'}"></th>
<th lay-data="{field:'id', width:100}">ID</th>

<9> templet:自定义模版。在默许情况下,单元格的内容是完整根据数据接口返回的content原样输出的,假如你想对某列的单元格增加链接等别的元素,你能够借助该参数来轻松完成。这是一个异常有用的功用,你的表格内容会因而而雄厚多样。

table.render({
  cols: [[
    {field:'title', title: '文章题目', width: 200, templet: '#titleTpl'} //这里的templet值是模板元素的选择器
    ,{field:'id', title:'ID', width:100}
  ]]
});
 
等价于:
<th lay-data="{field:'title', width: 200, templet: '#titleTpl'}">文章题目</th>
<th lay-data="{field:'id', width:100}">ID</th>

事实上,templet也能够直接是一段html内容,如:

templet: '<div><a href="/detail/{{d.id}}" class="layui-table-link">{{d.title}}</a></div>' 
注重:这里肯定要被一层 <div></div> 包裹,不然没法读取到模板

<10> toolbar:绑定东西条。一般你须要在表格的每一行加上 检察、编辑、删除 如许相似的操纵按钮,而 tool 参数就是为此而生,你因而能够异常便利地完成种种操纵功用。

tool 参数和 templet 参数的运用体式格局完整相似,一般接收的是一个选择器,也能够是一段HTML字符。

table.render({
  cols: [[
    {field:'id', title:'ID', width:100}
    ,{fixed: 'right', width:150, align:'center', toolbar: '#barDemo'} //这里的toolbar值是模板元素的选择器
  ]]
});
 
等价于:
<th lay-data="{field:'id', width:100}">ID</th>
<th lay-data="{fixed: 'right', width:150, align:'center', toolbar: '#barDemo'}"></th>

下述是 toolbar 对应的模板,它能够存放在页面的恣意位置:

<script type="text/html" id="barDemo">
  <a class="layui-btn layui-btn-mini" lay-event="detail">检察</a>
  <a class="layui-btn layui-btn-mini" lay-event="edit">编辑</a>
  <a class="layui-btn layui-btn-danger layui-btn-mini" lay-event="del">删除</a>
  
  <!-- 这里一样支撑 laytpl 语法,如: -->
  {{#  if(d.auth > 2){ }}
    <a class="layui-btn layui-btn-mini" lay-event="check">考核</a>
  {{#  } }}
</script>
 
注重:属性 lay-event="" 是模板的关键所在,值可随便定义。

接下来我们借助table模块的东西条事宜,完成差别的操纵功用:

//监听东西条
table.on('tool(test)', function(obj){ //注:tool是东西条事宜名,test是table原始容器的属性 lay-filter="对应的值"
  var data = obj.data; //取得当前行数据
  var layEvent = obj.event; //取得 lay-event 对应的值
  var tr = obj.tr; //取得当前行 tr 的DOM对象
 
  if(layEvent === 'detail'){ //检察
    //do somehing
  } else if(layEvent === 'del'){ //删除
    layer.confirm('真的删除行么', function(index){
      obj.del(); //删除对应行(tr)的DOM构造,并更新缓存
      layer.close(index);
      //向服务端发送删除指令
    });
  } else if(layEvent === 'edit'){ //编辑
    //do something
    
    //同步更新缓存对应的值
    obj.update({
      username: '123'
      ,title: 'xxx'
    });
  }
});

更多layui相干学问请关注layui框架。

以上就是layui中的table模块中的基本参数运用的细致内容,更多请关注ki4网别的相干文章!

点赞

发表评论

电子邮件地址不会被公开。必填项已用 * 标注