Handsontable-一款仿 Excel效果的表格插件使用总结

导语:

最近在做一个关于报表管理的项目,发现了一款很好用的jQuery插件-Handsontable。它真的特别给力,在 Excel 中可进行的操作,你几乎都可以在网页中做到,如拖动复制、Ctrl+C 、Ctrl+V 、编辑等等。另外在浏览器支持方面,它支持以下的浏览器 IE7+, FF, Chrome, Safari, Opera。

一、安装


有很多方法可以安装Handsontable,最方便的是使用包管理器

npm install handsontable --save

or

bower install handsontable --save

下载下来本地引入也可以

  • Download ZIP
  • Download from nuget

二、初始化


var data = [
["", "Ford", "Volvo", "Toyota", "Honda"],
["2016", 10, 11, 12, 13],
["2017", 20, 11, 14, 13],
["2018", 30, 15, 12, 13]
];
var container = document.getElementById('example');
var hot = new Handsontable(container, {
data: data,
rowHeaders: true,
colHeaders: true,
});

结果

Handsontable-一款仿 Excel效果的表格插件使用总结_第1张图片

一个简单的Excel电子表格就出来了,另外handsontable使用JSON格式数据绑定数据源(data属性),能够处理大量的数据。

三、基本属性配置


标题

  • 纵向标题
    rowHeaders:true/false/数组
  • 横向标题
    colHeaders:true/false/数组

单元格

  • 指定列宽
    colWidths:宽度/数组
  • 自适应列大小
    autoColumnSize:true/false当值为true且列宽未设置时,自适应列大小
  • 拖拽行头或列头改变行或列的大小
    manualColumnResize:true/false当值为true时,允许拖动,当为false时禁止拖动
    manualRowResize:true/false当值为true时,允许拖动,当为false时禁止拖动
  • 延伸列的宽度
    stretchH:last/all/none last:延伸最后一列,all:延伸所有列,none默认不延伸
  • 指定单元格的某些属性 cell
    cell: [ {row:0, col:0, className: 'htRight htMiddle', editor: false}, // 右对齐垂直居中,只读 {row:1, col:1, className: 'htLeft'} // 左对齐 ]
  • 单元格合并
    mergeCells: [{row: 起始行数, col: 起始列数, rowspan: 合并行数, colspan:合并列数 },...]
  • 自动换行
    wordWrap:true(默认)
  • 自定义边框
    customBorders:[{range:{from:{row:行数,col:列数},to:{row:行数,col:列数},上下左右设置}]

表格操作

  • 拖动行或列到指定位置
    manualColumnMove:true/false 当值为true时,列可拖拽移动到指定列
    manualRowMove:true/false 当值为true时,行可拖拽至指定行
  • 允许排序
    columnSorting:true/false当值为true时,表示启用排序插件
  • 右键菜单展示
    contextMenu:true/false/自定义数组 当值为true时,启用右键菜单,为false时禁用
  • 允许键盘复制
    copyable:true
  • 允许拖动复制
    fillHandle:true 也可以控制方向:fillHandle: 'vertical'

四、常用方法


  • 添加列
    createCol(index,amount,createAutomatically) index:列索引,amount:添加的列总数,createAutomatically:为一个数字
  • 设置单个单元格的值
    set(row,prop,value,source)row:行索引,prop:列索引,value:新值,source:hook插件的提供者
  • 获取数据
    getData()
  • 加载数据
    loadData(data)
  • 清空数据
    clear()
  • 添加或移除列数据
    spliceCol(col,index,amount)col:列索引,index:开始改变的数组索引,amount:改变数据的个数
  • 添加或删除行数据
    spliceRow(row,index,amount)row:行索引,index:开始改变的数组索引,amount:改变数据的个数

总结

关于Handsontable的详细使用大家可以参考官方API文档,这里只说一些常用的操作,希望这篇文章对你有所帮助。

你可能感兴趣的:(Handsontable-一款仿 Excel效果的表格插件使用总结)