@veltra/sheet 4.0.0 → 4.1.0

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.
Files changed (30) hide show
  1. package/dist/components/sheet/float-image-menu.js +59 -0
  2. package/dist/components/sheet/popup-helpers.js +18 -2
  3. package/dist/components/sheet/popups/hyperlink-popup.js +127 -0
  4. package/dist/components/sheet/sheet-context-menu.js +75 -3
  5. package/dist/components/sheet/sheet.js +110 -15
  6. package/dist/components/sheet/style2.css +62 -0
  7. package/dist/components/sheet/use-cell-link-tooltip.js +33 -0
  8. package/dist/components/sheet/use-sheet-grid.js +32 -1
  9. package/dist/components/sheet/use-sheet-state.js +1 -0
  10. package/dist/tools/context.d.ts +20 -2
  11. package/dist/tools/context.js +9 -1
  12. package/dist/types/index.d.ts +2 -2
  13. package/dist/types/sheet.d.ts +50 -1
  14. package/package.json +1 -1
  15. package/src/components/sheet/__test__/float-image-menu.test.ts +130 -0
  16. package/src/components/sheet/__test__/hyperlink-popup.test.ts +176 -0
  17. package/src/components/sheet/__test__/sheet-component.test.ts +474 -16
  18. package/src/components/sheet/__test__/sheet-context-menu.test.ts +212 -2
  19. package/src/components/sheet/float-image-menu.ts +78 -0
  20. package/src/components/sheet/popup-helpers.ts +68 -2
  21. package/src/components/sheet/popups/hyperlink-popup.vue +112 -0
  22. package/src/components/sheet/sheet-context-menu.ts +86 -3
  23. package/src/components/sheet/sheet.vue +117 -3
  24. package/src/components/sheet/style.scss +66 -0
  25. package/src/components/sheet/use-cell-link-tooltip.ts +42 -0
  26. package/src/components/sheet/use-sheet-grid.ts +60 -3
  27. package/src/components/sheet/use-sheet-state.ts +8 -2
  28. package/src/tools/__test__/context.test.ts +89 -0
  29. package/src/tools/context.ts +33 -2
  30. package/src/types/sheet.ts +55 -0
@@ -1,3 +1,4 @@
1
+ import type { FloatObject, SceneEvent } from 'infinitable'
1
2
  import { createRange } from 'infinitable/sheet'
2
3
  import { Workbook } from 'infinitable/sheet'
3
4
  import { afterEach, describe, expect, it, vi } from 'vite-plus/test'
@@ -5,7 +6,7 @@ import { createApp, h, nextTick, ref, type App, type Component } from 'vue'
5
6
 
6
7
  import { USheet } from '../../../index'
7
8
  import { registerTool, unregisterTool } from '../../../tools/registry'
8
- import type { SheetExposed } from '../../../types'
9
+ import type { FloatContextMenuPayload, SheetExposed } from '../../../types'
9
10
  import { buildColHeaderMenus, buildRowHeaderMenus } from '../sheet-context-menu'
10
11
  // 引擎指针事件模拟与画布几何(cellX/cellY):setup 已跨包引用同目录 setup.ts
11
12
  import { cellX, cellY, fire, gridEventTarget } from './grid-test-utils'
@@ -78,6 +79,61 @@ function tabs(el: HTMLElement): HTMLButtonElement[] {
78
79
  return [...el.querySelectorAll<HTMLButtonElement>('.u-sheet__tab')]
79
80
  }
80
81
 
82
+ /**
83
+ * 最新弹出菜单中含指定文案的菜单项。
84
+ * happy-dom 无 transition:close 的 leave 不结束,旧弹层不卸载而在 body 累积,
85
+ * 断言只认 body 中最后一份(每次 pop 追加新根节点)。
86
+ */
87
+ function menuItem(text: string): HTMLLIElement | undefined {
88
+ const roots = document.body.querySelectorAll<HTMLElement>('.u-contextmenu')
89
+ const latest = roots[roots.length - 1]
90
+ return latest
91
+ ? [...latest.querySelectorAll<HTMLLIElement>('.u-contextmenu__item')].find((item) =>
92
+ item.textContent?.includes(text)
93
+ )
94
+ : undefined
95
+ }
96
+
97
+ /** body 格右键(真实 SheetGrid → handleContextMenu → contextmenu.pop 链路) */
98
+ function popBodyContextMenu(
99
+ exposed: { value: SheetExposed | undefined },
100
+ row: number,
101
+ col: number
102
+ ): void {
103
+ const table = exposed.value!.getGrid()!.getTable()
104
+ const event = {
105
+ cell: { row, col },
106
+ region: 'body',
107
+ x: 100,
108
+ y: 40,
109
+ originalEvent: new MouseEvent('contextmenu')
110
+ }
111
+ for (const listener of table.contextMenuListeners) {
112
+ listener(event as Parameters<typeof listener>[0])
113
+ }
114
+ }
115
+
116
+ /** 弹窗(Teleport 到 body)内按文案取按钮 */
117
+ function dialogButton(text: string): HTMLButtonElement | undefined {
118
+ const dialog = document.body.querySelector<HTMLElement>('.u-sheet__link-dialog')
119
+ return dialog
120
+ ? [...dialog.querySelectorAll<HTMLButtonElement>('button')].find((btn) =>
121
+ btn.textContent?.includes(text)
122
+ )
123
+ : undefined
124
+ }
125
+
126
+ /** 弹窗第 index 个输入框(真实 UInput → .u-input__native)写入并同步 v-model */
127
+ async function setDialogInput(index: number, value: string): Promise<void> {
128
+ const dialog = document.body.querySelector<HTMLElement>('.u-sheet__link-dialog')!
129
+ const input = dialog.querySelectorAll<HTMLInputElement>('.u-sheet__link-dialog-input input')[
130
+ index
131
+ ]!
132
+ input.value = value
133
+ input.dispatchEvent(new Event('input', { bubbles: true }))
134
+ await nextTick()
135
+ }
136
+
81
137
  afterEach(() => {
82
138
  while (apps.length) apps.pop()!.unmount()
83
139
  while (containers.length) containers.pop()!.remove()
@@ -1062,21 +1118,6 @@ describe('USheet 行高/列宽右键菜单', () => {
1062
1118
  }
1063
1119
  }
1064
1120
 
1065
- /**
1066
- * 最新弹出菜单中含指定文案的菜单项。
1067
- * happy-dom 无 transition:close 的 leave 不结束,旧弹层不卸载而在 body 累积,
1068
- * 断言只认 body 中最后一份(每次 pop 追加新根节点)。
1069
- */
1070
- function menuItem(text: string): HTMLLIElement | undefined {
1071
- const roots = document.body.querySelectorAll<HTMLElement>('.u-contextmenu')
1072
- const latest = roots[roots.length - 1]
1073
- return latest
1074
- ? [...latest.querySelectorAll<HTMLLIElement>('.u-contextmenu__item')].find((item) =>
1075
- item.textContent?.includes(text)
1076
- )
1077
- : undefined
1078
- }
1079
-
1080
1121
  /** 数值输入项内输入并确认(UInput @input 同步 model,InsertCountMenuItem 点击本体提交) */
1081
1122
  async function confirmMenuNumber(root: HTMLElement, value: number): Promise<void> {
1082
1123
  const input = root.querySelector<HTMLInputElement>('input')!
@@ -1235,6 +1276,423 @@ describe('USheet colResize(readonly 列宽拖拽)', () => {
1235
1276
  })
1236
1277
  })
1237
1278
 
1279
+ describe('USheet 引擎链接 / 图片事件透传', () => {
1280
+ /**
1281
+ * 直接向引擎 table 的监听集合派发事件(happy-dom 无法驱动画布指针命中的
1282
+ * 链接判定),断言 USheet 订阅后以同名 emit 透出且载荷原样。
1283
+ */
1284
+ it('cell link hover/leave/click 与图片链接点击(嵌入/浮动):引擎事件 → 组件 emit 同名事件与载荷', async () => {
1285
+ const workbook = createWorkbook()
1286
+ const exposed: { value: SheetExposed | undefined } = { value: undefined }
1287
+ const hover: unknown[] = []
1288
+ const leave: unknown[] = []
1289
+ const click: unknown[] = []
1290
+ const imageClick: unknown[] = []
1291
+ mount(
1292
+ () => ({
1293
+ workbook,
1294
+ rows: 10,
1295
+ cols: 6,
1296
+ onCellLinkHover: (event: unknown) => hover.push(event),
1297
+ onCellLinkLeave: (event: unknown) => leave.push(event),
1298
+ onCellLinkClick: (event: unknown) => click.push(event),
1299
+ onImageLinkClick: (event: unknown) => imageClick.push(event)
1300
+ }),
1301
+ exposed
1302
+ )
1303
+ await nextTick()
1304
+
1305
+ const table = exposed.value!.getGrid()!.getTable()
1306
+
1307
+ const hoverEvent = {
1308
+ col: 0,
1309
+ row: 0,
1310
+ url: 'https://example.com',
1311
+ text: '示例',
1312
+ x: 51,
1313
+ y: 33,
1314
+ originalEvent: new MouseEvent('pointermove')
1315
+ }
1316
+ for (const listener of table.cellLinkHoverListeners) listener(hoverEvent)
1317
+ expect(hover).toEqual([hoverEvent])
1318
+
1319
+ const leaveEvent = { col: 0, row: 0 }
1320
+ for (const listener of table.cellLinkLeaveListeners) listener(leaveEvent)
1321
+ expect(leave).toEqual([leaveEvent])
1322
+
1323
+ const clickEvent = {
1324
+ col: 0,
1325
+ row: 0,
1326
+ url: 'https://example.com',
1327
+ text: '示例',
1328
+ originalEvent: new MouseEvent('pointerup')
1329
+ }
1330
+ for (const listener of table.cellLinkClickListeners) listener(clickEvent)
1331
+ expect(click).toEqual([clickEvent])
1332
+
1333
+ // 图片链接点击:kind 区分嵌入图(cell)与浮动图(float)
1334
+ const cellImageLink = {
1335
+ kind: 'cell',
1336
+ col: 1,
1337
+ row: 1,
1338
+ url: 'https://example.com/cell.png',
1339
+ originalEvent: new MouseEvent('pointerup')
1340
+ }
1341
+ const floatImageLink = {
1342
+ kind: 'float',
1343
+ id: 'img-1',
1344
+ url: 'https://example.com/float.png',
1345
+ originalEvent: new MouseEvent('pointerup')
1346
+ }
1347
+ for (const listener of table.imageLinkClickListeners) {
1348
+ listener(cellImageLink)
1349
+ listener(floatImageLink)
1350
+ }
1351
+ expect(imageClick).toEqual([cellImageLink, floatImageLink])
1352
+ })
1353
+
1354
+ it('浮动图右键:引擎 floatObjects.onContextMenu → float-context-menu emit(层坐标 + 页面坐标)', async () => {
1355
+ const workbook = createWorkbook()
1356
+ const exposed: { value: SheetExposed | undefined } = { value: undefined }
1357
+ const menus: FloatContextMenuPayload[] = []
1358
+ mount(
1359
+ () => ({ workbook, rows: 10, cols: 6, onFloatContextMenu: (event) => menus.push(event) }),
1360
+ exposed
1361
+ )
1362
+ await nextTick()
1363
+
1364
+ exposed
1365
+ .value!.getGrid()!
1366
+ .getTable()
1367
+ .floatObjects.dispatchContextMenu(
1368
+ { id: 'img-1' } as FloatObject,
1369
+ {
1370
+ type: 'contextmenu',
1371
+ target: null,
1372
+ x: 120,
1373
+ y: 88,
1374
+ deltaX: 0,
1375
+ deltaY: 0,
1376
+ key: undefined,
1377
+ shiftKey: false,
1378
+ ctrlKey: false,
1379
+ metaKey: false,
1380
+ originalEvent: new MouseEvent('contextmenu')
1381
+ } as SceneEvent
1382
+ )
1383
+
1384
+ expect(menus).toHaveLength(1)
1385
+ // happy-dom 无布局:grid 容器 rect 为 0 → 页面坐标 = 层坐标
1386
+ expect(menus[0]).toMatchObject({ id: 'img-1', x: 120, y: 88, clientX: 120, clientY: 88 })
1387
+ })
1388
+
1389
+ it('cell-image-change:活动 sheet 嵌入图变化 → 组件 emit(addr 定向载荷)', async () => {
1390
+ const workbook = createWorkbook()
1391
+ const exposed: { value: SheetExposed | undefined } = { value: undefined }
1392
+ const events: Array<{ addr?: { row: number; col: number } }> = []
1393
+ mount(
1394
+ () => ({ workbook, rows: 10, cols: 6, onCellImageChange: (event) => events.push(event) }),
1395
+ exposed
1396
+ )
1397
+ await nextTick()
1398
+
1399
+ exposed
1400
+ .value!.getActiveSheet()
1401
+ .insertCellImage({ row: 0, col: 0 }, { src: 'https://example.com/a.png' })
1402
+ await nextTick()
1403
+ expect(events).toEqual([{ addr: { row: 0, col: 0 } }])
1404
+ })
1405
+ })
1406
+
1407
+ describe('USheet 单元格超链接 UI(右键菜单 → 配置弹窗 → 写入;悬停 tooltip)', () => {
1408
+ it('body 右键按状态出项:无链接「插入」→ 弹窗确认写入 cell link;有链接「编辑/取消」→ 取消后可 undo', async () => {
1409
+ const workbook = createWorkbook()
1410
+ const exposed: { value: SheetExposed | undefined } = { value: undefined }
1411
+ mount(() => ({ workbook, rows: 10, cols: 6 }), exposed)
1412
+ await nextTick()
1413
+ const ctx = exposed.value!.getContext()
1414
+ ctx.selectCell({ row: 0, col: 0 })
1415
+
1416
+ // 无链接:仅「插入超链接」,无编辑/取消项
1417
+ popBodyContextMenu(exposed, 0, 0)
1418
+ await nextTick()
1419
+ expect(menuItem('插入超链接')!.classList.contains('is-disabled')).toBe(false)
1420
+ expect(menuItem('编辑超链接')).toBeUndefined()
1421
+ expect(menuItem('取消超链接')).toBeUndefined()
1422
+
1423
+ // 点插入项 → 弹窗挂载(cell 模式两字段);填地址确认 → setCellLink 写入、弹窗关闭
1424
+ menuItem('插入超链接')!.click()
1425
+ await nextTick()
1426
+ const dialog = document.body.querySelector<HTMLElement>('.u-sheet__link-dialog')!
1427
+ expect(dialog).toBeTruthy()
1428
+ expect(dialog.querySelectorAll('.u-sheet__link-dialog-input')).toHaveLength(2)
1429
+ await setDialogInput(0, 'https://example.com')
1430
+ dialogButton('确定')!.click()
1431
+ await nextTick()
1432
+ expect(ctx.getCellLink({ row: 0, col: 0 })).toEqual({ url: 'https://example.com' })
1433
+ expect(document.body.querySelector('.u-sheet__link-dialog')).toBeNull()
1434
+
1435
+ // 有链接:编辑 + 取消项
1436
+ popBodyContextMenu(exposed, 0, 0)
1437
+ await nextTick()
1438
+ expect(menuItem('编辑超链接')).toBeTruthy()
1439
+ const clear = menuItem('取消超链接')!
1440
+ expect(clear.classList.contains('is-disabled')).toBe(false)
1441
+
1442
+ // 取消 → getCellLink undefined 且 undo 还原
1443
+ clear.click()
1444
+ await nextTick()
1445
+ expect(ctx.getCellLink({ row: 0, col: 0 })).toBeUndefined()
1446
+ expect(ctx.undo()).toBe(true)
1447
+ expect(ctx.getCellLink({ row: 0, col: 0 })).toEqual({ url: 'https://example.com' })
1448
+ })
1449
+
1450
+ it('readonly:body 菜单超链接项禁用(不拉起弹窗)', async () => {
1451
+ const workbook = createWorkbook()
1452
+ const exposed: { value: SheetExposed | undefined } = { value: undefined }
1453
+ mount(() => ({ workbook, rows: 10, cols: 6, readonly: true }), exposed)
1454
+ await nextTick()
1455
+
1456
+ popBodyContextMenu(exposed, 0, 0)
1457
+ await nextTick()
1458
+ const insert = menuItem('插入超链接')!
1459
+ expect(insert.classList.contains('is-disabled')).toBe(true)
1460
+ insert.click()
1461
+ await nextTick()
1462
+ expect(document.body.querySelector('.u-sheet__link-dialog')).toBeNull()
1463
+ })
1464
+
1465
+ it('悬停链接格:引擎 hover → tooltip 浮层挂载并显示 URL;leave → 卸载', async () => {
1466
+ const workbook = createWorkbook()
1467
+ const exposed: { value: SheetExposed | undefined } = { value: undefined }
1468
+ const { el } = mount(() => ({ workbook, rows: 10, cols: 6 }), exposed)
1469
+ await nextTick()
1470
+ const table = exposed.value!.getGrid()!.getTable()
1471
+ const tooltip = (): HTMLElement | null =>
1472
+ el.querySelector<HTMLElement>('.u-sheet__link-tooltip')
1473
+
1474
+ expect(tooltip()).toBeNull()
1475
+
1476
+ for (const listener of table.cellLinkHoverListeners) {
1477
+ listener({
1478
+ col: 0,
1479
+ row: 0,
1480
+ url: 'https://example.com',
1481
+ x: 51,
1482
+ y: 33,
1483
+ originalEvent: new MouseEvent('pointermove')
1484
+ })
1485
+ }
1486
+ await nextTick()
1487
+ expect(tooltip()).not.toBeNull()
1488
+ expect(tooltip()!.textContent).toBe('https://example.com')
1489
+
1490
+ for (const listener of table.cellLinkLeaveListeners) {
1491
+ listener({ col: 0, row: 0 })
1492
+ }
1493
+ await nextTick()
1494
+ expect(tooltip()).toBeNull()
1495
+ })
1496
+ })
1497
+
1498
+ describe('USheet 图片 UI(浮动图右键独立菜单 / 嵌入图 body 菜单项 / lightbox 预览)', () => {
1499
+ /** 浮动层右键:向引擎 floatObjects 派发 contextmenu(P1 同链路) */
1500
+ function dispatchFloatContextMenu(
1501
+ exposed: { value: SheetExposed | undefined },
1502
+ id: string
1503
+ ): void {
1504
+ exposed
1505
+ .value!.getGrid()!
1506
+ .getTable()
1507
+ .floatObjects.dispatchContextMenu(
1508
+ { id } as FloatObject,
1509
+ {
1510
+ type: 'contextmenu',
1511
+ target: null,
1512
+ x: 120,
1513
+ y: 88,
1514
+ deltaX: 0,
1515
+ deltaY: 0,
1516
+ key: undefined,
1517
+ shiftKey: false,
1518
+ ctrlKey: false,
1519
+ metaKey: false,
1520
+ originalEvent: new MouseEvent('contextmenu')
1521
+ } as SceneEvent
1522
+ )
1523
+ }
1524
+
1525
+ /** 插入一张浮动图(URL 来源),返回 id */
1526
+ function insertFloatImage(exposed: { value: SheetExposed | undefined }, src?: string): string {
1527
+ return exposed
1528
+ .value!.getContext()
1529
+ .insertImage({
1530
+ data: new Uint8Array([1, 2, 3]),
1531
+ type: 'png',
1532
+ anchor: { from: { row: 0, col: 0 } },
1533
+ src
1534
+ })
1535
+ }
1536
+
1537
+ /** lightbox 根节点(UImagePreviewer Teleport 到 body 的 modal) */
1538
+ function lightbox(): HTMLElement | null {
1539
+ return document.body.querySelector<HTMLElement>('.u-image-previewer')
1540
+ }
1541
+
1542
+ it('浮动图右键弹独立菜单:预览 / 设置超链接 / 删除图片;无链接无取消项;不弹 body 菜单', async () => {
1543
+ const workbook = createWorkbook()
1544
+ const exposed: { value: SheetExposed | undefined } = { value: undefined }
1545
+ mount(() => ({ workbook, rows: 10, cols: 6 }), exposed)
1546
+ await nextTick()
1547
+ const id = insertFloatImage(exposed, 'https://example.com/float.png')
1548
+
1549
+ dispatchFloatContextMenu(exposed, id)
1550
+ await nextTick()
1551
+
1552
+ expect(menuItem('预览')!.classList.contains('is-disabled')).toBe(false)
1553
+ expect(menuItem('设置超链接')).toBeTruthy()
1554
+ expect(menuItem('删除图片')).toBeTruthy()
1555
+ expect(menuItem('取消超链接')).toBeUndefined()
1556
+ // 独立菜单:最新弹层不含 body 菜单项(引擎保证右键不穿透到格)
1557
+ expect(menuItem('合并单元格')).toBeUndefined()
1558
+ expect(menuItem('插入图片')).toBeUndefined()
1559
+ })
1560
+
1561
+ it('浮动图菜单:设置超链接(弹窗仅地址字段,确认写 updateImage);取消清 link;删除可 undo', async () => {
1562
+ const workbook = createWorkbook()
1563
+ const exposed: { value: SheetExposed | undefined } = { value: undefined }
1564
+ mount(() => ({ workbook, rows: 10, cols: 6 }), exposed)
1565
+ await nextTick()
1566
+ const ctx = exposed.value!.getContext()
1567
+ const id = insertFloatImage(exposed)
1568
+ const linkOf = (): string | undefined => ctx.getImages().find((img) => img.id === id)?.link
1569
+
1570
+ // 设置超链接 → 弹窗 image 模式仅地址一个输入 → 确认写入 link
1571
+ dispatchFloatContextMenu(exposed, id)
1572
+ await nextTick()
1573
+ menuItem('设置超链接')!.click()
1574
+ await nextTick()
1575
+ const dialog = document.body.querySelector<HTMLElement>('.u-sheet__link-dialog')!
1576
+ expect(dialog).toBeTruthy()
1577
+ expect(dialog.querySelectorAll('.u-sheet__link-dialog-input')).toHaveLength(1)
1578
+ await setDialogInput(0, 'https://example.com')
1579
+ dialogButton('确定')!.click()
1580
+ await nextTick()
1581
+ expect(linkOf()).toBe('https://example.com')
1582
+
1583
+ // 有链接:取消超链接 → updateImage(id, { link: null }) 清除,undo 还原
1584
+ dispatchFloatContextMenu(exposed, id)
1585
+ await nextTick()
1586
+ menuItem('取消超链接')!.click()
1587
+ await nextTick()
1588
+ expect(linkOf()).toBeUndefined()
1589
+ expect(ctx.undo()).toBe(true)
1590
+ expect(linkOf()).toBe('https://example.com')
1591
+
1592
+ // 删除图片 → getImages 不含该 id,undo 还原
1593
+ dispatchFloatContextMenu(exposed, id)
1594
+ await nextTick()
1595
+ menuItem('删除图片')!.click()
1596
+ await nextTick()
1597
+ expect(ctx.getImages().some((img) => img.id === id)).toBe(false)
1598
+ expect(ctx.undo()).toBe(true)
1599
+ expect(ctx.getImages().some((img) => img.id === id)).toBe(true)
1600
+ })
1601
+
1602
+ it('嵌入图 body 菜单四项:预览 / 图片超链接 / 取消超链接 / 移除图片;移除可 undo、link 覆盖写', async () => {
1603
+ const workbook = createWorkbook()
1604
+ const exposed: { value: SheetExposed | undefined } = { value: undefined }
1605
+ mount(() => ({ workbook, rows: 10, cols: 6 }), exposed)
1606
+ await nextTick()
1607
+ const ctx = exposed.value!.getContext()
1608
+ const addr = { row: 0, col: 0 }
1609
+ ctx.insertCellImage(addr, { src: 'https://example.com/cell.png' })
1610
+ ctx.selectCell(addr)
1611
+
1612
+ // 无链接:预览 / 图片超链接 / 移除图片,无取消项
1613
+ popBodyContextMenu(exposed, 0, 0)
1614
+ await nextTick()
1615
+ expect(menuItem('预览')).toBeTruthy()
1616
+ expect(menuItem('图片超链接')).toBeTruthy()
1617
+ expect(menuItem('移除图片')).toBeTruthy()
1618
+ expect(menuItem('取消超链接')).toBeUndefined()
1619
+
1620
+ // 图片超链接 → 弹窗确认 → 覆盖写 link(src 保留)
1621
+ menuItem('图片超链接')!.click()
1622
+ await nextTick()
1623
+ await setDialogInput(0, 'https://example.com')
1624
+ dialogButton('确定')!.click()
1625
+ await nextTick()
1626
+ expect(ctx.getCellImage(addr)).toEqual({
1627
+ src: 'https://example.com/cell.png',
1628
+ link: 'https://example.com'
1629
+ })
1630
+
1631
+ // 有链接:取消超链接 → link 清除(src 保留),undo 还原
1632
+ popBodyContextMenu(exposed, 0, 0)
1633
+ await nextTick()
1634
+ menuItem('取消超链接')!.click()
1635
+ await nextTick()
1636
+ expect(ctx.getCellImage(addr)).toEqual({ src: 'https://example.com/cell.png' })
1637
+ expect(ctx.undo()).toBe(true)
1638
+ expect(ctx.getCellImage(addr)).toEqual({
1639
+ src: 'https://example.com/cell.png',
1640
+ link: 'https://example.com'
1641
+ })
1642
+
1643
+ // 移除图片 → hasCellImage false;菜单不再出现图片项;undo 还原
1644
+ popBodyContextMenu(exposed, 0, 0)
1645
+ await nextTick()
1646
+ menuItem('移除图片')!.click()
1647
+ await nextTick()
1648
+ expect(ctx.hasCellImage(addr)).toBe(false)
1649
+ popBodyContextMenu(exposed, 0, 0)
1650
+ await nextTick()
1651
+ expect(menuItem('移除图片')).toBeUndefined()
1652
+ expect(ctx.undo()).toBe(true)
1653
+ expect(ctx.hasCellImage(addr)).toBe(true)
1654
+ })
1655
+
1656
+ it('右键「预览」打开 lightbox 显示对应图片(浮动图 src / 嵌入图 data),关闭卸载', async () => {
1657
+ const workbook = createWorkbook()
1658
+ const exposed: { value: SheetExposed | undefined } = { value: undefined }
1659
+ mount(() => ({ workbook, rows: 10, cols: 6 }), exposed)
1660
+ await nextTick()
1661
+ const ctx = exposed.value!.getContext()
1662
+
1663
+ // 浮动图(URL 来源)
1664
+ const floatId = insertFloatImage(exposed, 'https://example.com/float.png')
1665
+ dispatchFloatContextMenu(exposed, floatId)
1666
+ await nextTick()
1667
+ menuItem('预览')!.click()
1668
+ await nextTick()
1669
+ expect(lightbox()).not.toBeNull()
1670
+ expect(lightbox()!.querySelector('img')!.getAttribute('src')).toBe(
1671
+ 'https://example.com/float.png'
1672
+ )
1673
+ lightbox()!.querySelector<HTMLElement>('[aria-label="关闭"]')!.click()
1674
+ await vi.waitFor(() => {
1675
+ expect(lightbox()).toBeNull()
1676
+ })
1677
+
1678
+ // 嵌入图(data 字节 → objectURL)
1679
+ const addr = { row: 0, col: 0 }
1680
+ ctx.insertCellImage(addr, { data: new Uint8Array([1, 2, 3]), type: 'png' })
1681
+ ctx.selectCell(addr)
1682
+ popBodyContextMenu(exposed, 0, 0)
1683
+ await nextTick()
1684
+ menuItem('预览')!.click()
1685
+ await nextTick()
1686
+ expect(lightbox()).not.toBeNull()
1687
+ const embeddedSrc = lightbox()!.querySelector('img')!.getAttribute('src')!
1688
+ expect(embeddedSrc.startsWith('blob:')).toBe(true)
1689
+ lightbox()!.querySelector<HTMLElement>('[aria-label="关闭"]')!.click()
1690
+ await vi.waitFor(() => {
1691
+ expect(lightbox()).toBeNull()
1692
+ })
1693
+ })
1694
+ })
1695
+
1238
1696
  describe('fx 选区锚点', () => {
1239
1697
  const A1_ANCHOR = { minCol: 0, minRow: 0, maxCol: 0, maxRow: 0 }
1240
1698