@veltra/sheet 4.1.1 → 4.1.3
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/dist/components/sheet/formula-bar.js +95 -11
- package/dist/components/sheet/sheet.js +5 -3
- package/dist/components/sheet/use-formula-ref-select.js +11 -3
- package/dist/components/sheet/use-sheet-grid.js +11 -3
- package/dist/components/sheet/use-sheet-state.js +1 -1
- package/dist/index.js +1 -2
- package/dist/tools/builtin.js +307 -305
- package/dist/tools/registry.d.ts +3 -1
- package/dist/tools/registry.js +7 -2
- package/package.json +4 -8
- package/src/components/sheet/__test__/canvas-mock.ts +3 -1
- package/src/components/sheet/__test__/find-shortcut-anchor.test.ts +2 -0
- package/src/components/sheet/__test__/formula-bar.test.ts +205 -0
- package/src/components/sheet/__test__/formula-capability.test.ts +2 -0
- package/src/components/sheet/__test__/functions-popup.test.ts +2 -0
- package/src/components/sheet/__test__/hyperlink-popup.test.ts +2 -0
- package/src/components/sheet/__test__/import-file.test.ts +2 -0
- package/src/components/sheet/__test__/insert-count-menu-item.test.ts +2 -0
- package/src/components/sheet/__test__/insert-image-popup.test.ts +2 -0
- package/src/components/sheet/__test__/insert-image.test.ts +2 -0
- package/src/components/sheet/__test__/sheet-component.test.ts +4 -1
- package/src/components/sheet/__test__/sheet-grow-on-scroll.test.ts +2 -0
- package/src/components/sheet/__test__/sheet-scrollbar.test.ts +2 -0
- package/src/components/sheet/__test__/sheet-theme.test.ts +2 -0
- package/src/components/sheet/__test__/use-formula-ref-select.test.ts +12 -1
- package/src/components/sheet/formula-bar.vue +106 -14
- package/src/components/sheet/sheet.vue +28 -26
- package/src/components/sheet/use-formula-ref-select.ts +13 -0
- package/src/components/sheet/use-sheet-grid.ts +26 -7
- package/src/index.ts +1 -3
- package/src/tools/__test__/builtin.test.ts +2 -2
- package/src/tools/builtin.ts +345 -344
- package/src/tools/registry.ts +8 -2
- package/src/tools/index.ts +0 -3
package/dist/tools/registry.js
CHANGED
|
@@ -1,3 +1,4 @@
|
|
|
1
|
+
import { BUILTIN_TOOLS } from "./builtin.js";
|
|
1
2
|
import { TypedEventEmitter } from "infinitable/sheet";
|
|
2
3
|
//#region src/tools/registry.ts
|
|
3
4
|
/** 缺省分组名 */
|
|
@@ -6,6 +7,10 @@ var ToolRegistry = class {
|
|
|
6
7
|
entries = /* @__PURE__ */ new Map();
|
|
7
8
|
seq = 0;
|
|
8
9
|
emitter = new TypedEventEmitter();
|
|
10
|
+
/** 装入初始工具(仍经 register 校验);缺省空表 */
|
|
11
|
+
constructor(tools = []) {
|
|
12
|
+
for (const tool of tools) this.register(tool);
|
|
13
|
+
}
|
|
9
14
|
/** 注册工具;同 id 重复注册 = 替换定义并保留原注册位置 */
|
|
10
15
|
register(tool) {
|
|
11
16
|
if (!tool.id) throw new Error("工具注册失败:id 不能为空");
|
|
@@ -59,10 +64,10 @@ var ToolRegistry = class {
|
|
|
59
64
|
}
|
|
60
65
|
};
|
|
61
66
|
/**
|
|
62
|
-
* 全局默认注册表(USheet
|
|
67
|
+
* 全局默认注册表(USheet 默认渲染这里的工具;内置工具在构造时装入)。
|
|
63
68
|
* 工具是应用级扩展:注册一次,所有 USheet 实例共享。
|
|
64
69
|
*/
|
|
65
|
-
const defaultToolRegistry = new ToolRegistry();
|
|
70
|
+
const defaultToolRegistry = new ToolRegistry(BUILTIN_TOOLS);
|
|
66
71
|
/** 注册工具到默认注册表 */
|
|
67
72
|
function registerTool(tool) {
|
|
68
73
|
defaultToolRegistry.register(tool);
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@veltra/sheet",
|
|
3
|
-
"version": "4.1.
|
|
3
|
+
"version": "4.1.3",
|
|
4
4
|
"homepage": "https://github.com/cabinet-fe/ultra-ui#readme",
|
|
5
5
|
"bugs": {
|
|
6
6
|
"url": "https://github.com/cabinet-fe/ultra-ui/issues"
|
|
@@ -18,10 +18,8 @@
|
|
|
18
18
|
"sideEffects": [
|
|
19
19
|
"src/**/style.ts",
|
|
20
20
|
"src/**/*.scss",
|
|
21
|
-
"src/tools/builtin.ts",
|
|
22
21
|
"dist/**/style.js",
|
|
23
|
-
"dist/**/*.css"
|
|
24
|
-
"dist/tools/builtin.js"
|
|
22
|
+
"dist/**/*.css"
|
|
25
23
|
],
|
|
26
24
|
"exports": {
|
|
27
25
|
".": {
|
|
@@ -33,9 +31,6 @@
|
|
|
33
31
|
"import": "./dist/*"
|
|
34
32
|
}
|
|
35
33
|
},
|
|
36
|
-
"dependencies": {
|
|
37
|
-
"infinitable": "^0.1.8"
|
|
38
|
-
},
|
|
39
34
|
"peerDependencies": {
|
|
40
35
|
"@cat-kit/core": ">=1.2.1",
|
|
41
36
|
"@cat-kit/fe": ">=1.2.1",
|
|
@@ -43,6 +38,7 @@
|
|
|
43
38
|
"@veltra/icons": "^1.5.0",
|
|
44
39
|
"@veltra/styles": "^1.7.14",
|
|
45
40
|
"@veltra/utils": "^1.7.14",
|
|
46
|
-
"
|
|
41
|
+
"infinitable": "^0.2.3",
|
|
42
|
+
"vue": ">=3.5.44"
|
|
47
43
|
}
|
|
48
44
|
}
|
|
@@ -33,8 +33,10 @@ function createContext2dMock(canvas: HTMLCanvasElement): Context2dMock {
|
|
|
33
33
|
})
|
|
34
34
|
}
|
|
35
35
|
|
|
36
|
-
/** 补丁 HTMLCanvasElement,使 getContext('2d') 返回可用 mock */
|
|
36
|
+
/** 补丁 HTMLCanvasElement,使 getContext('2d') 返回可用 mock;node 环境无该全局,直接跳过 */
|
|
37
37
|
export function setupCanvasMock(): void {
|
|
38
|
+
if (typeof HTMLCanvasElement === 'undefined') return
|
|
39
|
+
|
|
38
40
|
const getContext = function (this: HTMLCanvasElement, contextId: string): unknown {
|
|
39
41
|
if (contextId !== '2d') return null
|
|
40
42
|
return createContext2dMock(this)
|
|
@@ -1,3 +1,5 @@
|
|
|
1
|
+
// @vitest-environment happy-dom
|
|
2
|
+
|
|
1
3
|
import { parseRange } from 'infinitable/sheet'
|
|
2
4
|
import { Workbook } from 'infinitable/sheet'
|
|
3
5
|
import type { SheetGrid } from 'infinitable/sheet'
|
|
@@ -631,6 +633,78 @@ describe('USheet 公式栏:函数补全与引用选择', () => {
|
|
|
631
633
|
expect(fxInput(el).value).toBe('=A1+B1')
|
|
632
634
|
})
|
|
633
635
|
|
|
636
|
+
it('shift 扩展:替换上次插入的引用(extend 回交),连续扩展锚点不重置', async () => {
|
|
637
|
+
const sheet = new Workbook().activeSheet
|
|
638
|
+
const { el, exposed } = mountFormulaBar(sheet)
|
|
639
|
+
await nextTick()
|
|
640
|
+
sheet.selectCell({ row: 2, col: 0 })
|
|
641
|
+
await nextTick()
|
|
642
|
+
|
|
643
|
+
setFxText(el, '=SUM(')
|
|
644
|
+
await nextTick()
|
|
645
|
+
exposed.value!.handleRefSelect(parseRange('A1'))
|
|
646
|
+
await nextTick()
|
|
647
|
+
expect(fxInput(el).value).toBe('=SUM(A1')
|
|
648
|
+
// 插入后光标离开触发位(上下文断裂),拾取延续仍成立
|
|
649
|
+
expect(exposed.value!.hasRefInsert()).toBe(true)
|
|
650
|
+
|
|
651
|
+
// shift+点选扩展(引擎 extend 回交):A1 被替换为 A1:C3 而非追加
|
|
652
|
+
exposed.value!.handleRefSelect(parseRange('A1:C3'))
|
|
653
|
+
await nextTick()
|
|
654
|
+
expect(fxInput(el).value).toBe('=SUM(A1:C3')
|
|
655
|
+
expect(fxInput(el).selectionStart).toBe('=SUM(A1:C3'.length)
|
|
656
|
+
|
|
657
|
+
// 连续扩展:引擎锚点恒为首次拾取锚点,A1:C3 整体替换为 A1:D5
|
|
658
|
+
exposed.value!.handleRefSelect(parseRange('A1:D5'))
|
|
659
|
+
await nextTick()
|
|
660
|
+
expect(fxInput(el).value).toBe('=SUM(A1:D5')
|
|
661
|
+
})
|
|
662
|
+
|
|
663
|
+
it('shift 扩展无上次插入(无 extend 上下文)时按普通插入处理', async () => {
|
|
664
|
+
const sheet = new Workbook().activeSheet
|
|
665
|
+
const { el, exposed } = mountFormulaBar(sheet)
|
|
666
|
+
await nextTick()
|
|
667
|
+
sheet.selectCell({ row: 2, col: 0 })
|
|
668
|
+
await nextTick()
|
|
669
|
+
|
|
670
|
+
setFxText(el, '=SUM(')
|
|
671
|
+
await nextTick()
|
|
672
|
+
exposed.value!.handleRefSelect(parseRange('B2'))
|
|
673
|
+
await nextTick()
|
|
674
|
+
expect(fxInput(el).value).toBe('=SUM(B2')
|
|
675
|
+
})
|
|
676
|
+
|
|
677
|
+
it('用户手动输入 / 提交后引用拾取延续终止:extend 不再替换', async () => {
|
|
678
|
+
const sheet = new Workbook().activeSheet
|
|
679
|
+
const { el, exposed } = mountFormulaBar(sheet)
|
|
680
|
+
await nextTick()
|
|
681
|
+
sheet.selectCell({ row: 2, col: 0 })
|
|
682
|
+
await nextTick()
|
|
683
|
+
|
|
684
|
+
setFxText(el, '=SUM(')
|
|
685
|
+
await nextTick()
|
|
686
|
+
exposed.value!.handleRefSelect(parseRange('A1'))
|
|
687
|
+
await nextTick()
|
|
688
|
+
expect(exposed.value!.hasRefInsert()).toBe(true)
|
|
689
|
+
|
|
690
|
+
// 用户输入逗号(input 事件):延续状态清除,回到光标上下文判定
|
|
691
|
+
const input = fxInput(el)
|
|
692
|
+
input.value = '=SUM(A1,'
|
|
693
|
+
input.setSelectionRange(9, 9)
|
|
694
|
+
input.dispatchEvent(new Event('input', { bubbles: true }))
|
|
695
|
+
await nextTick()
|
|
696
|
+
expect(exposed.value!.hasRefInsert()).toBe(false)
|
|
697
|
+
exposed.value!.handleRefSelect(parseRange('B2'))
|
|
698
|
+
await nextTick()
|
|
699
|
+
// 光标在逗号后处于引用上下文 → 普通插入 B2,而非替换 A1
|
|
700
|
+
expect(fxInput(el).value).toBe('=SUM(A1,B2')
|
|
701
|
+
|
|
702
|
+
// Enter 提交:会话结束,延续状态随编辑态一并清除
|
|
703
|
+
input.dispatchEvent(new KeyboardEvent('keydown', { key: 'Enter', bubbles: true }))
|
|
704
|
+
await nextTick()
|
|
705
|
+
expect(exposed.value!.hasRefInsert()).toBe(false)
|
|
706
|
+
})
|
|
707
|
+
|
|
634
708
|
it('多行文本:默认保持单行高度,鼠标进入展开,移出后收起', async () => {
|
|
635
709
|
const workbook = new Workbook()
|
|
636
710
|
const sheet = workbook.activeSheet
|
|
@@ -661,6 +735,137 @@ describe('USheet 公式栏:函数补全与引用选择', () => {
|
|
|
661
735
|
})
|
|
662
736
|
})
|
|
663
737
|
|
|
738
|
+
describe('USheet 公式栏:Point mode 拾取会话(Excel 语义)', () => {
|
|
739
|
+
it('拾取会话中普通点选画布:替换上次引用、编辑不中断、blur 不提交;Enter 提交替换后公式', async () => {
|
|
740
|
+
const workbook = new Workbook()
|
|
741
|
+
const sheet = workbook.activeSheet
|
|
742
|
+
const exposed: { value: SheetExposed | undefined } = { value: undefined }
|
|
743
|
+
const { el } = mount(() => ({ workbook, rows: 20, cols: 8 }), exposed)
|
|
744
|
+
await nextTick()
|
|
745
|
+
sheet.selectCell({ row: 2, col: 0 })
|
|
746
|
+
await nextTick()
|
|
747
|
+
|
|
748
|
+
const input = setFxText(el, '=SUM(')
|
|
749
|
+
await nextTick()
|
|
750
|
+
|
|
751
|
+
// 首拾取 A4(引擎选区事件管线:pointerdown 起手 → pointerup 收敛回交)
|
|
752
|
+
const gridEl = gridEventTarget(el)
|
|
753
|
+
const pick = (x: number, y: number) => {
|
|
754
|
+
gridEl.dispatchEvent(
|
|
755
|
+
new PointerEvent('pointerdown', { clientX: x, clientY: y, bubbles: true })
|
|
756
|
+
)
|
|
757
|
+
gridEl.dispatchEvent(new PointerEvent('pointerup', { clientX: x, clientY: y, bubbles: true }))
|
|
758
|
+
}
|
|
759
|
+
pick(51, 117)
|
|
760
|
+
await nextTick()
|
|
761
|
+
expect(input.value).toBe('=SUM(A4')
|
|
762
|
+
|
|
763
|
+
// 普通点选 C3(画布几何:行号列 46、列头 28、列宽 80、行高 28)→ 替换 A4 而非追加
|
|
764
|
+
pick(211, 89)
|
|
765
|
+
await nextTick()
|
|
766
|
+
expect(input.value).toBe('=SUM(C3')
|
|
767
|
+
|
|
768
|
+
// 编辑未中断:模型未写入(真实 blur 已在第二次 pointerdown 时被挂起并消费)
|
|
769
|
+
expect(sheet.getCellData({ row: 2, col: 0 })).toBeUndefined()
|
|
770
|
+
expect(input.value).toBe('=SUM(C3')
|
|
771
|
+
|
|
772
|
+
// Enter 提交替换后的公式
|
|
773
|
+
input.dispatchEvent(new KeyboardEvent('keydown', { key: 'Enter', bubbles: true }))
|
|
774
|
+
await nextTick()
|
|
775
|
+
expect(sheet.getCellData({ row: 2, col: 0 })).toMatchObject({ f: 'SUM(C3' })
|
|
776
|
+
})
|
|
777
|
+
|
|
778
|
+
it('拾取会话中点选被编辑格自身:忽略不替换(防循环引用),会话延续', async () => {
|
|
779
|
+
const sheet = new Workbook().activeSheet
|
|
780
|
+
const { el, exposed } = mountFormulaBar(sheet)
|
|
781
|
+
await nextTick()
|
|
782
|
+
sheet.selectCell({ row: 2, col: 0 })
|
|
783
|
+
await nextTick()
|
|
784
|
+
|
|
785
|
+
setFxText(el, '=SUM(')
|
|
786
|
+
await nextTick()
|
|
787
|
+
exposed.value!.handleRefSelect(parseRange('A1'))
|
|
788
|
+
await nextTick()
|
|
789
|
+
expect(fxInput(el).value).toBe('=SUM(A1')
|
|
790
|
+
|
|
791
|
+
// 被编辑格 = A3:拾取视作无操作
|
|
792
|
+
exposed.value!.handleRefSelect(parseRange('A3'))
|
|
793
|
+
await nextTick()
|
|
794
|
+
expect(fxInput(el).value).toBe('=SUM(A1')
|
|
795
|
+
expect(exposed.value!.hasRefInsert()).toBe(true)
|
|
796
|
+
})
|
|
797
|
+
})
|
|
798
|
+
|
|
799
|
+
describe('USheet 公式栏:引用染色框(画布视觉反馈)', () => {
|
|
800
|
+
function mountFormulaBarWithHighlights(
|
|
801
|
+
sheet: Workbook['activeSheet'],
|
|
802
|
+
onHighlights: (items: { range: ReturnType<typeof parseRange>; color: string }[]) => void
|
|
803
|
+
) {
|
|
804
|
+
const el = document.createElement('div')
|
|
805
|
+
document.body.appendChild(el)
|
|
806
|
+
containers.push(el)
|
|
807
|
+
const exposed: { value: InstanceType<typeof UFormulaBar> | undefined } = { value: undefined }
|
|
808
|
+
const app = createApp({
|
|
809
|
+
render: () =>
|
|
810
|
+
h(UFormulaBar, {
|
|
811
|
+
sheet,
|
|
812
|
+
context: createSheetContext(sheet),
|
|
813
|
+
setRefHighlights: onHighlights,
|
|
814
|
+
ref: (value: unknown) => {
|
|
815
|
+
exposed.value = value as InstanceType<typeof UFormulaBar> | undefined
|
|
816
|
+
}
|
|
817
|
+
})
|
|
818
|
+
})
|
|
819
|
+
app.mount(el)
|
|
820
|
+
apps.push(app)
|
|
821
|
+
return { el, exposed }
|
|
822
|
+
}
|
|
823
|
+
|
|
824
|
+
it('公式编辑中按文本扫描逐引用上框(出现顺序循环取色);手输/拾取替换/会话结束同步', async () => {
|
|
825
|
+
const sheet = new Workbook().activeSheet
|
|
826
|
+
const highlights: { range: ReturnType<typeof parseRange>; color: string }[][] = []
|
|
827
|
+
const { el, exposed } = mountFormulaBarWithHighlights(sheet, (items) => highlights.push(items))
|
|
828
|
+
await nextTick()
|
|
829
|
+
sheet.selectCell({ row: 5, col: 5 })
|
|
830
|
+
await nextTick()
|
|
831
|
+
|
|
832
|
+
// 手输多引用:蓝 / 绿按出现顺序(B2:C4 → (1,1)-(3,2))
|
|
833
|
+
setFxText(el, '=SUM(A1,B2:C4)')
|
|
834
|
+
await nextTick()
|
|
835
|
+
expect(highlights.at(-1)).toEqual([
|
|
836
|
+
{ range: { start: { row: 0, col: 0 }, end: { row: 0, col: 0 } }, color: '#2563eb' },
|
|
837
|
+
{ range: { start: { row: 1, col: 1 }, end: { row: 3, col: 2 } }, color: '#16a34a' }
|
|
838
|
+
])
|
|
839
|
+
|
|
840
|
+
// 非公式文本:清除
|
|
841
|
+
setFxText(el, 'plain')
|
|
842
|
+
await nextTick()
|
|
843
|
+
expect(highlights.at(-1)).toEqual([])
|
|
844
|
+
|
|
845
|
+
// 拾取会话:插入 B2:C4 → 染色;普通点选 D1 替换 → 染色跟随(仍单引用、蓝色)
|
|
846
|
+
setFxText(el, '=SUM(')
|
|
847
|
+
await nextTick()
|
|
848
|
+
expect(highlights.at(-1)).toEqual([])
|
|
849
|
+
exposed.value!.handleRefSelect(parseRange('B2:C4'))
|
|
850
|
+
await nextTick()
|
|
851
|
+
expect(highlights.at(-1)).toEqual([
|
|
852
|
+
{ range: { start: { row: 1, col: 1 }, end: { row: 3, col: 2 } }, color: '#2563eb' }
|
|
853
|
+
])
|
|
854
|
+
exposed.value!.handleRefSelect(parseRange('D1'))
|
|
855
|
+
await nextTick()
|
|
856
|
+
expect(fxInput(el).value).toBe('=SUM(D1')
|
|
857
|
+
expect(highlights.at(-1)).toEqual([
|
|
858
|
+
{ range: { start: { row: 0, col: 3 }, end: { row: 0, col: 3 } }, color: '#2563eb' }
|
|
859
|
+
])
|
|
860
|
+
|
|
861
|
+
// 提交(编辑态结束):清除
|
|
862
|
+
expect(highlights.at(-1)).toHaveLength(1)
|
|
863
|
+
fxInput(el).dispatchEvent(new KeyboardEvent('keydown', { key: 'Enter', bubbles: true }))
|
|
864
|
+
await nextTick()
|
|
865
|
+
expect(highlights.at(-1)).toEqual([])
|
|
866
|
+
})
|
|
867
|
+
})
|
|
868
|
+
|
|
664
869
|
// ─── 目标格选区高亮保持(弹框打开与参数点选期间)──────────────
|
|
665
870
|
|
|
666
871
|
type GridTable = ReturnType<SheetGrid['getTable']>
|
|
@@ -1,12 +1,15 @@
|
|
|
1
|
+
// @vitest-environment happy-dom
|
|
2
|
+
|
|
1
3
|
import type { FloatObject, SceneEvent } from 'infinitable'
|
|
2
4
|
import { createRange } from 'infinitable/sheet'
|
|
3
5
|
import { Workbook } from 'infinitable/sheet'
|
|
4
6
|
import { afterEach, describe, expect, it, vi } from 'vite-plus/test'
|
|
5
7
|
import { createApp, h, nextTick, ref, type App, type Component } from 'vue'
|
|
6
8
|
|
|
7
|
-
import { USheet } from '../../../index'
|
|
8
9
|
import { registerTool, unregisterTool } from '../../../tools/registry'
|
|
9
10
|
import type { FloatContextMenuPayload, SheetExposed } from '../../../types'
|
|
11
|
+
// 从组件目录导入:内置工具由注册表构造时装入,不依赖包入口副作用
|
|
12
|
+
import { USheet } from '../index'
|
|
10
13
|
import { buildColHeaderMenus, buildRowHeaderMenus } from '../sheet-context-menu'
|
|
11
14
|
// 引擎指针事件模拟与画布几何(cellX/cellY):setup 已跨包引用同目录 setup.ts
|
|
12
15
|
import { cellX, cellY, fire, gridEventTarget } from './grid-test-utils'
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
import { describe, expect, it } from 'vite-plus/test'
|
|
2
2
|
|
|
3
|
-
import { insertRefText, isRefSelectContext } from '../use-formula-ref-select'
|
|
3
|
+
import { insertRefText, isRefSelectContext, replaceRefText } from '../use-formula-ref-select'
|
|
4
4
|
|
|
5
5
|
describe('isRefSelectContext', () => {
|
|
6
6
|
it('运算符 / ( / , / = 之后可插入引用', () => {
|
|
@@ -33,3 +33,14 @@ describe('insertRefText', () => {
|
|
|
33
33
|
expect(insertRefText('=SUM(XX)', 5, 'A1', 7)).toEqual({ text: '=SUM(A1)', cursor: 7 })
|
|
34
34
|
})
|
|
35
35
|
})
|
|
36
|
+
|
|
37
|
+
describe('replaceRefText', () => {
|
|
38
|
+
it('替换区间为引用文本,光标落替换文本后(shift 扩展语义)', () => {
|
|
39
|
+
expect(replaceRefText('=SUM(A1', 5, 7, 'A1:C3')).toEqual({ text: '=SUM(A1:C3', cursor: 10 })
|
|
40
|
+
expect(replaceRefText('=SUM(A1:C3', 5, 10, 'A1:D5')).toEqual({ text: '=SUM(A1:D5', cursor: 10 })
|
|
41
|
+
})
|
|
42
|
+
|
|
43
|
+
it('区间收缩为空等价插入', () => {
|
|
44
|
+
expect(replaceRefText('=SUM(', 5, 5, 'B2')).toEqual({ text: '=SUM(B2', cursor: 7 })
|
|
45
|
+
})
|
|
46
|
+
})
|
|
@@ -96,6 +96,7 @@
|
|
|
96
96
|
<script lang="ts" setup>
|
|
97
97
|
import { message, UDropdown } from '@veltra/desktop'
|
|
98
98
|
import { bem } from '@veltra/utils'
|
|
99
|
+
import { scanFormulaReferences, type ScannedReference } from 'infinitable'
|
|
99
100
|
import {
|
|
100
101
|
formatAddress,
|
|
101
102
|
formatRange,
|
|
@@ -119,7 +120,12 @@ import {
|
|
|
119
120
|
import type { SheetContext } from '../../tools/context'
|
|
120
121
|
import UFormulaSuggestList from './formula-suggest-list.vue'
|
|
121
122
|
import USheetFunctionsPopup from './popups/functions-popup.vue'
|
|
122
|
-
import {
|
|
123
|
+
import {
|
|
124
|
+
REF_HIGHLIGHT_COLORS,
|
|
125
|
+
insertRefText,
|
|
126
|
+
isRefSelectContext,
|
|
127
|
+
replaceRefText
|
|
128
|
+
} from './use-formula-ref-select'
|
|
123
129
|
import {
|
|
124
130
|
applySuggest,
|
|
125
131
|
filterFormulaSuggestions,
|
|
@@ -145,6 +151,8 @@ const props = defineProps<{
|
|
|
145
151
|
context: SheetContext
|
|
146
152
|
/** fx 编辑会话置/清引擎选区锚点(use-sheet-grid 经活动实例透传;缺省静默) */
|
|
147
153
|
setSelectionAnchor?: (addr: CellAddress | null) => void
|
|
154
|
+
/** 公式引用染色框同步(use-sheet-grid 经活动实例透传;空数组清除;缺省静默) */
|
|
155
|
+
setRefHighlights?: (items: { range: CellRange; color: string }[]) => void
|
|
148
156
|
}>()
|
|
149
157
|
|
|
150
158
|
const cls = bem('sheet')
|
|
@@ -182,31 +190,106 @@ function isRefSelecting(): boolean {
|
|
|
182
190
|
return editing.value && !mirroring.value && isRefSelectContext(fxDraft.value, fxCursor.value)
|
|
183
191
|
}
|
|
184
192
|
|
|
185
|
-
/**
|
|
193
|
+
/** 上次引用插入的文本区间(fxDraft 内 [start, end)):插入引用后光标离开触发位、
|
|
194
|
+
* isRefSelectContext 判定失效,拾取会话延续依赖它维持 blur 抑制与替换/扩展语义 */
|
|
195
|
+
let lastRefInsert: { start: number; end: number } | null = null
|
|
196
|
+
|
|
197
|
+
function clearRefInsert(): void {
|
|
198
|
+
lastRefInsert = null
|
|
199
|
+
}
|
|
200
|
+
|
|
201
|
+
/** 引用拾取延续中(上次插入的引用可被后续点选替换/扩展,点击画布不退出编辑) */
|
|
202
|
+
function hasRefInsert(): boolean {
|
|
203
|
+
return lastRefInsert !== null
|
|
204
|
+
}
|
|
205
|
+
|
|
206
|
+
/** 网格 pointerdown(capture)→ 挂起即将到来的 blur 提交;拾取会话延续中
|
|
207
|
+
* (上次插入的引用未被打断)同样挂起——任意点击都消费为引用替换/扩展 */
|
|
186
208
|
function beginBlurSuppress(): void {
|
|
187
|
-
if (!isRefSelecting()) return
|
|
209
|
+
if (!isRefSelecting() && !lastRefInsert) return
|
|
188
210
|
suppressBlurCommit = true
|
|
189
211
|
}
|
|
190
212
|
|
|
191
|
-
/** 选区拦截回调:插入 A1 / A1:B2
|
|
213
|
+
/** 选区拦截回调:插入 A1 / A1:B2 到光标处(仅引用选择模式;弹框打开但非引用上下文时不插入)。
|
|
214
|
+
* 拾取会话延续(lastRefInsert 存在):替换上次插入的引用——shift 扩展回交(Excel 锚点
|
|
215
|
+
* 恒定连续扩展)与普通点选(Point mode 换目标)同走此路径,编辑不中断 */
|
|
192
216
|
function handleRefSelect(range: CellRange): void {
|
|
193
|
-
|
|
217
|
+
// 延续拾取放行:插入后光标离开触发位、isRefSelectContext 失效,延续回交
|
|
218
|
+
// 靠 lastRefInsert 而非光标上下文成立
|
|
219
|
+
if (!isRefSelecting() && !lastRefInsert) return
|
|
220
|
+
// 被编辑格自身不可拾取为引用(Excel 语义:避免循环引用;点中目标格视作无操作)
|
|
221
|
+
if (
|
|
222
|
+
editAddr &&
|
|
223
|
+
range.start.row === range.end.row &&
|
|
224
|
+
range.start.col === range.end.col &&
|
|
225
|
+
range.start.row === editAddr.row &&
|
|
226
|
+
range.start.col === editAddr.col
|
|
227
|
+
) {
|
|
228
|
+
return
|
|
229
|
+
}
|
|
194
230
|
const rangeText = formatRange(range)
|
|
195
|
-
|
|
196
|
-
|
|
197
|
-
|
|
198
|
-
|
|
199
|
-
|
|
231
|
+
if (lastRefInsert) {
|
|
232
|
+
const { start } = lastRefInsert
|
|
233
|
+
const result = replaceRefText(fxDraft.value, start, lastRefInsert.end, rangeText)
|
|
234
|
+
fxDraft.value = result.text
|
|
235
|
+
fxCursor.value = result.cursor
|
|
236
|
+
lastRefInsert = { start, end: result.cursor }
|
|
237
|
+
} else {
|
|
238
|
+
const el = fxRef.value
|
|
239
|
+
const selEnd = el?.selectionEnd ?? fxCursor.value
|
|
240
|
+
const result = insertRefText(fxDraft.value, fxCursor.value, rangeText, selEnd)
|
|
241
|
+
fxDraft.value = result.text
|
|
242
|
+
fxCursor.value = result.cursor
|
|
243
|
+
lastRefInsert = { start: result.cursor - rangeText.length, end: result.cursor }
|
|
244
|
+
}
|
|
200
245
|
closeSuggest()
|
|
201
246
|
void nextTick(() => {
|
|
202
247
|
const input = fxRef.value
|
|
203
248
|
if (!input) return
|
|
204
249
|
input.focus()
|
|
205
|
-
input.setSelectionRange(
|
|
250
|
+
input.setSelectionRange(fxCursor.value, fxCursor.value)
|
|
206
251
|
autosizeFx()
|
|
207
252
|
})
|
|
208
253
|
}
|
|
209
254
|
|
|
255
|
+
// ─── 引用染色框(画布视觉反馈) ────────────────────────────
|
|
256
|
+
|
|
257
|
+
/** 公式文本扫描 → 画布染色框:编辑中且 `=` 开头时逐引用上框(颜色按出现顺序循环),
|
|
258
|
+
* 手输/点选/扩展一视同仁(对齐 Excel:编辑公式即染色全部引用);其余状态清除 */
|
|
259
|
+
function syncRefHighlights(): void {
|
|
260
|
+
if (!editing.value || mirroring.value || !fxDraft.value.startsWith('=')) {
|
|
261
|
+
props.setRefHighlights?.([])
|
|
262
|
+
return
|
|
263
|
+
}
|
|
264
|
+
props.setRefHighlights?.(scanFormulaReferences(fxDraft.value).map(refToHighlight))
|
|
265
|
+
}
|
|
266
|
+
|
|
267
|
+
/** 扫描结果 → 染色框条目(RangeRef 展开为区域,单格引用同形) */
|
|
268
|
+
function refToHighlight(
|
|
269
|
+
scanned: ScannedReference,
|
|
270
|
+
index: number
|
|
271
|
+
): { range: CellRange; color: string } {
|
|
272
|
+
const color = REF_HIGHLIGHT_COLORS[index % REF_HIGHLIGHT_COLORS.length]!
|
|
273
|
+
const ref = scanned.ref
|
|
274
|
+
if (scanned.isRange) {
|
|
275
|
+
return {
|
|
276
|
+
range: {
|
|
277
|
+
start: { row: ref.startRow, col: ref.startCol },
|
|
278
|
+
end: { row: ref.endRow, col: ref.endCol }
|
|
279
|
+
},
|
|
280
|
+
color
|
|
281
|
+
}
|
|
282
|
+
}
|
|
283
|
+
return {
|
|
284
|
+
range: { start: { row: ref.row, col: ref.col }, end: { row: ref.row, col: ref.col } },
|
|
285
|
+
color
|
|
286
|
+
}
|
|
287
|
+
}
|
|
288
|
+
|
|
289
|
+
// 草稿/编辑态/镜像态任一变化即重扫(拾取回交改稿、手输、会话结束都经这三者;
|
|
290
|
+
// 提交同文提交时 fxDraft 不变但 editing 翻转,watch 仍触发完成清除)
|
|
291
|
+
watch([fxDraft, editing, mirroring], syncRefHighlights)
|
|
292
|
+
|
|
210
293
|
// ─── 显示文本 ──────────────────────────────────────────────
|
|
211
294
|
|
|
212
295
|
function nameText(state: SelectionState): string {
|
|
@@ -316,6 +399,8 @@ function syncFxCursor(): void {
|
|
|
316
399
|
}
|
|
317
400
|
|
|
318
401
|
function handleFxInput(): void {
|
|
402
|
+
// 用户手动编辑使上次插入区间失效(shift 扩展只对未经编辑的插入文本有效)
|
|
403
|
+
clearRefInsert()
|
|
319
404
|
syncFxCursor()
|
|
320
405
|
autosizeFx()
|
|
321
406
|
}
|
|
@@ -350,6 +435,7 @@ function confirmSuggest(item?: FormulaSuggestItem): void {
|
|
|
350
435
|
const result = applySuggest(fxDraft.value, ctx.start, ctx.end, pick.name)
|
|
351
436
|
fxDraft.value = result.text
|
|
352
437
|
fxCursor.value = result.cursor
|
|
438
|
+
clearRefInsert()
|
|
353
439
|
closeSuggest()
|
|
354
440
|
void nextTick(() => {
|
|
355
441
|
const el = fxRef.value
|
|
@@ -466,8 +552,9 @@ function commitEdit(): void {
|
|
|
466
552
|
editing.value = false
|
|
467
553
|
editAddr = null
|
|
468
554
|
suppressBlurCommit = false
|
|
469
|
-
// 会话结束清锚点(Enter / ✓ /
|
|
555
|
+
// 会话结束清锚点(Enter / ✓ / 失焦同路径)与引用插入延续状态
|
|
470
556
|
props.setSelectionAnchor?.(null)
|
|
557
|
+
clearRefInsert()
|
|
471
558
|
closeSuggest()
|
|
472
559
|
if (addr) {
|
|
473
560
|
props.context.setCellValue(addr, fxDraft.value)
|
|
@@ -485,8 +572,9 @@ function cancelEdit(): void {
|
|
|
485
572
|
editing.value = false
|
|
486
573
|
editAddr = null
|
|
487
574
|
suppressBlurCommit = false
|
|
488
|
-
// 会话结束清锚点(Esc /
|
|
575
|
+
// 会话结束清锚点(Esc / ✗)与引用插入延续状态
|
|
489
576
|
props.setSelectionAnchor?.(null)
|
|
577
|
+
clearRefInsert()
|
|
490
578
|
closeSuggest()
|
|
491
579
|
refreshFx()
|
|
492
580
|
}
|
|
@@ -524,6 +612,7 @@ function mirrorGridEdit(addr: CellAddress): void {
|
|
|
524
612
|
mirroring.value = true
|
|
525
613
|
mirrorAddr = addr
|
|
526
614
|
fxDraft.value = cellText(addr)
|
|
615
|
+
clearRefInsert()
|
|
527
616
|
closeSuggest()
|
|
528
617
|
}
|
|
529
618
|
|
|
@@ -601,7 +690,8 @@ function insertFunction(name: string): void {
|
|
|
601
690
|
fxDraft.value = text
|
|
602
691
|
fxCursor.value = cursor
|
|
603
692
|
suppressBlurCommit = false
|
|
604
|
-
//
|
|
693
|
+
// 插入函数即进入引用拾取会话:目标格置选区锚点,新会话清引用插入延续状态
|
|
694
|
+
clearRefInsert()
|
|
605
695
|
props.setSelectionAnchor?.(addr)
|
|
606
696
|
closeSuggest()
|
|
607
697
|
void nextTick(() => {
|
|
@@ -621,6 +711,7 @@ defineExpose({
|
|
|
621
711
|
mirrorGridEdit,
|
|
622
712
|
exitMirror,
|
|
623
713
|
isRefSelecting,
|
|
714
|
+
hasRefInsert,
|
|
624
715
|
isFunctionPopupOpen: () => functionsOpen.value,
|
|
625
716
|
beginBlurSuppress,
|
|
626
717
|
handleRefSelect,
|
|
@@ -647,6 +738,7 @@ watch(
|
|
|
647
738
|
mirroring.value = false
|
|
648
739
|
mirrorAddr = null
|
|
649
740
|
suppressBlurCommit = false
|
|
741
|
+
clearRefInsert()
|
|
650
742
|
functionsOpen.value = false
|
|
651
743
|
closeSuggest()
|
|
652
744
|
bindSheet(sheet)
|