跳到主要内容

selection

描述​

可选。启用/禁用单元格选择功能

用法​

selection?: boolean;

默认配置​

selection: true

示例​

const spreadsheet = new dhx.Spreadsheet("spreadsheet_container", {
    selection: false,
    // other config parameters
});

详情​

当该属性设置为 false 时：

  • Spreadsheet 没有活动单元格
  • 无法通过鼠标、键盘或 API 选择单元格：setSelectedCell() 和 setFocusedCell() 方法会被忽略，getSelectedCell() 和 getFocusedCell() 方法返回 undefined
  • 无法通过界面编辑单元格：公式栏被锁定，填充柄被隐藏，startEdit() 方法会被忽略
  • 上下文菜单和列菜单图标不可用
  • Tab 键在网格上仅停留一次，然后将焦点移到后面的元素，Ctrl + F6 会跳过网格

仍可通过拖动边框调整列和行的大小，也仍可通过 API 更改数据，例如使用 setValue() 方法。

与 readonly 属性结合使用时，该选项会关闭只读模式下可用的键盘导航和选择功能：

const spreadsheet = new dhx.Spreadsheet("spreadsheet_container", {
    readonly: true,
    selection: false,
    // other config parameters
});

若要在运行时关闭和开启选择功能，请使用 selection.disable() 和 selection.enable() 方法。

更新日志： 在 v6.0.4 中新增

相关文章：

Need more help?Contact Support