@taocompany/magic-grid 0.1.2 → 0.1.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +356 -10
- package/dist/components/MagicGrid/MagicGrid.vue.d.ts +20 -0
- package/dist/components/MagicGrid/MagicGrid.vue.d.ts.map +1 -1
- package/dist/components/MagicGrid/resolveMagicGridDefaults.d.ts +7 -0
- package/dist/components/MagicGrid/resolveMagicGridDefaults.d.ts.map +1 -0
- package/dist/core/grid/cellRangeDragSelect.d.ts.map +1 -1
- package/dist/core/grid/grid.d.ts +1 -1
- package/dist/core/grid/grid.d.ts.map +1 -1
- package/dist/core/grid/gridInteraction/cellRangeInteraction.d.ts +7 -0
- package/dist/core/grid/gridInteraction/cellRangeInteraction.d.ts.map +1 -1
- package/dist/core/grid/gridInteraction/gridInteraction.d.ts +5 -0
- package/dist/core/grid/gridInteraction/gridInteraction.d.ts.map +1 -1
- package/dist/core/grid/gridInteraction/indexSelectionDragSession.d.ts +1 -1
- package/dist/core/grid/gridInteraction/indexSelectionDragSession.d.ts.map +1 -1
- package/dist/core/grid/gridInteraction/types.d.ts +2 -1
- package/dist/core/grid/gridInteraction/types.d.ts.map +1 -1
- package/dist/core/grid/gridSelection.d.ts +10 -1
- package/dist/core/grid/gridSelection.d.ts.map +1 -1
- package/dist/core/renderer/cellRangeVisualController.d.ts +3 -0
- package/dist/core/renderer/cellRangeVisualController.d.ts.map +1 -1
- package/dist/core/renderer/rowRenderer.d.ts +3 -0
- package/dist/core/renderer/rowRenderer.d.ts.map +1 -1
- package/dist/core/row/cellComp.d.ts +1 -0
- package/dist/core/row/cellComp.d.ts.map +1 -1
- package/dist/core/row/rowComp.d.ts +3 -0
- package/dist/core/row/rowComp.d.ts.map +1 -1
- package/dist/core/selection/cellClipboardService.d.ts +2 -1
- package/dist/core/selection/cellClipboardService.d.ts.map +1 -1
- package/dist/core/types/cellRangeSelection.d.ts +43 -7
- package/dist/core/types/cellRangeSelection.d.ts.map +1 -1
- package/dist/core/types/index.d.ts +1 -1
- package/dist/core/types/index.d.ts.map +1 -1
- package/dist/core/types/indexColumn.d.ts +2 -1
- package/dist/core/types/indexColumn.d.ts.map +1 -1
- package/dist/core/types/rowComp.d.ts +1 -0
- package/dist/core/types/rowComp.d.ts.map +1 -1
- package/dist/index.cjs.js +4 -4
- package/dist/index.cjs.js.map +1 -1
- package/dist/index.es.js +2805 -2608
- package/dist/index.es.js.map +1 -1
- package/dist/style.css +1 -1
- package/dist/types/magic-grid.d.ts +16 -1
- package/dist/types/magic-grid.d.ts.map +1 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -10,6 +10,7 @@
|
|
|
10
10
|
- [MagicGrid Props](#magicgrid-props)
|
|
11
11
|
- [Grid 级默认与列级覆盖](#grid-级默认与列级覆盖)
|
|
12
12
|
- [ColumnDef 列定义](#columndef-列定义)
|
|
13
|
+
- [Options 类型参考](#options-类型参考)
|
|
13
14
|
- [Events](#events)
|
|
14
15
|
- [Expose](#expose)
|
|
15
16
|
- [Slots](#slots)
|
|
@@ -185,7 +186,7 @@ const columns: ColumnDef[] = [
|
|
|
185
186
|
| `width` | `number` | `40` | 列宽 px（最小 40） |
|
|
186
187
|
| `start` | `number` | `1` | 起始序号（1-based 展示 = rowIndex + start） |
|
|
187
188
|
| `focusMode` | `'single' \| 'multiple'` | `'multiple'` | 辅助定位模式 |
|
|
188
|
-
| `syncToSelectionColumn` | `boolean` | `false` |
|
|
189
|
+
| `syncToSelectionColumn` | `boolean` | `false`（MagicGrid 组件层默认 `true`） | 索引列定位是否单向同步到行选择列；仅当 `focusMode` 与 `rowSelection` 同为 single 或同为 multiple 时生效 |
|
|
189
190
|
| `index` | `(rowIndex) => number \| string` | — | 自定义序号展示 |
|
|
190
191
|
| `showRowDragHandle` | `boolean` | `false` | 在索引列显示行拖拽把柄 |
|
|
191
192
|
| `enableRowResizer` | `boolean` | `false` | 索引列底边可拖拽调整行高 |
|
|
@@ -217,6 +218,7 @@ interface RowSelectionConfig {
|
|
|
217
218
|
| `width` | `number` | `40` | 列宽 px（最小 40） |
|
|
218
219
|
| `selectAllLabel` | `string` | `'全选'` | 表头全选 checkbox 的 aria-label |
|
|
219
220
|
| `rowLabel` | `(rowIndex) => string` | — | 行 checkbox 的 aria-label 工厂 |
|
|
221
|
+
| `headerAlign` / `headerValign` / `align` / `valign` / `footerAlign` / `footerValign` | 对齐枚举 | `'center'` | 对齐配置 |
|
|
220
222
|
|
|
221
223
|
#### 表尾汇总
|
|
222
224
|
|
|
@@ -243,8 +245,8 @@ interface RowSelectionConfig {
|
|
|
243
245
|
| `resizable` | `boolean` | `true` | 是否允许拖拽调整列宽（列级 `resizable` 优先） |
|
|
244
246
|
| `colResizeDefault` | `'shift'` | — | Shift 模式：拖拽列宽时相邻列反向补偿，总宽不变 |
|
|
245
247
|
| `skipHeaderOnAutoSize` | `boolean` | `false` | 双击 resize 把柄 auto-size 时跳过表头宽度 |
|
|
246
|
-
| `autoSizePadding` | `number` |
|
|
247
|
-
| `autoSizeStrategy` | `AutoSizeStrategy` | — | 挂载/首屏 auto-size
|
|
248
|
+
| `autoSizePadding` | `number` | `16` | auto-size 内容测量额外 padding（px） |
|
|
249
|
+
| `autoSizeStrategy` | `AutoSizeStrategy` | — | 挂载/首屏 auto-size 策略（见 [AutoSizeStrategy](#autosizestrategy)） |
|
|
248
250
|
| `suppressMoveWhenColumnDragging` | `boolean` | `false` | `true` → 仅 mouseup 提交列序 |
|
|
249
251
|
| `suppressColumnMoveAnimation` | `boolean` | `false` | 关闭列移动 transition |
|
|
250
252
|
| `allowCrossLaneColumnMove` | `boolean` | `false` | 允许 drag/API 跨 fixed lane 并更新列 `fixed` |
|
|
@@ -265,10 +267,10 @@ interface RowSelectionConfig {
|
|
|
265
267
|
|------|------|--------|------|
|
|
266
268
|
| `editMode` | `'cell' \| 'row'` | `'cell'` | 编辑范围：单格 / 整行 |
|
|
267
269
|
| `editType` | `CellEditType` | `'singleClick'` | 进入编辑态的触发方式 |
|
|
268
|
-
| `invalidEditValueMode` | `'block' \| 'revert'` | `'block'` | 校验失败后：`block` 保持编辑；`revert`
|
|
270
|
+
| `invalidEditValueMode` | `'block' \| 'revert' \| 'keep'` | `'block'` | 校验失败后：`block` 保持编辑；`revert` 退出并恢复旧值；`keep` 退出编辑但保留无效值 |
|
|
269
271
|
| `rowValidator` | `RowValidator` | — | 行编辑跨字段校验 |
|
|
270
272
|
| `cellEditorRegistry` | `Record<string, CellEditorFn>` | — | 实例级命名编辑器注册表 |
|
|
271
|
-
| `asyncRowMutation` | `AsyncRowMutationHandlers` | — | 异步行 CRUD
|
|
273
|
+
| `asyncRowMutation` | `AsyncRowMutationHandlers` | — | 异步行 CRUD 持久化钩子（见 [AsyncRowMutationHandlers](#asyncrowmutationhandlers)） |
|
|
272
274
|
|
|
273
275
|
#### 行拖拽与行高
|
|
274
276
|
|
|
@@ -337,7 +339,7 @@ interface RowSelectionConfig {
|
|
|
337
339
|
|
|
338
340
|
| Prop | 类型 | 默认值 | 说明 |
|
|
339
341
|
|------|------|--------|------|
|
|
340
|
-
| `cellCommentsDataSource` | `CellCommentsDataSource` | — |
|
|
342
|
+
| `cellCommentsDataSource` | `CellCommentsDataSource` | — | 批注数据源；提供即启用（见 [CellCommentsDataSource](#cellcommentsdatasource)） |
|
|
341
343
|
| `suppressCellComments` | `boolean` | `false` | 全局抑制批注交互 |
|
|
342
344
|
| `cellCommentTrigger` | `'click' \| 'hover'` | `'click'` | 查看已有批注的触发方式 |
|
|
343
345
|
| `cellCommentShowDelay` | `number` | `180` | hover 模式展示延迟 ms |
|
|
@@ -347,12 +349,36 @@ interface RowSelectionConfig {
|
|
|
347
349
|
|
|
348
350
|
| Prop | 类型 | 默认值 | 说明 |
|
|
349
351
|
|------|------|--------|------|
|
|
350
|
-
| `cellSelection` | `boolean \| CellSelectionOptions` | `
|
|
351
|
-
| `
|
|
352
|
+
| `cellSelection` | `boolean \| CellSelectionOptions` | `true` | 单元格框选；MagicGrid 默认开启、`enableColumnSelection` 为 `true`、`handle` 为 off；Grid API 未传时默认关闭 |
|
|
353
|
+
| `enableCellCopy` | `boolean` | `true` | Ctrl+C / `copySelectedRangeToClipboard` |
|
|
354
|
+
| `enableCellPaste` | `boolean` | `false` | Ctrl+V / `pasteFromClipboard` |
|
|
355
|
+
| `enableCellClipboard` | `boolean` | — | **已废弃**；未单独指定 copy/paste 时二者均继承本值 |
|
|
352
356
|
| `processCellForClipboard` | `ProcessCellForClipboardFn` | — | 复制单格时自定义导出值 |
|
|
353
357
|
| `processCellFromClipboard` | `ProcessCellFromClipboardFn` | — | 粘贴单格时预处理 clipboard 字符串 |
|
|
354
358
|
| `processDataFromClipboard` | `ProcessDataFromClipboardFn` | — | 整表粘贴前处理 TSV 矩阵；return null 取消粘贴 |
|
|
355
359
|
|
|
360
|
+
`CellSelectionOptions` 字段（`cellSelection` 为对象时）：
|
|
361
|
+
|
|
362
|
+
| 字段 | 类型 | 默认值 | 说明 |
|
|
363
|
+
|------|------|--------|------|
|
|
364
|
+
| `suppressMultiRanges` | `boolean` | `true` | `true` 时仅允许单个 range |
|
|
365
|
+
| `enableColumnSelection` | `boolean` | MagicGrid `true` / Grid API `false` | 点击表头选中整列 |
|
|
366
|
+
| `handle` | `FillHandleOptions \| RangeHandleOptions` | — | Fill 或 Range 拖拽柄；MagicGrid / Grid API 缺省均为 off |
|
|
367
|
+
|
|
368
|
+
`FillHandleOptions`（`handle: { mode: 'fill', ... }`）：
|
|
369
|
+
|
|
370
|
+
| 字段 | 类型 | 默认值 | 说明 |
|
|
371
|
+
|------|------|--------|------|
|
|
372
|
+
| `mode` | `'fill'` | — | **必填** |
|
|
373
|
+
| `direction` | `'x' \| 'y' \| 'xy'` | `'xy'` | 填充方向 |
|
|
374
|
+
| `fillStrategy` | `'auto' \| 'copy'` | `'copy'` | `'auto'`：数字递增、非数字复制；`'copy'`：始终复制源边值 |
|
|
375
|
+
| `fillReverseStrategy` | `'default' \| 'clear'` | `'default'` | 反拖缩小时：`'default'` 不处理；`'clear'` 置空缩出初始选区的格 |
|
|
376
|
+
| `setFillValue` | `(params: FillOperationParams) => unknown` | — | 自定义填充值；缺省按 `fillStrategy` |
|
|
377
|
+
|
|
378
|
+
`RangeHandleOptions`（`handle: { mode: 'range' }`）：仅含 `mode: 'range'`，用于右下角拖拽扩展选区。
|
|
379
|
+
|
|
380
|
+
> 框选详细行为见 [`docs/35-phase24-cell-range-selection.md`](docs/35-phase24-cell-range-selection.md)。
|
|
381
|
+
|
|
356
382
|
#### Tooltip
|
|
357
383
|
|
|
358
384
|
| Prop | 类型 | 默认值 | 说明 |
|
|
@@ -380,9 +406,13 @@ interface RowSelectionConfig {
|
|
|
380
406
|
| `overlayNoRowsTemplate` | `string` | — | 无数据模板 HTML |
|
|
381
407
|
| `overlayNoMatchingRowsTemplate` | `string` | — | 筛选无匹配模板 HTML |
|
|
382
408
|
| `loadingOverlayComponent` | `OverlayComponentType` | — | 自定义 loading 组件 |
|
|
409
|
+
| `loadingOverlayComponentParams` | `Record<string, unknown>` | — | loading 组件额外参数 |
|
|
383
410
|
| `noRowsOverlayComponent` | `OverlayComponentType` | — | 自定义无数据组件 |
|
|
411
|
+
| `noRowsOverlayComponentParams` | `Record<string, unknown>` | — | 无数据组件额外参数 |
|
|
384
412
|
| `noMatchingRowsOverlayComponent` | `OverlayComponentType` | — | 自定义筛选无匹配组件 |
|
|
413
|
+
| `noMatchingRowsOverlayComponentParams` | `Record<string, unknown>` | — | 筛选无匹配组件额外参数 |
|
|
385
414
|
| `overlayComponent` | `OverlayComponentType` | — | 通用 overlay 组件 |
|
|
415
|
+
| `overlayComponentParams` | `Record<string, unknown>` | — | 通用 overlay 组件额外参数 |
|
|
386
416
|
| `overlayInteraction` | `boolean` | — | overlay 内容是否可交互 |
|
|
387
417
|
|
|
388
418
|
#### 状态栏
|
|
@@ -390,7 +420,7 @@ interface RowSelectionConfig {
|
|
|
390
420
|
| Prop | 类型 | 默认值 | 说明 |
|
|
391
421
|
|------|------|--------|------|
|
|
392
422
|
| `showStatusBar` | `boolean` | `true` | 是否显示底部状态栏 |
|
|
393
|
-
| `showDefaultStatusBarPanels` | `boolean` | `true` |
|
|
423
|
+
| `showDefaultStatusBarPanels` | `boolean` | `true` | 显示默认状态栏左侧面板（行数/筛选态/选中数）；`false` 时仍可自定义 `#status-bar-left` |
|
|
394
424
|
| `showStatusBarRangeAggregation` | `boolean` | `true` | 框选时在状态栏展示平均值/计数/求和 |
|
|
395
425
|
| `statusBarRangeAggregationPrecision` | `number \| { average?: number; sum?: number }` | `2` | 平均值/求和展示小数位数 |
|
|
396
426
|
|
|
@@ -454,7 +484,7 @@ interface RowSelectionConfig {
|
|
|
454
484
|
| `comparator` | `ColumnComparatorFn` | 自定义排序比较器（asc 语义；desc 由内核取反） |
|
|
455
485
|
| `filterable` | `boolean` | 是否可筛选；缺省继承 Grid `filterable`（默认 false） |
|
|
456
486
|
| `filterType` | `ColumnDataFilterType` | 筛选数据类型；默认 `text` |
|
|
457
|
-
| `filterParams` | `FilterParams` | 列级 filter
|
|
487
|
+
| `filterParams` | `FilterParams` | 列级 filter 参数（见 [FilterParams](#filterparams)） |
|
|
458
488
|
| `filterValueGetter` | `(row) => unknown` | 筛选用取值；缺省同 getter/prop |
|
|
459
489
|
| `editable` | `boolean \| (row) => boolean` | 是否可编辑 |
|
|
460
490
|
| `resizable` | `boolean` | 是否允许拖拽调整列宽；缺省继承 Grid `resizable`（默认 true） |
|
|
@@ -553,6 +583,321 @@ interface RowSelectionConfig {
|
|
|
553
583
|
|
|
554
584
|
---
|
|
555
585
|
|
|
586
|
+
## Options 类型参考
|
|
587
|
+
|
|
588
|
+
下列类型均可从 `@taocompany/magic-grid` 导入，供 Props、GridApi 与事件 payload 使用。
|
|
589
|
+
|
|
590
|
+
### IndexColumnOptions
|
|
591
|
+
|
|
592
|
+
索引列配置，通过 `indexColumn` prop 传入（`showIndexColumn=true` 时生效）。
|
|
593
|
+
|
|
594
|
+
| 字段 | 类型 | 默认值 | 说明 |
|
|
595
|
+
|------|------|--------|------|
|
|
596
|
+
| `label` | `string` | `''` | 表头文案 |
|
|
597
|
+
| `width` | `number` | `40` | 列宽 px（最小 40） |
|
|
598
|
+
| `start` | `number` | `1` | 起始序号（1-based 展示 = rowIndex + start） |
|
|
599
|
+
| `focusMode` | `'single' \| 'multiple'` | `'multiple'` | 辅助定位模式 |
|
|
600
|
+
| `syncToSelectionColumn` | `boolean` | core `false` / MagicGrid `true` | 索引列定位单向同步到行选择列 |
|
|
601
|
+
| `index` | `(rowIndex) => number \| string` | — | 自定义序号展示 |
|
|
602
|
+
| `showRowDragHandle` | `boolean` | `false` | 在索引列显示行拖拽把柄 |
|
|
603
|
+
| `enableRowResizer` | `boolean` | `false` | 索引列底边可拖拽调整行高 |
|
|
604
|
+
| `headerAlign` / `headerValign` / `align` / `valign` / `footerAlign` / `footerValign` | 对齐枚举 | `'center'` | 对齐配置 |
|
|
605
|
+
|
|
606
|
+
### SelectionColumnOptions
|
|
607
|
+
|
|
608
|
+
行选择列配置，通过 `selectionColumn` prop 传入（`rowSelection !== false` 时生效）。
|
|
609
|
+
|
|
610
|
+
| 字段 | 类型 | 默认值 | 说明 |
|
|
611
|
+
|------|------|--------|------|
|
|
612
|
+
| `width` | `number` | `40` | 列宽 px（最小 40） |
|
|
613
|
+
| `selectAllLabel` | `string` | `'全选'` | 表头全选 checkbox 的 aria-label |
|
|
614
|
+
| `rowLabel` | `(rowIndex) => string` | — | 行 checkbox 的 aria-label 工厂 |
|
|
615
|
+
| `headerAlign` / `headerValign` / `align` / `valign` / `footerAlign` / `footerValign` | 对齐枚举 | `'center'` | 对齐配置 |
|
|
616
|
+
|
|
617
|
+
### RowSelectionConfig
|
|
618
|
+
|
|
619
|
+
`rowSelection` 的对象形式：
|
|
620
|
+
|
|
621
|
+
```ts
|
|
622
|
+
interface RowSelectionConfig {
|
|
623
|
+
mode: 'single' | 'multiple'
|
|
624
|
+
/** tree 模式下选中父节点是否级联子孙，默认 true */
|
|
625
|
+
groupSelectsChildren?: boolean
|
|
626
|
+
}
|
|
627
|
+
```
|
|
628
|
+
|
|
629
|
+
### CellSelectionOptions
|
|
630
|
+
|
|
631
|
+
`cellSelection` 的对象形式（`cellSelection: true` 等价 `{}` 并使用默认子项）。
|
|
632
|
+
|
|
633
|
+
| 字段 | 类型 | 默认值 | 说明 |
|
|
634
|
+
|------|------|--------|------|
|
|
635
|
+
| `suppressMultiRanges` | `boolean` | `true` | 仅允许单个 range |
|
|
636
|
+
| `enableColumnSelection` | `boolean` | MagicGrid `true` / Grid API `false` | 点击表头选中整列 |
|
|
637
|
+
| `handle` | `FillHandleOptions \| RangeHandleOptions` | — | Fill / Range 拖拽柄；缺省 off |
|
|
638
|
+
|
|
639
|
+
**FillHandleOptions**（`mode: 'fill'`）：
|
|
640
|
+
|
|
641
|
+
| 字段 | 类型 | 默认值 | 说明 |
|
|
642
|
+
|------|------|--------|------|
|
|
643
|
+
| `direction` | `'x' \| 'y' \| 'xy'` | `'xy'` | 填充方向 |
|
|
644
|
+
| `fillStrategy` | `'auto' \| 'copy'` | `'copy'` | 数字递增策略 |
|
|
645
|
+
| `fillReverseStrategy` | `'default' \| 'clear'` | `'default'` | 反拖缩小行为 |
|
|
646
|
+
| `setFillValue` | `(params: FillOperationParams) => unknown` | — | 自定义填充值 |
|
|
647
|
+
|
|
648
|
+
`FillOperationParams`：`{ rowNode, column, baseValue, step, direction }`。
|
|
649
|
+
|
|
650
|
+
**RangeHandleOptions**：`{ mode: 'range' }`，右下角拖拽扩展选区。
|
|
651
|
+
|
|
652
|
+
**CellRange**（`addCellRange` / `getCellRanges` 返回值）：
|
|
653
|
+
|
|
654
|
+
```ts
|
|
655
|
+
interface CellRange {
|
|
656
|
+
startRowIndex: number
|
|
657
|
+
endRowIndex: number
|
|
658
|
+
startColId: string
|
|
659
|
+
endColId: string
|
|
660
|
+
}
|
|
661
|
+
```
|
|
662
|
+
|
|
663
|
+
### AutoSizeStrategy
|
|
664
|
+
|
|
665
|
+
挂载 / 首屏列宽策略，通过 `autoSizeStrategy` prop 传入。三种 discriminated union：
|
|
666
|
+
|
|
667
|
+
**fitGridWidth** — 列宽分配至视口：
|
|
668
|
+
|
|
669
|
+
```ts
|
|
670
|
+
interface SizeColumnsToFitGridStrategy {
|
|
671
|
+
type: 'fitGridWidth'
|
|
672
|
+
defaultMinWidth?: number
|
|
673
|
+
defaultMaxWidth?: number
|
|
674
|
+
columnLimits?: Array<{ colId: string; minWidth?: number; maxWidth?: number }>
|
|
675
|
+
}
|
|
676
|
+
```
|
|
677
|
+
|
|
678
|
+
**fitProvidedWidth** — 分配至指定宽度：
|
|
679
|
+
|
|
680
|
+
```ts
|
|
681
|
+
interface SizeColumnsToFitProvidedWidthStrategy {
|
|
682
|
+
type: 'fitProvidedWidth'
|
|
683
|
+
width: number
|
|
684
|
+
defaultMinWidth?: number
|
|
685
|
+
defaultMaxWidth?: number
|
|
686
|
+
columnLimits?: Array<{ colId: string; minWidth?: number; maxWidth?: number }>
|
|
687
|
+
}
|
|
688
|
+
```
|
|
689
|
+
|
|
690
|
+
**fitCellContents** — 按单元格内容 auto-size：
|
|
691
|
+
|
|
692
|
+
```ts
|
|
693
|
+
interface SizeColumnsToContentStrategy {
|
|
694
|
+
type: 'fitCellContents'
|
|
695
|
+
skipHeader?: boolean
|
|
696
|
+
colIds?: readonly string[]
|
|
697
|
+
defaultMinWidth?: number
|
|
698
|
+
defaultMaxWidth?: number
|
|
699
|
+
columnLimits?: Array<{ colId: string; minWidth?: number; maxWidth?: number }>
|
|
700
|
+
scaleUpToFitGridWidth?: boolean
|
|
701
|
+
}
|
|
702
|
+
```
|
|
703
|
+
|
|
704
|
+
**SizeColumnsToFitParams**（`GridApi.sizeColumnsToFit(params?)`）：
|
|
705
|
+
|
|
706
|
+
| 字段 | 类型 | 说明 |
|
|
707
|
+
|------|------|------|
|
|
708
|
+
| `gridWidth` | `number` | 目标宽度 px；缺省为视口宽度 |
|
|
709
|
+
| `defaultMinWidth` / `defaultMaxWidth` | `number` | 列宽 clamp 默认值 |
|
|
710
|
+
| `columnLimits` | `{ colId, minWidth?, maxWidth? }[]` | 单列限制 |
|
|
711
|
+
| `colIds` | `string[]` | 仅调整指定列 |
|
|
712
|
+
| `onlyScaleUp` | `boolean` | 仅放大以填满视口，不缩小 |
|
|
713
|
+
|
|
714
|
+
### FilterParams
|
|
715
|
+
|
|
716
|
+
列级筛选参数，通过 `ColumnDef.filterParams` 传入。
|
|
717
|
+
|
|
718
|
+
| 字段 | 类型 | 默认值 | 说明 |
|
|
719
|
+
|------|------|--------|------|
|
|
720
|
+
| `caseSensitive` | `boolean` | `true` | 文本比较是否区分大小写 |
|
|
721
|
+
| `locale` | `string` | — | 数字 / 日期解析 locale |
|
|
722
|
+
|
|
723
|
+
### AsyncRowMutationHandlers
|
|
724
|
+
|
|
725
|
+
异步行 CRUD 持久化钩子，通过 `asyncRowMutation` prop 传入。各 handler 在服务端成功后才 apply 本地；reject 则不写入。
|
|
726
|
+
|
|
727
|
+
```ts
|
|
728
|
+
interface AsyncRowMutationHandlers {
|
|
729
|
+
add?: (params: AsyncRowMutationAddParams) => Promise<AsyncRowMutationAddResult | void>
|
|
730
|
+
update?: (params: AsyncRowMutationUpdateParams) => Promise<void>
|
|
731
|
+
remove?: (params: AsyncRowMutationRemoveParams) => Promise<void>
|
|
732
|
+
}
|
|
733
|
+
```
|
|
734
|
+
|
|
735
|
+
| Params 类型 | 主要字段 |
|
|
736
|
+
|-------------|----------|
|
|
737
|
+
| `AsyncRowMutationAddParams` | `rows: { data }[]`、`index?`、`indexMode?`、`signal` |
|
|
738
|
+
| `AsyncRowMutationAddResult` | `rows?: { businessId?, data? }[]` — 写入正式主键或 enrich 字段 |
|
|
739
|
+
| `AsyncRowMutationUpdateParams` | `rows: { rowId, data }[]`、`signal` |
|
|
740
|
+
| `AsyncRowMutationRemoveParams` | `rowIds`、`rows: { rowId, data }[]`、`signal` |
|
|
741
|
+
|
|
742
|
+
### CellCommentsDataSource
|
|
743
|
+
|
|
744
|
+
批注持久化数据源，通过 `cellCommentsDataSource` prop 传入。
|
|
745
|
+
|
|
746
|
+
```ts
|
|
747
|
+
interface CellCommentsDataSource {
|
|
748
|
+
getComment: (params: CellCommentParams) => CellComment | undefined | null
|
|
749
|
+
setComment: (params: SetCellCommentParams) => void | Promise<void>
|
|
750
|
+
init?: (ctx: { api: GridApi }) => void
|
|
751
|
+
destroy?: () => void
|
|
752
|
+
}
|
|
753
|
+
```
|
|
754
|
+
|
|
755
|
+
**CellCommentParams**：`{ rowId, colId, data, column }`。
|
|
756
|
+
|
|
757
|
+
**SetCellCommentParams**：扩展 `CellCommentParams`，含 `comment: CellComment | undefined`（`undefined` 表示删除）。
|
|
758
|
+
|
|
759
|
+
**CellComment**：
|
|
760
|
+
|
|
761
|
+
| 字段 | 类型 | 说明 |
|
|
762
|
+
|------|------|------|
|
|
763
|
+
| `text` | `string` | 批注正文（纯文本） |
|
|
764
|
+
| `readOnly` | `boolean` | `true` 时内置 UI 只读；API 仍可覆盖 |
|
|
765
|
+
| `author` / `createdAt` / `updatedAt` | `string` | 元数据 |
|
|
766
|
+
| `metadata` | `unknown` | 自定义扩展 |
|
|
767
|
+
|
|
768
|
+
### GetDataOptions
|
|
769
|
+
|
|
770
|
+
`GridApi.getData(options?)` / `MagicGridExpose.getData(options?)` 参数：
|
|
771
|
+
|
|
772
|
+
| 字段 | 类型 | 默认值 | 说明 |
|
|
773
|
+
|------|------|--------|------|
|
|
774
|
+
| `sourceOrder` | `boolean` | `true` | `true` = source 存储顺序；`false` = 当前 display 顺序 |
|
|
775
|
+
|
|
776
|
+
### AddRowsOptions / RemoveRowsOptions / PromoteRowIdOptions
|
|
777
|
+
|
|
778
|
+
GridApi 行 CRUD 参数：
|
|
779
|
+
|
|
780
|
+
**AddRowsOptions**：
|
|
781
|
+
|
|
782
|
+
| 字段 | 类型 | 默认值 | 说明 |
|
|
783
|
+
|------|------|--------|------|
|
|
784
|
+
| `rows` | `{ data: RowData }[]` | — | **必填** |
|
|
785
|
+
| `index` | `number` | 末尾 | 插入起始下标 |
|
|
786
|
+
| `indexMode` | `'source' \| 'display'` | `'source'` | 下标基准 |
|
|
787
|
+
|
|
788
|
+
**RemoveRowsOptions**：
|
|
789
|
+
|
|
790
|
+
| 字段 | 类型 | 说明 |
|
|
791
|
+
|------|------|------|
|
|
792
|
+
| `rowIds` | `(string \| number)[]` | 按 rowId / 业务主键删除 |
|
|
793
|
+
| `indexes` | `number[]` | 按下标批量删除 |
|
|
794
|
+
| `indexMode` | `'source' \| 'display'` | 下标基准，默认 `'source'` |
|
|
795
|
+
|
|
796
|
+
**PromoteRowIdOptions**：
|
|
797
|
+
|
|
798
|
+
| 字段 | 类型 | 说明 |
|
|
799
|
+
|------|------|------|
|
|
800
|
+
| `rowId` | `string \| number` | 当前 RowNode.id（通常为 `__mg_tmp_*`） |
|
|
801
|
+
| `businessId` | `string \| number` | 正式业务主键，写入 `data[rowKey]` |
|
|
802
|
+
|
|
803
|
+
### ValidateGridOptions / ValidateRowsOptions / ValidateCellsOptions
|
|
804
|
+
|
|
805
|
+
GridApi 校验参数：
|
|
806
|
+
|
|
807
|
+
**ValidateGridOptions**（`validate(options?)`）：
|
|
808
|
+
|
|
809
|
+
| 字段 | 类型 | 默认值 | 说明 |
|
|
810
|
+
|------|------|--------|------|
|
|
811
|
+
| `rowIds` | `(string \| number)[]` | 全表 | 指定行 |
|
|
812
|
+
| `signal` | `AbortSignal` | — | 中断信号 |
|
|
813
|
+
| `showFeedback` | `boolean` | `true` | 是否更新 invalid 视觉反馈 |
|
|
814
|
+
|
|
815
|
+
**ValidateRowsOptions**（`validateRows(options)`）：`rowIds` **必填**，其余同 `ValidateGridOptions`。
|
|
816
|
+
|
|
817
|
+
**ValidateCellsOptions**（`validateCells(options)`）：
|
|
818
|
+
|
|
819
|
+
| 字段 | 类型 | 说明 |
|
|
820
|
+
|------|------|------|
|
|
821
|
+
| `cells` | `{ rowId, colId }[]` | **必填** |
|
|
822
|
+
| `signal` | `AbortSignal` | 中断信号 |
|
|
823
|
+
| `showFeedback` | `boolean` | 默认 `true` |
|
|
824
|
+
|
|
825
|
+
**ClearValidationOptions** / **ClearRowValidationOptions** / **ClearCellValidationOptions**：分别对应 `clearValidation` / `clearRowValidation` / `clearCellValidation`，字段与上述 `rowIds` / `cells` 对应。
|
|
826
|
+
|
|
827
|
+
### MoveRowOptions / RefreshCellsParams
|
|
828
|
+
|
|
829
|
+
**MoveRowOptions**（`GridApi.moveRow(rowId, toIndex, indexMode?)` 的对象重载形式）：
|
|
830
|
+
|
|
831
|
+
| 字段 | 类型 | 默认值 | 说明 |
|
|
832
|
+
|------|------|--------|------|
|
|
833
|
+
| `rowId` | `string` | — | **必填**。内部 rowId |
|
|
834
|
+
| `toIndex` | `number` | — | **必填**。目标下标 |
|
|
835
|
+
| `indexMode` | `'source' \| 'display'` | `'source'` | 下标基准 |
|
|
836
|
+
| `finished` | `boolean` | `true` | live drag 中间态为 `false` |
|
|
837
|
+
|
|
838
|
+
**RefreshCellsParams**（`GridApi.refreshCells(params?)`）：
|
|
839
|
+
|
|
840
|
+
| 字段 | 类型 | 说明 |
|
|
841
|
+
|------|------|------|
|
|
842
|
+
| `rowIds` | `string[]` | 限定行 |
|
|
843
|
+
| `colIds` | `string[]` | 限定列 |
|
|
844
|
+
| `force` | `boolean` | 忽略值缓存，强制重绘 |
|
|
845
|
+
|
|
846
|
+
**RefreshDisabledStateParams** / **RefreshCellStylesParams**（`refreshDisabledState` / `refreshCellStyles`）：可选 `rowIds`、`colIds` 限定重算范围。
|
|
847
|
+
|
|
848
|
+
### StatusBarRangeAggregationPrecisionInput
|
|
849
|
+
|
|
850
|
+
`statusBarRangeAggregationPrecision` prop 类型：
|
|
851
|
+
|
|
852
|
+
```ts
|
|
853
|
+
type StatusBarRangeAggregationPrecisionInput =
|
|
854
|
+
| number // 同时作用于 average / sum
|
|
855
|
+
| { average?: number; sum?: number } // 分别指定
|
|
856
|
+
```
|
|
857
|
+
|
|
858
|
+
默认 `2`（平均值与求和各保留 2 位小数）。
|
|
859
|
+
|
|
860
|
+
### SummaryMethodParams
|
|
861
|
+
|
|
862
|
+
`summaryMethod` 回调入参：
|
|
863
|
+
|
|
864
|
+
| 字段 | 类型 | 说明 |
|
|
865
|
+
|------|------|------|
|
|
866
|
+
| `columns` | `Column[]` | 当前列模型 |
|
|
867
|
+
| `data` | `RowData[]` | 按 `summaryScope` 选取的行快照 |
|
|
868
|
+
| `rows` | `RowNode[]` | 对应 RowNode 列表 |
|
|
869
|
+
|
|
870
|
+
返回值：`Record<colId, string | number | null | undefined>`。
|
|
871
|
+
|
|
872
|
+
### CellSelectionAggregation
|
|
873
|
+
|
|
874
|
+
`getCellSelectionAggregation()` 与状态栏 `#status-bar` 插槽的 `cellSelectionAggregation` 字段：
|
|
875
|
+
|
|
876
|
+
| 字段 | 类型 | 说明 |
|
|
877
|
+
|------|------|------|
|
|
878
|
+
| `count` | `number` | 非空单元格个数（含非数值） |
|
|
879
|
+
| `numericCount` | `number` | 可解析为数值的单元格个数 |
|
|
880
|
+
| `sum` | `number \| null` | 数值之和；无有效数值时为 `null` |
|
|
881
|
+
| `average` | `number \| null` | 数值平均值；无有效数值时为 `null` |
|
|
882
|
+
|
|
883
|
+
### 剪贴板回调参数
|
|
884
|
+
|
|
885
|
+
**ProcessCellForClipboardParams** / **ProcessCellFromClipboardParams**：
|
|
886
|
+
|
|
887
|
+
| 字段 | 类型 | 说明 |
|
|
888
|
+
|------|------|------|
|
|
889
|
+
| `rowIndex` / `colId` | `number` / `string` | 格位置 |
|
|
890
|
+
| `rowNode` / `column` | — | 行 / 列模型 |
|
|
891
|
+
| `value` | `unknown` | 复制：formatter/raw 候选；粘贴：clipboard 字符串 |
|
|
892
|
+
| `formatValue` | `(value) => string` | 套列 formatter |
|
|
893
|
+
| `parseValue` | `(text) => unknown` | 走 valueParser |
|
|
894
|
+
|
|
895
|
+
`ProcessCellFromClipboardParams` 额外含 `oldValue`。
|
|
896
|
+
|
|
897
|
+
**ProcessDataFromClipboardParams**：`{ data: string[][], anchor: CellPosition }`，其中 `anchor` 为 `{ rowIndex, colId }`。
|
|
898
|
+
|
|
899
|
+
---
|
|
900
|
+
|
|
556
901
|
## Events
|
|
557
902
|
|
|
558
903
|
MagicGrid 通过 Vue 事件向外暴露 Grid 内核事件。事件名采用 kebab-case。
|
|
@@ -1393,6 +1738,7 @@ import type { ColumnSettingsMenuIconName } from '@taocompany/magic-grid'
|
|
|
1393
1738
|
| [`docs/README.md`](docs/README.md) | 内部设计文档索引（架构、里程碑、AG Grid 对照） |
|
|
1394
1739
|
| [`docs/16-grid-api-reference.md`](docs/16-grid-api-reference.md) | GridApi 完整参考 |
|
|
1395
1740
|
| [`docs/07-third-party-cell-editor-guide.md`](docs/07-third-party-cell-editor-guide.md) | 第三方编辑器接入（Element Plus 等） |
|
|
1741
|
+
| [`docs/35-phase24-cell-range-selection.md`](docs/35-phase24-cell-range-selection.md) | 单元格框选与剪贴板（Phase 24） |
|
|
1396
1742
|
| [`docs/39-phase27-table-settings-button.md`](docs/39-phase27-table-settings-button.md) | 列设置按钮设计文档（Phase 27） |
|
|
1397
1743
|
|
|
1398
1744
|
### 校验子路径
|
|
@@ -475,6 +475,7 @@ declare const __VLS_base: import('vue').DefineComponent<import('vue').ExtractPro
|
|
|
475
475
|
type: NumberConstructor;
|
|
476
476
|
default: undefined;
|
|
477
477
|
};
|
|
478
|
+
/** Phase 24 · 单元格框选；默认 true（含 enableColumnSelection），handle 默认 off（无 Fill/Range 手柄） */
|
|
478
479
|
cellSelection: {
|
|
479
480
|
type: PropType<boolean | CellSelectionOptions>;
|
|
480
481
|
default: boolean;
|
|
@@ -483,6 +484,14 @@ declare const __VLS_base: import('vue').DefineComponent<import('vue').ExtractPro
|
|
|
483
484
|
type: BooleanConstructor;
|
|
484
485
|
default: undefined;
|
|
485
486
|
};
|
|
487
|
+
enableCellCopy: {
|
|
488
|
+
type: BooleanConstructor;
|
|
489
|
+
default: undefined;
|
|
490
|
+
};
|
|
491
|
+
enableCellPaste: {
|
|
492
|
+
type: BooleanConstructor;
|
|
493
|
+
default: undefined;
|
|
494
|
+
};
|
|
486
495
|
enableHeaderHighlight: {
|
|
487
496
|
type: BooleanConstructor;
|
|
488
497
|
default: boolean;
|
|
@@ -1087,6 +1096,7 @@ declare const __VLS_base: import('vue').DefineComponent<import('vue').ExtractPro
|
|
|
1087
1096
|
type: NumberConstructor;
|
|
1088
1097
|
default: undefined;
|
|
1089
1098
|
};
|
|
1099
|
+
/** Phase 24 · 单元格框选；默认 true（含 enableColumnSelection），handle 默认 off（无 Fill/Range 手柄） */
|
|
1090
1100
|
cellSelection: {
|
|
1091
1101
|
type: PropType<boolean | CellSelectionOptions>;
|
|
1092
1102
|
default: boolean;
|
|
@@ -1095,6 +1105,14 @@ declare const __VLS_base: import('vue').DefineComponent<import('vue').ExtractPro
|
|
|
1095
1105
|
type: BooleanConstructor;
|
|
1096
1106
|
default: undefined;
|
|
1097
1107
|
};
|
|
1108
|
+
enableCellCopy: {
|
|
1109
|
+
type: BooleanConstructor;
|
|
1110
|
+
default: undefined;
|
|
1111
|
+
};
|
|
1112
|
+
enableCellPaste: {
|
|
1113
|
+
type: BooleanConstructor;
|
|
1114
|
+
default: undefined;
|
|
1115
|
+
};
|
|
1098
1116
|
enableHeaderHighlight: {
|
|
1099
1117
|
type: BooleanConstructor;
|
|
1100
1118
|
default: boolean;
|
|
@@ -1293,6 +1311,8 @@ declare const __VLS_base: import('vue').DefineComponent<import('vue').ExtractPro
|
|
|
1293
1311
|
tooltipComponentParams: Record<string, unknown>;
|
|
1294
1312
|
cellSelection: boolean | CellSelectionOptions;
|
|
1295
1313
|
enableCellClipboard: boolean;
|
|
1314
|
+
enableCellCopy: boolean;
|
|
1315
|
+
enableCellPaste: boolean;
|
|
1296
1316
|
enableHeaderHighlight: boolean;
|
|
1297
1317
|
enableIndexColumnHighlight: boolean;
|
|
1298
1318
|
height: string | number;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"MagicGrid.vue.d.ts","sourceRoot":"","sources":["../../../src/components/MagicGrid/MagicGrid.vue"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"MagicGrid.vue.d.ts","sourceRoot":"","sources":["../../../src/components/MagicGrid/MagicGrid.vue"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
import { CellSelectionOptions } from '../../core/types/cellRangeSelection';
|
|
2
|
+
import { IndexColumnOptions } from '../../core/types/indexColumn';
|
|
3
|
+
/** MagicGrid 组件层 cellSelection 默认：enableColumnSelection true、handle off；Grid API 直连走 core 默认 */
|
|
4
|
+
export declare function resolveMagicGridCellSelectionInput(cellSelection: boolean | CellSelectionOptions | undefined): boolean | CellSelectionOptions;
|
|
5
|
+
/** MagicGrid 组件层 indexColumn 默认值（Grid API 直连仍走 core 默认） */
|
|
6
|
+
export declare function resolveMagicGridIndexColumnOptions(indexColumn: IndexColumnOptions | undefined): IndexColumnOptions;
|
|
7
|
+
//# sourceMappingURL=resolveMagicGridDefaults.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"resolveMagicGridDefaults.d.ts","sourceRoot":"","sources":["../../../src/components/MagicGrid/resolveMagicGridDefaults.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,oBAAoB,EACrB,MAAM,gCAAgC,CAAA;AACvC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAgCjE,gGAAgG;AAChG,wBAAgB,kCAAkC,CAChD,aAAa,EAAE,OAAO,GAAG,oBAAoB,GAAG,SAAS,GACxD,OAAO,GAAG,oBAAoB,CAahC;AAED,2DAA2D;AAC3D,wBAAgB,kCAAkC,CAChD,WAAW,EAAE,kBAAkB,GAAG,SAAS,GAC1C,kBAAkB,CAKpB"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"cellRangeDragSelect.d.ts","sourceRoot":"","sources":["../../../src/core/grid/cellRangeDragSelect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AAG3D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAA;AAY3E,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAA;AAE9D,wBAAgB,uCAAuC,CACrD,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,EACtB,SAAS,EAAE,MAAM,GAChB,MAAM,CAER;AAED,wBAAgB,yCAAyC,CACvD,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,EACpB,aAAa,EAAE,MAAM,GACpB,MAAM,CAER;AAED,wBAAgB,uCAAuC,CACrD,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,GACrB,OAAO,CAET;AAED,wBAAgB,yCAAyC,CACvD,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,EACpB,aAAa,EAAE,MAAM,GACpB,OAAO,CAET;AAED,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,eAAe,GAC5B,OAAO,CAKT;AAMD,0EAA0E;AAC1E,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,eAAe,EAC7B,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,mBAAmB,GAAG,oBAAoB,CAAC,EAC1E,mBAAmB,EAAE,MAAM,GAC1B,oBAAoB,CAkBtB;
|
|
1
|
+
{"version":3,"file":"cellRangeDragSelect.d.ts","sourceRoot":"","sources":["../../../src/core/grid/cellRangeDragSelect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AAG3D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAA;AAY3E,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAA;AAE9D,wBAAgB,uCAAuC,CACrD,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,EACtB,SAAS,EAAE,MAAM,GAChB,MAAM,CAER;AAED,wBAAgB,yCAAyC,CACvD,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,EACpB,aAAa,EAAE,MAAM,GACpB,MAAM,CAER;AAED,wBAAgB,uCAAuC,CACrD,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,GACrB,OAAO,CAET;AAED,wBAAgB,yCAAyC,CACvD,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,EACpB,aAAa,EAAE,MAAM,GACpB,OAAO,CAET;AAED,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,eAAe,GAC5B,OAAO,CAKT;AAMD,0EAA0E;AAC1E,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,eAAe,EAC7B,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,mBAAmB,GAAG,oBAAoB,CAAC,EAC1E,mBAAmB,EAAE,MAAM,GAC1B,oBAAoB,CAkBtB;AA2FD,uDAAuD;AACvD,wBAAgB,gCAAgC,CAC9C,WAAW,EAAE,WAAW,EACxB,UAAU,EAAE,WAAW,EACvB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,GACjB,MAAM,GAAG,IAAI,CAmEf;AAED,qDAAqD;AACrD,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,kBAAkB,EAC5B,WAAW,EAAE,WAAW,EACxB,UAAU,EAAE,WAAW,EACvB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,mBAAmB,EAAE,MAAM,MAAM,EACjC,aAAa,EAAE,MAAM,MAAM,GAC1B,mBAAmB,GAAG,IAAI,CAgC5B"}
|
package/dist/core/grid/grid.d.ts
CHANGED
|
@@ -300,7 +300,7 @@ export declare class Grid {
|
|
|
300
300
|
/** Phase 24 · 运行时更新选区高亮选项（Vue props watch） */
|
|
301
301
|
updateCellRangeVisualOptions(options: CellRangeVisualGridOptions): void;
|
|
302
302
|
/** Phase 24 · 运行时更新框选选项（Vue props watch） */
|
|
303
|
-
updateCellSelectionOptions(options: Pick<CellRangeSelectionGridOptions, 'cellSelection' | 'enableCellClipboard'>): void;
|
|
303
|
+
updateCellSelectionOptions(options: Pick<CellRangeSelectionGridOptions, 'cellSelection' | 'enableCellClipboard' | 'enableCellCopy' | 'enableCellPaste'>): void;
|
|
304
304
|
/** Phase 24 · 运行时更新剪贴板回调（Vue props watch） */
|
|
305
305
|
updateCellClipboardOptions(options: CellClipboardGridOptions): void;
|
|
306
306
|
private createCellRangeVisualController;
|