/handsontable

在线表格编辑，可编辑公式、添加Object对象

Primary LanguageJavaScript

可编辑公式的表格

  • 公式单元格展示计算结果
  • 点击公式单元格展示并可编辑公式
  • 公式单元格黄色背景
  • 非法数据红色背景
  • 撤销和重做、粘贴等数据更新
  • 调整宽度
  • 禁止编辑状态
  • 数据修改后其他依赖该数据的需要重新计算
  • 菜单改为中文
  • 公式默认展示计算结果，hover时提示公式内容
  • 支持Object对象属性计算
  • Object对象预览
  • Object对象属性别名
  • Object对象删除
  • Object对象复制
  • 公式中引用另一个单元格的计算结果
  • 自定义对象展示函数
  • 条件表达式
  • SUM等区域函数
  • 中间插入或删除行或列时，更新所有公式中包含了底部或右侧区域的内容
  • 可下拉选择数据
  • 单元格合并及对齐方式修改存储
  • 外界更新数据时如何更新界面(render函数)
  • ObjectEditor自定义编辑支持
  • 禁止复制对象
  • 禁止删除对象
  • 避免对象覆盖编辑(可删除后重新编辑)

效果预览

示例（参考src/example.js）

require('@laomu/handsontable/dist/style.css')
const Tabel = require('@laomu/handsontable')
var data = [
    ['说明', '内容', null],
    ['数据', 10, 11],
    ['字符串', 'AAA', ''],
    ['对象', {name: '对象A', value: 123, hide: false}, {name: '对象B', value: 133}],
    ['公式', '=B2+C2'],
    ['错误示例', '=B1+B2'],
    ['对象属性计算', '=B4.value + 1'],
    ['别名计算示例', '=B4.值 + 1'],
    ['不存在的属性', '=B4.notExist'],
    ['公式套公式', '=B5 + 10'],
]

var container = document.getElementById('table')
var hot = new Tabel({
    dom: container,
    data: data,
    // 属性别名
    propAlias: {
        'value': '值'
    },
    // 合并单元格
    mergeCells: [
        {row: 0, col: 1, rowspan: 1, colspan: 2}
    ],
    // 对齐方式
    metas: [
        {row: 0, col: 0, meta: {className: 'htRight'}}
    ],
})

// 需要选择数据时触发
hot.on('dblclick-object', function(row, col, data) {
    console.log('select:', row, col, data);
    setTimeout(() => {
        let value = data.value
        hot.setDataAtCell(row, col, {
            name: '值:' + (value + 1),
            value: (value + 1)
        })
    }, 1000)
});

// 当有数据变化时触发
hot.on('update', function(data) {
    console.log('update:', hot.getDataWithFormat());
})

初始化参数

  • dom 编辑区所在dom
  • data 编辑区使用的数据
  • config 覆盖handsontable默认配置
  • disabled 是否禁止编辑，默认false
  • propAlias 对象属性的中文别名
  • commentNeedAlias 只有指定了别名，对象的属性才会展示在注释中，避免注释内容过多, 默认false

事件

  • dblclick(row, col, data) 点击单元格触发
  • dblclick-object(row, col, obj) 点击了对象单元格
  • selection(row1, col1, row2, col2) 选中了某个区域时触发
  • select-cell(row, col) 选择了某个单元格时触发
  • change/update(array) 数据更新事件

方法

  • getData() 获取数据
  • setDataAtCell(row, col, data) 设置单元格的值
  • getCellData(row, col) 获取单元格计算后的值
  • getCellOrigin(row, col) 获取单元格原始数据
  • getDataWithFormat() 取得包含格式等内容的数据
  • updateSettings() 更新配置后调用

相关链接

开发说明

执行npm run dev

更新产出

  1. 执行npm run webpack生成github pages中使用的example示例页面
  2. 执行npm run build生成供外呼模块中引入的入口文件dist/table.js
  3. git push提交到github
  4. npm publish发版到npm

版本

  • v1.0.6
    • 普通公式计算修复
    • 增加DateToNumber和NumberToDate函数，方便时间计算
    • 公式递归报错
  • v1.0.5
    • 表格初始化时包含合并单元格和对齐方式
  • v1.0.4
    • 对象可复制、删除
    • 公式嵌套公式