layui-soul-table
v1.5.13
Published
当前layui版本 `v2.5.6`
Downloads
543
Readme
给 layui-table 注入点灵魂
当前layui版本 v2.5.6
在线demo及文档： https://saodiyang.gitee.io/layui-soul-table
国内下载地址: https://gitee.com/saodiyang/layui-soul-table
扩展功能
- 表头筛选、自定义条件（支持前端筛选、后台筛选介绍请看 三、后台筛选）
- 拖动列调整顺序、隐藏显示列
- excel导出（根据筛选条件和列顺序导出）
- 子表（表中表、无限层级、子表同样支持前3个功能） 5.拖动行 6.右击快捷菜单 7.合计栏支持固定列 8.双击自适应列宽 9.右侧固定列 列宽拖动改到单元格左侧
效果
1.表头筛选效果
2.编辑筛选效果
筛选明代姓张的 或 唐代姓李的的诗词
3.拖动列调整顺序、隐藏显示列
左右拖动调整顺序，鼠标移出表格后松开--快速隐藏列
4.子表
快速上手
1.将下面模块放到自己项目中:
soulTable.js 总入口
tableFilter.js 表头筛选
excel.js excel导出
tableChild.js 子表 可单独使用
tableMerge.js 单元格合并 可单独使用
源码版位置：ext
压缩版位置：docs/ext
2.定义入口模块soulTable
// 自定义模块，这里只需要开放soulTable即可
layui.config({
base: 'ext/', // 模块目录
}).extend({
soulTable: 'soulTable' // 模块别名
});3.引入 soulTable.css 到自己项目中。（在项目根目录可找到）
4.在 table.render() 中使用。
①done 中加入 soulTable.render(this)
②在需要下拉筛选的列中加入 filter: true 即可生效
table.render({
elem: '#myTable'
,height: $(document).height() - $('#myTable').offset().top - 20
,limit: 20
,page: true
,cols: [[
{type: 'checkbox', fixed: 'left'}
,{field:'poetry', title:'诗词', width:188, filter:true, sort: true}
,{field:'name', title:'诗人', width:100, filter:true, sort: true}
,{field:'type', title:'类型', width:100, filter:true}
,{field:'dynasty', title:'朝代', width:150, filter:true}
,{field:'sentences', title:'名句', width:400, filter:true}
,{title:'操作', toolbar: '#barDemo', width:150}
]]
,done: function () {
soulTable.render(this)
}
});详细介绍
一、支持使用的几种情况
demo 中都有示例
- 前端不分页
即
page:false
注意：layui框架有个bug，可以给
limit极限值，如limit:1000000来兼容这个bug
如果不想这么干想要直接修改table.js修复这个问题，可以私信我
前端分页 即
url为空，page: true后台分页 即
url: xxxxx,page: true
由于前两种筛选都是在前端完成,所以可以直接使用，但是
后台分页的情况下，前台数据是不完整，所以需要后台支持 java 的 mybatis 拦截器我已经做了，支持 mysql、oracle 数据库。所以如果你后台是 java， 且使用了mybatis作为持久层框架，那么恭喜你可以移步这里来集成。 其他语言或框架，暂时没有需求，欢迎进行扩展（有问题欢迎交流）。
二、筛选相关
1.时间类型增强, filter: {type: 'date[yyyy-MM-dd HH:mm:ss]'} ,格式根据具体的显示格式
var myTable = table.render({
...
,cols: [[
...
,{field: 'createTime', title: '录入时间', width: 165, filter: {type: 'date[yyyy-MM-dd HH:mm:ss]'}, sort:true}
...
]]
,done: function () {
soulTable.render(this)
}
});2.调整下拉菜单的顺序、显示（去掉下面数组的某一项即可隐藏）
此 filter 参数非必须，缺省即为下面所示内容
var myTable = table.render({
...
cols: [[
...
]]
, filter: {
//用于控制表头下拉显示，可以控制顺序、显示, 依次是：表格列、筛选数据、筛选条件、编辑筛选条件、导出excel
items:['column','data','condition','editCondition','excel']
}
, done: function (res, curr, count) {
soulTable.render(this)
}
});3.隐藏底部筛选区域，默认为 true (显示)
var myTable = table.render({
...
cols: [[
...
]]
, filter: {
bottom: false
}
, done: function (res, curr, count) {
soulTable.render(this)
}
});三、后台筛选
目前支持 java 且使用了 mybatis 框架。
如果符合上面的条件，则可以移步到包含后端的完整项目即介绍：https://github.com/yelog/layui-soul-table-java
四、导出excel相关
1.配置默认样式
五、子表
1⃣️ 开启配置
配置在主标
cols中，这一列为展开、隐藏的入口，可以放在任意一列
| 参数 | 类型 | 说明 | 示例值 | |:-|:-|:-|:-| | show | Number | 展开类型(默认值: 1)1: 子表在表内展开展示 2: 子表以弹窗方式展示 | 1 | | children | Array | 子表参数定义，数组的一个元素代表一个子表 | 可参考layui-table的api |
2⃣️ 子表参数
| 参数 | 类型 | 说明 | 示例值 |
| -------- | --------------- | ------------------------------------------------------------ | ------------------------------------------------------------ |
| title | String | 子表标题 | |
| where | Object/Function | 子表请求参数1: 赋值json数据2: 方法返回json数据，参数为当前行数据 | 1. where: {name:'小明'}2. where: function(d){ console.log(d); return {name: d.name}} |
| data | Array/Function | 子表数据1: 赋值子表格数据2: 方法返回表格数据，参数为当前行数据 | 1. data: []2. Data: function(d){ console.log(d); return []} |
| toolEvent | Function | 子表行事件绑定（table.on('tool(filter)',function(){})） 注意：子表的事件名（如edit）不能与主表相同，否则会同时触发主表事件 | toolEvent: function(d){ var layEvent = obj.event; //获得 lay-event 对应的值 var tr = obj.tr; //获得当前行 tr 的DOM对象 if(layEvent === 'edit'){}} |
| 其他参数 | - | 与layui 的 table 一致，官方文档 | 注意： 子表的没有 elem 参数 |
3⃣️ 示例
var myTable = table.render({
elem: '#myTable'
,height: $(document).height() - $('#myTable').offset().top - 20
,limit: 30
,page: true
,cols: [[
{title: '#', width: 50, children:[
{
title: '表格一'
,url: 'data.json'
,height: 300
,limit: 10000000
,page: false
,toolEvent: function (obj) {
if (obj.event === 'childEdit') {
layer.open({
type: 1,
title: '子表1-编辑',
shadeClose: true,
content:obj.data
});
} else if (obj.event === 'childDel') {
layer.open({
type: 1,
title: '子表1-删除',
shadeClose: true,
content: obj.data
});
}
}
,cols: [[
{type: 'checkbox', fixed: 'left'},
{field: 'title', title: '诗词', width: 200, sort: true, filter: true},
{field: 'dynasty', title: '朝代', width: 100, sort: true, filter: true},
{field: 'author', title: '作者', width: 165 , filter: true},
{field: 'type', title: '类型', width: 112, filter: {split:','}, sort:true},
{field: 'content', title: '内容', width: 823, filter: true},
{field: 'heat', title: '点赞数', width: 112, filter: true, sort:true},
{field: 'createTime', title: '录入时间', width: 165, filter: {type: 'date[yyyy-MM-dd HH:mm:ss]'}, sort:true},
{title: '操作', width: 156, templet: '#childBar'}
]]
,done: function () {
soulTable.render(this);
}
},
{
title: '表格二'
,height: 300
,limit: 1000000
,data: function (d) {
// d 为当前行数据
console.log(d);
return [d];
}
,toolEvent: function (obj) {
if (obj.event === 'childEdit') {
layer.open({
type: 1,
title: '子表2-编辑',
shadeClose: true,
content:obj.data
});
} else if (obj.event === 'childDel') {
layer.open({
type: 1,
title: '子表2-删除',
shadeClose: true,
content:obj.data
});
}
}
,page: false
,cols: [[
{type: 'checkbox', fixed: 'left'},
{field: 'title', title: '诗词', width: 200, sort: true, filter: true},
{field: 'dynasty', title: '朝代', width: 100, sort: true, filter: true},
{field: 'author', title: '作者', width: 165 , filter: true},
{field: 'type', title: '类型', width: 112, filter: {split:','}, sort:true},
{field: 'content', title: '内容', width: 823, filter: true},
{field: 'heat', title: '点赞数', width: 112, filter: true, sort:true},
{field: 'createTime', title: '录入时间', width: 165, filter: {type: 'date[yyyy-MM-dd HH:mm:ss]'}, sort:true},
{title: '操作', width: 156, templet: '#childBar'}
]]
,done: function () {
soulTable.render(this);
}
}
]},
{field: 'title', title: '诗词', width: 200, sort: true, filter: true},
{field: 'dynasty', title: '朝代', width: 100, sort: true, filter: true},
{field: 'author', title: '作者', width: 165 , filter: true},
{field: 'type', title: '类型', width: 112, filter: {split:','}, sort:true},
{field: 'content', title: '内容', width: 823, filter: true},
{field: 'heat', title: '点赞数', width: 112, filter: true, sort:true},
{field: 'createTime', title: '录入时间', width: 165, filter: {type: 'date[yyyy-MM-dd HH:mm:ss]'}, sort:true},
{title: '操作', width: 156, templet: '#bar'}
]]
,done: function () {
soulTable.render(this)
}
});下面为默认配置，如果不改，可直接去掉excel参数
var myTable = table.render({
...
, cols: [[
...
]]
, excel:{ // 导出excel配置, （以下值均为默认值）
on: true, //是否启用, 默认开启
filename: '诗词.xlsx', // 文件名
head:{ // 表头样式
family: 'Calibri', // 字体
size: 12, // 字号
color: '000000', // 字体颜色
bgColor: 'C7C7C7' // 背景颜色
},
font: { // 正文样式
family: 'Calibri', // 字体
size: 12, // 字号
color: '000000', // 字体颜色
bgColor: 'FFFFFF' //背景颜色
}
}
, done: function (res, curr, count) {
soulTable.render(this)
}
});内置方法
1.渲染入口render()
soulTable.render(this) 使用在 table.render() 的 done 内，如果需要使用此插件中的任何功能都需要有这句话。
2.excel导出export()
除了开启下拉列表中的excel导出外，还可以自己调用方法进行导出。
<a class="layui-btn" id="export">导出</a>
<script>
layui.use(['form', 'soulTable', 'table'], function () {
...
var myTable = table.render({
...
, done: function (res, curr, count) {
soulTable.render(this)
}
});
$('#export').on('click', function() {
soulTable.export(myTable);
})
})
</script>依赖项目
| 开源项目名称 | 地址 | 用于 | |:-|:-|:-| | layui | https://github.com/sentsin/layui | 土壤框架 | | layui-excel | https://github.com/wangerzi/layui-excel | excel文件导出 |
最后
当然具体的可以clone下来代码查看，有问题可以在 issue 区提问，我会尽可能快的回复。