html上现在有比较好用的表格控件是datatable,但是编辑、按钮等部分是收费的,只有基础功能免费。而且尺寸发生变化时需要手工刷新等繁琐操作较多。所以我开发一个免费的供大家使用。
本项目已用于“虚空服务器开发套件”。目前主要支持微软Edge浏览器,Chrome浏览器,其它未测。
tbl.js完全免费,可随意修改,欢迎fork。
tbl.js支持列表样式,增删改查,全表搜索,分组,分页功能,全表编辑,全行编辑,单选,多选,样式定制。
可以嵌入到各种容器中,比如jquery的dialog,tabs中。
版本:0.1beta
提出bug,我会尽快修改。新年不休息。
如果不需要修改样式,可以不加载tbl.css,tbl.js会动态加载样式表。
示例代码1:(从DOM节点构建)
html:<html><body><div></div></body></html>
new tbl(document.body.children[0],{data:[["row1"],["row2"]]});
示例代码2:(自创建DOM节点)
var tb = new tbl();
with (document.body) { insertBefore(tb.dom, firstChild) };
tb.bind([["row1"],["row2"]]);
示例代码3:(多字段)
var tb = new tbl(undefined, {format:[{width:"20%"},{width:"20%"},{width:"20%"},{width:"20%"},{width:"20%"}]});
with (document.body) { insertBefore(tb.dom, firstChild) };
tb.bind([["row1","data","data","data","data"],["row2","data","data","data","data"]]);
示例代码4:(列表样式,最大高度300px,无头部,无标题,无页脚,5条数据,按钮,获取行索引)
html:<html><body><div></div></body></html>
var tb = new tbl(document.body.children[0], {
editable: false, maxheight: "300px", header: false, title: false, footer: false, data: [[1], [2, "remove"], ["nan - not a number", "del"], [4, "del"], [5, "del"]], page_size: 100,
format: [
{ width: "90%", nancenter: true, input: {type:"text"}},
{ width: "10%", editable:true, input: { type: "button", value:"del", onclick: function () { tb.delete(tb.get_related_rowid(this));}}}
]
});
示例代码5:(全表编辑,单选,必须选择一行,分页)
var tb_data = [];
for (var i = 0; i < 106; i++) {
tb_data[i] = [Math.random()>0.5?true:false, Math.random(), "1970-01-01", Math.floor(Math.random()*10), i, 0];
}
tb_data[i] = "this is group"; i++;
tb_data[i] = ["this is text"]; i++;
for (; i < 578; i++) {
tb_data[i] = [i, Math.random(), "2017-02-01"];
}
var tb = new tbl(document.body.children[0], {
editable:true,select:tbl.single,must_select:true,paging:true,data:tb_data,page_size:15,
format: [
{ width: "5%", input: { type: "checkbox", check: "true" } },
{ width: "30%", name:"name", uneditable:true },
{ width: "20%", name:"date", input: { type: "date" } },
{ width: "10%", name:"select", input: {type:"select", options:[0,1,2,3,4,5,6,7,8,9]} },
{ width: "20%" },
{ width: "15%", input: {type:"radio", name:"only"}}
]
});
API:
add 末尾添加,添加一行数据必须是数组,非数组会作为组标题文本。
insert 插入数据
bind 绑定新数据源
delete 删除一行
clear 清理
edit 编辑一行,空参数表示编辑整表
select 选择一行
cancel_edit 取消编辑
cancel_select 取消选择
select_change 选择改变函数设置
只读属性:
tbl::selects 已经选择的行
tbl::data 数据
tbl::dom DOM节点
tbl::edits 正在编辑的行,全表编辑不适用
构造选项:
max_height 最大高度,超过将显示滚动条
page_size 页尺寸
data 初始化数据
header 是否显示表头
footer 是否显示页脚
info 是否显示信息
paging 是否显示分页
title_bar 显示标题条
title 标题条文本
search 显示搜索框
editable 全表编辑
select 选择的类型:0, 不能选择. 1, 单选. 2, 多选.tbl.single == 1, tbl.multiselect == 2
select_change 设置选择事件处理函数
must_select 必须选择一行
format 列格式
width 宽度,可以是有效的html宽度。例如:100px or 20%.
input 用于编辑状态的input节点属性,与html/input属性相同
name 字段名称,显示在表头
uneditable 列将不能被编辑
editable 列将总是编辑状态
nancenter 非数字居中
项目/源码:
github:https://github.com/FettLuo/tbl.js