data_proxy 数据驱动核心类#

数据核心类，里边代理了很多功能

// instance 你创建的实例，公有方法可以直接调用，私有方法不可以
instance.data.publicFn(args);
// 或者
instance.sheet.data.publicFn(args);

私有方法#

Method: canPaste#

粘贴前调用，用以判断是否可以粘贴

@param {Object} src 由 cellRange 包装的对象，源单元格

@param {Object} dst 由 cellRange 包装的对象，目标单元格

@param {Function} error 错误回调 当目标单元格包含 merge 时调用

@returns {boolean} 是否可以粘贴

function canPaste(src, dst, error = () => {}) {
  // 正常返回 Boolean 类型
  // 若目标单元格包含 merge 时则调用 error() 并返回 false
})

Method: copyPaste#

粘贴复制的单元格时使用，用以将源单元格复制到目标单元格

@param {Object} srcCellRange 由 cellRange 包装的对象，源单元格

@param {Object} dstCellRange 由 cellRange 包装的对象，目标单元格

@param {String} what 复制条件 all 全部 | format 仅格式

@param {Boolean} autofill 是否自动填充，默认 false

function copyPaste(srcCellRange, dstCellRange, what, autofill = false) {
  // 根据 what 条件
  // 调用 rows.copyPaste 进行复制单元格
})

Method: cutPaste#

粘贴剪切的单元格时使用，用以将源单元格复制到目标单元格

@param {Object} srcCellRange 由 cellRange 包装的对象，源单元格

@param {Object} dstCellRange 由 cellRange 包装的对象，目标单元格

@param {String} what 复制条件 all 全部 | format 仅格式

@param {Boolean} autofill 是否自动填充，默认 false

function cutPaste(srcCellRange, dstCellRange) {
  // 调用 rows.cutPaste 进行粘贴剪切的单元格
})

Method:setStyleBorder#

设置指定的单元格边框

@param {Number} ri 行下标

@param {Number} ci 列下标

@param {Object} bss 边框样式

function setStyleBorder(ri, ci, bss) {
  // 将 bss 样式通过 this.addStyle 方法添加到样式数据中，并将返回的样式下标设置到 cell.style 单元格数据中
})

Method:setStyleBorders#

根据当前选区（this.selector）批量设置多个单元格的边框

@param {String} mode all 全部 | inside 内边框 | outside 外边框 | horizontal 水平边框 | vertical 竖边框 | none 无边框

@param {String} style 边框样式

@param {String} color 边框样式

function setStyleBorders({ mode, style, color }) {
  // 根据 mode 设置边框
})

Method:getCellRowByY#

根据 Y 坐标获取所在行的下标

@param {Number} y Y坐标

@param {Number} scrollOffsety 滚动条 Offset Y

@returns {Object} 带有 ri 行下标的对象

function getCellRowByY(y, scrollOffsety) {
  // 根据 Y 坐标返回 { ri, top, height }
})

Method: getCellRowByX#

获得单元格的通过 X 的坐标

根据 X 坐标获取所在行的下标

@param {Number} x X坐标

@param {Number} scrollOffsety 滚动条 Offset X

返回格式

interface ICellRetun {
  ci: number;
  left: number;
  width: number;
}

DataProxy 类#

Method: addValidation(mode, ref, validator)#

添加验证

@param mode 编辑模式

@param ref 参考范围

@param validator 验证器

Method: removeValidation()#

移除验证范围

Method: getSelectedValidator()#

获得选中范围类的过滤或验证器

Method: getSelectedValidation()#

获得选中范围类的过滤或验证器具体信息

Method: canUndo()#

是否可以不做，撤销操作

Method: canRedo()#

是否可以重做

Method: undo()#

撤销一步

Method: redo()#

重做一步

Method: copy()#

复制当前的选区

Method: copyToSystemClipboard()#

复制到系统剪切板

Method: cut()#

集成剪切事件

Method: paste(what, error)#

粘贴事件

@param what: all(所有) | text(文字) | format(格式)

@param error: Function

Method: pasteFromText(txt)#

粘贴文字

@param txt: string

Method: autofill(cellRange, what, error)#

自动填充

@param cellRange: CellRange

@param what: all(所有) | text(文字) | format(格式)

@param error: Function

Method: clearClipboard()#

清除剪切板数据

Method: calSelectedRangeByEnd(ri, ci)#

计算选区范围，通过结束坐标

@param ri 行索引

@param ci 列索引

Method: calSelectedRangeByStart(ri, ci)#

计算选区范围，通过开始坐标

@param ri 行索引

@param ci 列索引

Method: setSelectedCellAttr(property, value)#

设置选中单元格属性

@param property: string 属性

@param value: string | number | unknow

Method: setSelectedCellText(text, state = 'input)#

设置选中单元格文字

@param text: string 文字

@param state: string 当前输入状态

Method: getSelectedCell()#

获得当前选中单元格

Method: xyInSelectedRect()#

判断当前鼠标点击坐标是否在选中范围内

Method: getSelectedRect()#

获得选中的矩形区域

Method: getClipboardRect()#

获得当前剪切板选中区域

Method: getRect(cellRange)#

获得设定选中范围区域

@param cellRange: CellRange

Method: getCellRectByXY(x, y)#

获得当前选中区域，通过鼠标的 x 和 y 坐标

@param x: number

@param y: number

Method: isSignleSelected()#

判断是否是单个选中

Method: canUnmerge()#

能否不合并

Method: merge()#

合并

Method: unmerge()#

不做合并，撤销合并

Method: canAutofilter()#

能自动过滤

Method: autofilter()#

过滤

Method: setAutoFilter(ci, order, operator, value)#

设置过滤器

@param ci 列索引

@param order 排序方式

@param operator 操作

@param value 值

Method: resetAutoFilter()#

重置自动过滤

Method: deleteCell(what = 'all')#

删除单元格

@param what: string all(所有) | fomat(格式)

Method: insert(type, n = 1)#

插入行或者列

@param type: string 可能的值 row | column

@param n: number > 0

Method: delete(type)#

删除选中行或者列

@param type: string 可能的值 row | column

Method: scrollx(x, cb)#

滚动 x 距离触发 cb

@param x: number 距离

@param cb: Function 触发的回调函数

Method: scrolly(y, cb)#

滚动 y 距离触发 cb

@param y: number 距离

@param cb: Function 触发的回调函数

Method: cellRect(ri, ci)#

返回当前单元格的具体坐标信息

@param ri: number 行索引

@param ci: number 列索引

Method: getCell(ri, ci)#

获得当前单元格，通过索引

@param ri: number 行索引

@param ci: number 列索引

Method: getCellTextOrDefault(ri, ci)#

获得当前单元格文字或者默认值

@param ri: number 行索引

@param ci: number 列索引

Method: getCellStyle(ri, ci)#

获得当前单元格样式

@param ri: number 行索引

@param ci: number 列索引

Method: getCellStyleOrDefault(ri, ci)#

获得当前单元格样式或者默认值

@param ri: number 行索引

@param ci: number 列索引

Method: getSelectedCellStyle()#

获得当前选中单元格样式

Method: setCellText(ri, ci, text, state)#

设定指定单元格值，并更新输入状态

@param ri: number 行索引

@param ci: number 列索引

@param text: string 文字

@param state: string input | finished

Method: freezeIsActive()#

冻结是否可以激活

Method: setFreeze(ri, ci)#

设置冻结栏

@param ri: number 行索引

@param ci: number 列索引

Method: freezeTotalWidth()#

获得冻结栏的总计宽度

Method: freezeTotalHeight()#

获得冻结栏总计高度

Method: setRowHeight(ri, height)#

设置某一行高度

@param ri: number 行索引

@param height: number 行高度

Method: setColWidth(ci, width)#

设置某一列宽度

@param ci: number 列索引

@param width: number 列宽度

Method: viewHeight()#

获得可视区域高度

Method: viewWidth()#

获得可视区域宽度

Method: freezeViewRange()#

获得冻结范围

Method: contentRange()#

获得文本区域显示范围

Method: exceptRowTotalHeight(sri, eri)#

获得忽略行后的总计高度

Method: viewRange()#

获得可视区显示范围

Method: eachMergesInView(viewRange, cb)#

每个合并发生的时候触发的回调

@param viewRange: ViewRange

@param cb: Function

Method: hideRowsOrCols()#

隐藏选中列或者行

Method: unhideRowsOrCols(type, index)#

取消隐藏行或者列

@param type: row | col

@param index: row-index | col-index

Method: rowEach(min, max, cb)#

行遍历，可以指定范围

@param min: number 最小行

@param max: number 最大行

@param cb: Function

Method: colEach(min, max, cb)#

列遍历，可以指定范围

@param min: number 最小列

@param max: number 最大列

@param cb: Function

Method: defaultStyle()#

获得默认样式

Method: addStyle(nstyle)#

设置多个样式

@param nstyle object

Method: changeData(cb)#

设置数据变化时的回调函数

@param cb: Function

Method: setData(d)#

设置表格数据，d 如果不知道可以通过 getData() 方法先获取一份默认的看看

@param d: object

Method: getData()#

获得当前表格的数据