handsontable-cell features

数据验证：在columns中设置validator，进行同步或异步验证，还可添加beforeValidate, afterValidate函数，allowInvalid：true可以不用验证

var people = [
      {id: 1, name: {first: 'Joe', last: 'Fabiano'}, ip: '0.0.0.1', email: 'Joe.Fabiano@ex.com'},
      {id: 2, name: {first: 'Fred', last: 'Wecler'}, ip: '0.0.0.1', email: 'Fred.Wecler@ex.com'},
      {id: 3, name: {first: 'Steve', last: 'Wilson'}, ip: '0.0.0.1', email: 'Steve.Wilson@ex.com'},
      {id: 4, name: {first: 'Maria', last: 'Fernandez'}, ip: '0.0.0.1', email: 'M.Fernandez@ex.com'},
      {id: 5, name: {first: 'Pierre', last: 'Barbault'}, ip: '0.0.0.1', email: 'Pierre.Barbault@ex.com'},
      {id: 6, name: {first: 'Nancy', last: 'Moore'}, ip: '0.0.0.1', email: 'Nancy.Moore@ex.com'},
      {id: 7, name: {first: 'Barbara', last: 'MacDonald'}, ip: '0.0.0.1', email: 'B.MacDonald@ex.com'},
      {id: 8, name: {first: 'Wilma', last: 'Williams'}, ip: '0.0.0.1', email: 'Wilma.Williams@ex.com'},
      {id: 9, name: {first: 'Sasha', last: 'Silver'}, ip: '0.0.0.1', email: 'Sasha.Silver@ex.com'},
      {id: 10, name: {first: 'Don', last: 'Pérignon'}, ip: '0.0.0.1', email: 'Don.Pérignon@ex.com'},
      {id: 11, name: {first: 'Aaron', last: 'Kinley'}, ip: '0.0.0.1', email: 'Aaron.Kinley@ex.com'}
    ],
    example1 = document.getElementById('example1'),
    example1console = document.getElementById('example1console'),
    settings1,
    ipValidatorRegexp,
    emailValidator;

  ipValidatorRegexp = /^(?:\b(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\b|null)$/;
  emailValidator = function (value, callback) {
    setTimeout(function(){
　　　 //还能这样验证
      if (/.+@.+/.test(value)) {
        callback(true);
      }
      else {
        callback(false);
      }
    }, 1000);
  };

  settings1 = {
    data: people,
　　//hooks
    beforeChange: function (changes, source) {
　　　 //changes是数组，数组的元素也是数组，包含四个属性0:10,1：'name.last',2:'Kinley',3:'foo'
      for (var i = changes.length - 1; i >= 0; i--) {
        // gently don't accept the word "foo" (remove the change at index i)
　　　　 //如果想改为foo，会把这次修改删掉
        if (changes[i][3] === 'foo') {
          changes.splice(i, 1);
        }
        // if any of pasted cells contains the word "nuke", reject the whole paste
　　　　 //如果想改为nuke，只是拒绝，而不会删除此次修改
        else if (changes[i][3] === 'nuke') {
          return false;
        }
        // capitalise first letter in column 1 and 2
        else if ((changes[i][1] === 'name.first' || changes[i][1] === 'name.last') && changes[i][3].charAt(0)) {
          changes[i][3] = changes[i][3].charAt(0).toUpperCase() + changes[i][3].slice(1);
        }
      }
    },
    afterChange: function (changes, source) {
      if (source !== 'loadData') {
        example1console.innerText = JSON.stringify(changes);
      }
    },
    colHeaders: ['ID', 'First name', 'Last name', 'IP', 'E-mail'],
    columns: [
      {data: 'id', type: 'numeric'},
      {data: 'name.first'},
      {data: 'name.last'},
　　　 //给ip加事件处理程序，可以不通过验证
      {data: 'ip', validator: ipValidatorRegexp, allowInvalid: true},
      {data: 'email', validator: emailValidator, allowInvalid: false}
    ]
  };
  var hot = new Handsontable(example1, settings1);

往下拖

var
    data = [
      ['', 'Kia', 'Nissan', 'Toyota', 'Honda'],
      ['2012', 10, 11, 12, 13],
      ['2013', 20, 11, 14, 13],
      ['2014', 30, 15, 12, 13],
      ['2015', '', '', '', ''],
      ['2016', '', '', '', '']
    ],
    container = document.getElementById('example1'),
    hot1;

  hot1 = new Handsontable(container, {
    rowHeaders: true,
    colHeaders: true,
    //默认为true，如果为"horizontal"，则只能水平拖动
    fillHandle: true // possible values: true, false, "horizontal", "vertical"
  });
  hot1.loadData(data);

合并单元格

var
    container = document.getElementById('example1'),
    hot;

  hot = new Handsontable(container, {
    data: Handsontable.helper.createSpreadsheetData(100, 18),
    colWidths: [47, 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, 47],
    rowHeaders: true,
    colHeaders: true,
    contextMenu: true,
    //使用mergeCells提供合并单元格的细节
    mergeCells: [
      {row: 1, col: 1, rowspan: 3, colspan: 3},
      {row: 3, col: 4, rowspan: 2, colspan: 2},
      {row: 5, col: 6, rowspan: 3, colspan: 3}
    ]
  });

布局：在cell中设置位置；水平方向：htLeft, htCenter, htRight, htJustify；垂直方向：htTop, htMiddle, htBottom

  var
    container = document.getElementById('example1'),
    hot1;

  hot1 = new Handsontable(container, {
    data: Handsontable.helper.createSpreadsheetData(100, 18),
    colWidths: [47, 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, 47],
    rowHeaders: true,
    colHeaders: true,
    contextMenu: true,
    mergeCells: [
      {row: 1, col: 1, rowspan: 3, colspan: 3},
      {row: 3, col: 4, rowspan: 2, colspan: 2}
    ],
    //预定义了很多类
    className: "htCenter",
    cell: [
      {row: 0, col: 0, className: "htRight"},
      {row: 1, col: 1, className: "htLeft htMiddle"},
      {row: 3, col: 4, className: "htLeft htBottom"}
    ],
    //在这个hooks中，可以捕获到布局的改变
    afterSetCellMeta: function (row, col, key, val) {
      console.log("cell meta changed", row, col, key, val);
    }
  });

列和单元格的只读属性

var
    container1 = document.getElementById('example1'),
    hot1;

  hot1 = new Handsontable(container1, {
    data: getCarData(),
    colHeaders: ['Car', 'Year', 'Chassis color', 'Bumper color'],
    columns: [
      {
        data: 'car',
　　　　 //列只读
        readOnly: true
      },
      {
        data: 'year'
      },
      {
        data: 'chassis'
      },
      {
        data: 'bumper'
      }
    ]
  });

//单元格只读
var
    container2 = document.getElementById('example2'),
    hot2;

  hot2 = new Handsontable(container2, {
    data: getCarData(),
    colHeaders: ['Car', 'Year', 'Chassis color', 'Bumper color']

  });
  hot2.updateSettings({
    cells: function (row, col, prop) {
      var cellProperties = {};

      if (hot2.getData()[row][prop] === 'Nissan') {
        cellProperties.readOnly = true;
      }

      return cellProperties;
    }
  })

列和单元格不可编辑：non-edit cell仍然可以拖动填充，复制粘贴，只是不能编辑；只读属性：不能做任何操作

var
    container1 = document.getElementById('example1'),
    hot1;

  hot1 = new Handsontable(container1, {
    data: getCarData(),
    colHeaders: ['Car', 'Year', 'Chassis color', 'Bumper color'],
    columns: [
      {
        data: 'car',
        editor: false
      },
      {
        data: 'year',
        editor: 'numeric'
      },
      {
        data: 'chassis',
        editor: 'text'
      },
      {
        data: 'bumper',
        editor: 'text'
      }
    ]
  });

var
    container2 = document.getElementById('example2'),
    hot2;

  hot2 = new Handsontable(container2, {
    data: getCarData(),
    colHeaders: ['Car', 'Year', 'Chassis color', 'Bumper color']
  });
  hot2.updateSettings({
    cells: function (row, col, prop) {
      var cellProperties = {};

      if (hot2.getData()[row][prop] === 'Nissan') {
        cellProperties.editor = false;
      } else {
        cellProperties.editor = 'text';
      }

      return cellProperties;
    }
  })