1 Star 0 Fork 14

飞鱼 / table2

forked from Rainbow / table2 
加入 Gitee
与超过 1200万 开发者一起发现、参与优秀开源项目,私有仓库也完全免费 :)
免费加入
该仓库未声明开源许可证文件(LICENSE),使用请关注具体项目描述及其代码上游依赖。
克隆/下载
贡献代码
同步代码
取消
提示: 由于 Git 不支持空文件夾,创建文件夹后会生成空的 .keep 文件
Loading...
README

table2

前端table插件,需要layui支持,很多思路都是参照layuitable实现 :smile: ,jquery直接使用版本,可参见

先看几张效果图

07 01 02 03 04 05 06

兼容性

因本人经验不足,无法兼容所有浏览器,理论上支持H5的浏览器应该都可以(见谅)。 在IE8(H5的效果无效)、IE11、Edge、Chrome62、firefox57、360浏览器8.1(内核45)内测试均正常,其他浏览器没装就没再查看。

参数说明,最终以代码为准

2018-01-03 v1.0

table2.js使用说明:(具体以table2.js文件内说明为准,后续不再更新)
表格支持定宽或自适应宽度,
使用方法
        layui.config({
            base: '自己项目下table2目录'
        }).use('table2', function () {
            table = layui.table2;
            //table初始化
            ......

        });

table属性option:
url:ajax请求路径
method:ajax请求方法,可选get|post,默认get
width:容器宽度,数值
height:容器高度,数值|full-数值|sel-jqselectors-数值(jqselectors选择器不支持-符号,因为需要按照-分割)。
             使用sel模式时,只需填写table下方的容器选择器,系统会自动剔除上方的dom高度,如果固定数值没有,请填写0,不能省略
minHeight: 表格最小高度,默认80
skin:皮肤,可选col|row|none,col:列边框风格,row:行边框风格,none:无边框风格
even:隔行换色,可选true|false,默认false
expandRow: 行是否允许展开,可选true|false,默认false。需要配合on("expand", function(){})使用
singleSelect:单选行,可选true|false,默认false,可以选中多行
nowrap:数据是否自动换行,默认true,不自动换行,填写true性能更高一下
localSort: 本地排序,默认true,不想使用本地排序,请配置成false;如果由后台排序建议配置成false
loading: 请求数据时,是否显示loading,默认true
cellMinWidth: 所有单元格默认最小宽度,默认60px
serialField:主键唯一字段,建议填写,否则删除数据的时候性能减弱,默认id,区分大小写
colspanDefs:数组,合并单元格,例如:["Name", "Body"]将会按照Name和Body进行单元格合并
page:是否分页,默认false,可选true,或则如下
    {
        align:对齐方式,可选left|right|center,默认left
        curr:当前页
        limit:每页显示的数量,默认10条
        limits:每页条数选择,默认[10, 20, 30, 40, 50, 60, 70, 80, 90]
    }

属性事件:
onAjaxBeforeSend(xhr):和ajax beforeSend参数一致,此时this为本次ajax请求时传递的options参数。
                                        如果返回false可以取消本次ajax请求
onAjaxSuccess(result):ajax成功请求数据时(table清除上次数据后),在这里可以做数据统一。
                                    需要返回json数据,格式为{code: 0, msg: '错误信息', count: 100, data: []},code为0时表示成功。
                                    此时this为本次ajax请求时传递的options参数
onAjaxError(xhr, textStatus, errorThrown):和ajax error参数一致,此时this为本次ajax请求时传递的options参数

onBeforeAddRow(rowindex, data): 添加行数据前返回行索引和行数据
onAddRow(rowindex, data): 添加行数据后返回行索引和行数据
onPageLimitChanged(preLimit, toLimit):当每页条数发生变化时触发,preLimit为之前的页条数,toLimit为修改后条数
onPageJump(prePage, toPage):页码跳转,进行数据请求绑定前,prePage为之前的页码,toPage为修改后的页码
onComplete(data):所有处理完毕(table渲染数据结束),data为onAjaxSuccess返回的result数据



cols:属性
filed:绑定字段,需要显示的列必填,主标题副标题可不填
title:标题
sort:排序,可选true|false,默认false
width:宽度,可以是定宽,百分比;不填则自适应宽度
rowspan:行合并
colspan:列合并
resize:拖拽宽度,默认false
align:对齐方式
style:设置head样式,支持css所有样式,带小横线的需要用引号包起来,eg:style: { "font-size": "14px" }
dataStyle: 设定数据样式,只有包含field时才有效,带小横线的需要用引号包起来,eg:style: { "font-size": "14px" }
formatter(data, index):数据格式化,传入一个函数比如操作列,data当前行数据,index行号从0开始


tableIns方法:
reload:重新加载
getSelectedRows:获取选中行,返回数组,数据格式每个包含一个index,data,index为选中行序号,
                             从0开始,data为当前行数据,单选时注意使用list[0]
getData:获取table所有数据
on(event, callback):事件绑定。event字符串,可选如下,callback为函数
    tool返回函数function(evt, obj),evt为事件,obj包含index,data,tr,del,update,index为tr行号,
                                                     tr为dom对象,data为数据(只监听包含event的click事件)
    sort返回函数(initSort),initSort对象包含:sortField排序字段,sortType排序方式,可选asc|desc
    expand返回函数(rowindex, data, container): 行展开时回调,rowindex:行数据前返回行索引,data行数据,
                                                                container为容器,需要返回一个字符串
    check返回函数(index, row):行选中,index为tr行号,row为tr(jquery对象)
    uncheck返回函数(index, row):行取消选中,index为tr行号,row为tr(jquery对象)



可全局配置参数:
table2.options:属性包含如下
        expandRow: false,
        nowrap: true,
        minHeight: 80,
        singleSelect: false,
        localSort: true,
        loading: true,
        cellMinWidth: 60,
        serialField: "id"


注意:
1、进行拖拽后,表格将不再自适应宽度
2、cols中同时设置style和dataStyle时align无效。并且不建议设置max-width,首先对td无效,再者禁止换行时数据和表头有1px之差
3、建议所有列书写一个minWidth,因为当数据允许换行时(nowrap=true时),表头可能会被换行,不好看
4、

优点与不足

相比laytable优点:

  • 数据可以换行,自适应宽度;可以合并单元格
  • 浏览器大小改变时table可以自适应
  • 固定列可以滚动,实现3个滚动条的同步
  • 行可以展开,查看详情

相比laytable不足:

  • 不支持模板,这个我实在不会
  • 不支持行内编辑
  • checkbox没有layui-table好看
  • 没有进行严格的测试,不知道里面有多少坑(要求严格的项目慎用)
  • 没有什么高级的写法,内部实现大多采用字符串方式,不如laytable使用模板高大上
  • laytable和layui自成一体,系统化程度高
  • 等等吧

很高兴认识了layui,希望layui越来越好(^-^)

空文件

简介

前端table插件,需要layui支持 展开 收起
JavaScript
取消

发行版

暂无发行版

贡献者

全部

近期动态

加载更多
不能加载更多了
JavaScript
1
https://gitee.com/yuzhongxin/table2.git
git@gitee.com:yuzhongxin/table2.git
yuzhongxin
table2
table2
master

搜索帮助