@veltra/sheet 2.5.4 → 2.5.5

package/dist/components/sheet/insert-image.js

@@ -25,6 +25,18 @@ function resolveImageType(file) {
 	const ext = file.name.includes(".") ? file.name.slice(file.name.lastIndexOf(".") + 1) : "";
 	return EXT_TO_TYPE[ext.toLowerCase()];
 }
+/** 取当前活动格锚点；无选区时 message.error 提示并返回 undefined */
+function activeCellAnchor(ctx) {
+	const active = ctx.getSelection().activeCell;
+	if (!active) {
+		message.error("请先选择单元格");
+		return;
+	}
+	return { from: {
+		row: active.row,
+		col: active.col
+	} };
+}
 /**
 * 从本地 File 插入浮动图片：读字节 → 映射类型 → 锚定活动格 → ctx.insertImage。
 * 不支持的格式 / 无活动格时 message.error 提示并返回 undefined。
@@ -35,19 +47,42 @@ async function insertImageFromFile(ctx, file) {
 		message.error("不支持的图片格式，请选择 png / jpeg / gif / svg / webp");
 		return;
 	}
-	const active = ctx.getSelection().activeCell;
-	if (!active) {
-		message.error("请先选择单元格");
-		return;
-	}
+	const anchor = activeCellAnchor(ctx);
+	if (!anchor) return void 0;
 	const buffer = await file.arrayBuffer();
 	return ctx.insertImage({
 		data: new Uint8Array(buffer),
 		type,
-		anchor: { from: {
-			row: active.row,
-			col: active.col
-		} }
+		anchor
+	});
+}
+/**
+* 从 URL 插入浮动图片：URL 直存 src（渲染层直接引用），data 为空字节、
+* type 仅作提示（取 URL 路径扩展名，未知按 png）。锚定活动格，经 ctx.insertImage 写入。
+* 空串 / 非法 URL / 无活动格时 message.error 提示并返回 undefined。
+*/
+function insertImageFromUrl(ctx, url) {
+	const src = url.trim();
+	if (!src) {
+		message.error("请输入图片 URL");
+		return;
+	}
+	let pathname;
+	try {
+		pathname = new URL(src).pathname;
+	} catch {
+		message.error("请输入有效的图片 URL");
+		return;
+	}
+	const anchor = activeCellAnchor(ctx);
+	if (!anchor) return void 0;
+	const ext = pathname.includes(".") ? pathname.slice(pathname.lastIndexOf(".") + 1) : "";
+	const type = EXT_TO_TYPE[ext.toLowerCase()] ?? "png";
+	return ctx.insertImage({
+		data: /* @__PURE__ */ new Uint8Array(),
+		type,
+		src,
+		anchor
 	});
 }
 /**
@@ -76,4 +111,4 @@ function pickAndInsertImage(ctx) {
 	input.click();
 }
 //#endregion
-export { INSERT_IMAGE_ACCEPT, insertImageFromFile, pickAndInsertImage, resolveImageType };
+export { INSERT_IMAGE_ACCEPT, insertImageFromFile, insertImageFromUrl, pickAndInsertImage, resolveImageType };

package/dist/components/sheet/popups/insert-image-popup.js

@@ -1,6 +1,6 @@
-import { INSERT_IMAGE_ACCEPT, insertImageFromFile } from "../insert-image.js";
-import { createBlock, createElementVNode, createTextVNode, defineComponent, normalizeClass, openBlock, unref, withCtx } from "vue";
-import { UFilePicker } from "@veltra/desktop";
+import { INSERT_IMAGE_ACCEPT, insertImageFromFile, insertImageFromUrl } from "../insert-image.js";
+import { Fragment, createElementBlock, createElementVNode, createTextVNode, createVNode, defineComponent, normalizeClass, openBlock, ref, unref, withCtx, withKeys } from "vue";
+import { UButton, UFilePicker, UInput } from "@veltra/desktop";
 import { bem } from "@veltra/utils";
 //#region src/components/sheet/popups/insert-image-popup.vue
 const _sfc_main = /*@__PURE__*/ defineComponent({
@@ -10,27 +10,48 @@ const _sfc_main = /*@__PURE__*/ defineComponent({
 	emits: ["close"],
 	setup(__props, { emit: __emit }) {
 		/**
-		* 插入图片面板（UFilePicker）：选文件后走共享 insertImageFromFile，锚定当前选区活动格。
+		* 插入图片面板：UFilePicker 选本地文件，或输入图片 URL 插入；均走共享
+		* insertImageFromFile / insertImageFromUrl，锚定当前选区活动格。
 		* 不参与面板事务（单次插入 = 一个 undo 单元）。
 		*/
 		const props = __props;
 		const emit = __emit;
 		const cls = bem("sheet");
+		const imageUrl = ref("");
 		function handlePick(files) {
 			const file = files[0];
 			if (!file) return;
 			emit("close");
 			insertImageFromFile(props.context, file);
 		}
+		function handleUrlInsert() {
+			if (!imageUrl.value.trim()) return;
+			emit("close");
+			insertImageFromUrl(props.context, imageUrl.value);
+		}
 		return (_ctx, _cache) => {
-			return openBlock(), createBlock(unref(UFilePicker), {
+			return openBlock(), createElementBlock(Fragment, null, [createVNode(unref(UFilePicker), {
 				accept: unref(INSERT_IMAGE_ACCEPT),
 				class: normalizeClass(unref(cls).e("insert-image-picker")),
 				onPick: handlePick
 			}, {
-				default: withCtx(() => [createElementVNode("div", { class: normalizeClass(unref(cls).e("insert-image-hint")) }, [_cache[0] || (_cache[0] = createTextVNode(" 选择图片文件 ", -1)), createElementVNode("div", { class: normalizeClass(unref(cls).e("insert-image-sub")) }, "支持 png / jpeg / gif / svg / webp", 2)], 2)]),
+				default: withCtx(() => [createElementVNode("div", { class: normalizeClass(unref(cls).e("insert-image-hint")) }, [_cache[1] || (_cache[1] = createTextVNode(" 选择图片文件 ", -1)), createElementVNode("div", { class: normalizeClass(unref(cls).e("insert-image-sub")) }, "支持 png / jpeg / gif / svg / webp", 2)], 2)]),
+				_: 1
+			}, 8, ["accept", "class"]), createElementVNode("div", { class: normalizeClass(unref(cls).e("popup-row")) }, [createVNode(unref(UInput), {
+				modelValue: imageUrl.value,
+				"onUpdate:modelValue": _cache[0] || (_cache[0] = ($event) => imageUrl.value = $event),
+				placeholder: "输入图片 URL",
+				size: "small",
+				onKeydown: withKeys(handleUrlInsert, ["enter"])
+			}, null, 8, ["modelValue"]), createVNode(unref(UButton), {
+				size: "small",
+				type: "primary",
+				disabled: !imageUrl.value.trim(),
+				onClick: handleUrlInsert
+			}, {
+				default: withCtx(() => [..._cache[2] || (_cache[2] = [createTextVNode(" 插入 ", -1)])]),
 				_: 1
-			}, 8, ["accept", "class"]);
+			}, 8, ["disabled"])], 2)], 64);
 		};
 	}
 });

package/dist/components/sheet/sheet-context-menu.js

@@ -48,21 +48,29 @@ function resolveRenderSize(propsRows, propsCols, sheetRows, sheetCols) {
 		cols: sheetCols > 0 ? sheetCols : propsCols ?? 26
 	};
 }
-function insertCountRender(options) {
+/** 菜单内嵌数量输入项（插入行列数 / 小数位数共用） */
+function menuNumberRender(options) {
 	return defineComponent({
-		name: "SheetInsertCountMenuRender",
+		name: "SheetMenuNumberRender",
 		setup() {
 			return () => h(_sfc_main, {
 				prefix: options.prefix,
 				suffix: options.suffix,
 				defaultValue: options.defaultValue,
-				min: 1,
-				max: INSERT_COUNT_MAX,
+				min: options.min,
+				max: options.max,
 				onConfirm: options.onConfirm
 			});
 		}
 	});
 }
+function insertCountRender(options) {
+	return menuNumberRender({
+		...options,
+		min: 1,
+		max: INSERT_COUNT_MAX
+	});
+}
 function primaryRange(ctx) {
 	return ctx.getSelection().ranges[0] ?? null;
 }
@@ -158,7 +166,14 @@ function buildColHeaderMenus(ctx) {
 		}
 	];
 }
-/** body 格右键菜单：合并/取消合并 + 插入图片（行列插入/删除仅行号/列头菜单） */
+/**
+* 对当前选区应用 numFmt（经 applyStyle → 命令系统，天然可 undo/redo）。
+* 仅影响显示，单元格恒存原始值（见 sheet-core `core/format.ts`）。
+*/
+function applyNumFmtToSelection(ctx, numFmt) {
+	for (const range of ctx.getSelection().ranges) ctx.applyStyle(range, { numFmt });
+}
+/** body 格右键菜单：合并/取消合并 + 设置数据格式 + 插入图片（行列插入/删除仅行号/列头菜单） */
 function buildBodyMenus(ctx) {
 	const mergeTool = defaultToolRegistry.get("merge");
 	const unmergeTool = defaultToolRegistry.get("unmerge");
@@ -174,6 +189,40 @@ function buildBodyMenus(ctx) {
 			disabled: unmergeTool?.disabled?.(ctx) ?? true,
 			callback: () => unmergeTool?.onClick(ctx)
 		},
+		{ divider: true },
+		{
+			label: "设置数据格式",
+			disabled: !active,
+			children: [
+				{
+					label: "日期",
+					callback: () => applyNumFmtToSelection(ctx, { type: "date" })
+				},
+				{
+					label: "千分位金额",
+					callback: () => applyNumFmtToSelection(ctx, { type: "thousands" })
+				},
+				{
+					label: "大写金额",
+					callback: () => applyNumFmtToSelection(ctx, { type: "cnUpper" })
+				},
+				{
+					label: "小数位数",
+					keepOpen: true,
+					render: menuNumberRender({
+						prefix: "保留",
+						suffix: "位小数",
+						defaultValue: 2,
+						min: 0,
+						max: 10,
+						onConfirm: (n) => applyNumFmtToSelection(ctx, {
+							type: "fixed",
+							digits: n
+						})
+					})
+				}
+			]
+		},
 		{
 			label: "插入图片",
 			disabled: !active,
@@ -200,4 +249,4 @@ function ensureContextMenuSelection(ctx, info, renderSize) {
 	}
 }
 //#endregion
-export { INSERT_COUNT_MAX, buildBodyMenus, buildColHeaderMenus, buildRowHeaderMenus, defaultInsertCount, ensureContextMenuSelection, isColInSelection, isRowInSelection, resolveRenderSize, wholeColRange, wholeRowRange };
+export { INSERT_COUNT_MAX, applyNumFmtToSelection, buildBodyMenus, buildColHeaderMenus, buildRowHeaderMenus, defaultInsertCount, ensureContextMenuSelection, isColInSelection, isRowInSelection, resolveRenderSize, wholeColRange, wholeRowRange };

package/dist/components/sheet/style.d.ts

@@ -8,4 +8,5 @@ import "@veltra/desktop/components/loading/style";
 import "@veltra/desktop/components/message/style";
 import "@veltra/desktop/components/input/style";
 import "@veltra/desktop/components/file-picker/style";
+import "@veltra/desktop/components/button/style";
 import "@veltra/desktop/components/icon/style";

package/dist/components/sheet/style.js

@@ -9,4 +9,5 @@ import "@veltra/desktop/components/loading/style";
 import "@veltra/desktop/components/message/style";
 import "@veltra/desktop/components/input/style";
 import "@veltra/desktop/components/file-picker/style";
+import "@veltra/desktop/components/button/style";
 import "@veltra/desktop/components/icon/style";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@veltra/sheet",
-  "version": "2.5.4",
+  "version": "2.5.5",
   "homepage": "https://github.com/cabinet-fe/ultra-ui#readme",
   "bugs": {
     "url": "https://github.com/cabinet-fe/ultra-ui/issues"
@@ -36,11 +36,11 @@
   "peerDependencies": {
     "@cat-kit/core": ">=1.2.1",
     "@cat-kit/fe": ">=1.2.1",
-    "@veltra/desktop": "^1.7.4",
+    "@veltra/desktop": "^1.7.9",
     "@veltra/icons": "^1.5.0",
-    "@veltra/sheet-core": "^2.5.4",
-    "@veltra/styles": "^1.7.4",
-    "@veltra/utils": "^1.7.4",
+    "@veltra/sheet-core": "^2.5.5",
+    "@veltra/styles": "^1.7.9",
+    "@veltra/utils": "^1.7.9",
     "vue": ">=3.5.42"
   }
 }

package/src/components/sheet/__test__/insert-image-popup.test.ts

@@ -39,6 +39,36 @@ vi.mock('@veltra/desktop', async () => {
             'pick'
           )
       }
+    }),
+    UInput: defineComponent({
+      name: 'UInputStub',
+      props: ['modelValue'],
+      emits: ['update:modelValue'],
+      setup(props, { emit }) {
+        return () =>
+          h('input', {
+            class: 'url-input-stub',
+            value: props.modelValue as string,
+            onInput: (e: Event) => emit('update:modelValue', (e.target as HTMLInputElement).value)
+          })
+      }
+    }),
+    UButton: defineComponent({
+      name: 'UButtonStub',
+      props: ['disabled'],
+      emits: ['click'],
+      setup(props, { emit, slots }) {
+        return () =>
+          h(
+            'button',
+            {
+              class: 'url-btn-stub',
+              disabled: props.disabled as boolean,
+              onClick: () => emit('click')
+            },
+            slots.default?.()
+          )
+      }
     })
   }
 })
@@ -86,4 +116,24 @@ describe('USheetInsertImagePopup', () => {
     expect(sheet.getImages()[0]?.type).toBe('png')
     expect([...sheet.getImages()[0]!.data]).toEqual([9, 8, 7])
   })
+
+  it('输入 URL 点插入 → 关闭弹层并插入 src 来源图片', async () => {
+    const closed = vi.fn()
+    const { el, sheet } = mountPopup(closed)
+    const input = el.querySelector<HTMLInputElement>('.url-input-stub')!
+    const btn = el.querySelector<HTMLButtonElement>('.url-btn-stub')!
+    expect(btn.disabled).toBe(true)
+
+    input.value = 'https://example.com/pic.gif'
+    input.dispatchEvent(new Event('input'))
+    await Promise.resolve()
+    expect(btn.disabled).toBe(false)
+
+    btn.click()
+    expect(closed).toHaveBeenCalledTimes(1)
+    expect(sheet.getImages()).toHaveLength(1)
+    expect(sheet.getImages()[0]?.src).toBe('https://example.com/pic.gif')
+    expect(sheet.getImages()[0]?.type).toBe('gif')
+    expect(sheet.getImages()[0]?.anchor.from).toEqual({ row: 1, col: 1 })
+  })
 })

package/src/components/sheet/__test__/insert-image.test.ts

@@ -5,6 +5,7 @@ import { createSheetContext } from '../../../tools/context'
 import {
   INSERT_IMAGE_ACCEPT,
   insertImageFromFile,
+  insertImageFromUrl,
   pickAndInsertImage,
   resolveImageType
 } from '../insert-image'
@@ -84,6 +85,59 @@ describe('insertImageFromFile', () => {
   })
 })
 
+describe('insertImageFromUrl', () => {
+  it('合法 URL → 锚定活动格并经 ctx.insertImage 写入 src 来源图片', () => {
+    const sheet = new Sheet()
+    const ctx = createSheetContext(sheet)
+    ctx.selectCell({ row: 2, col: 3 })
+    const id = insertImageFromUrl(ctx, 'https://example.com/assets/logo.webp')
+    expect(id).toBeTruthy()
+    const images = ctx.getImages()
+    expect(images).toHaveLength(1)
+    expect(images[0]?.src).toBe('https://example.com/assets/logo.webp')
+    expect(images[0]?.type).toBe('webp')
+    expect(images[0]?.data).toHaveLength(0)
+    expect(images[0]?.anchor.from).toEqual({ row: 2, col: 3 })
+    expect(mocks.message.error).not.toHaveBeenCalled()
+  })
+
+  it('URL 无已知扩展名 → type 按 png 提示，仍可插入', () => {
+    const sheet = new Sheet()
+    const ctx = createSheetContext(sheet)
+    ctx.selectCell({ row: 1, col: 1 })
+    const id = insertImageFromUrl(ctx, 'https://example.com/image?id=1')
+    expect(id).toBeTruthy()
+    expect(ctx.getImages()[0]?.type).toBe('png')
+  })
+
+  it('空串 → message.error，不写入', () => {
+    const sheet = new Sheet()
+    const ctx = createSheetContext(sheet)
+    ctx.selectCell({ row: 1, col: 1 })
+    expect(insertImageFromUrl(ctx, '   ')).toBeUndefined()
+    expect(ctx.getImages()).toHaveLength(0)
+    expect(mocks.message.error).toHaveBeenCalledWith('请输入图片 URL')
+  })
+
+  it('非法 URL → message.error，不写入', () => {
+    const sheet = new Sheet()
+    const ctx = createSheetContext(sheet)
+    ctx.selectCell({ row: 1, col: 1 })
+    expect(insertImageFromUrl(ctx, 'not a url')).toBeUndefined()
+    expect(ctx.getImages()).toHaveLength(0)
+    expect(mocks.message.error).toHaveBeenCalledWith('请输入有效的图片 URL')
+  })
+
+  it('无活动格 → message.error，不写入', () => {
+    const sheet = new Sheet()
+    const ctx = createSheetContext(sheet)
+    sheet.selection.clear()
+    expect(insertImageFromUrl(ctx, 'https://example.com/a.png')).toBeUndefined()
+    expect(ctx.getImages()).toHaveLength(0)
+    expect(mocks.message.error).toHaveBeenCalledWith('请先选择单元格')
+  })
+})
+
 describe('pickAndInsertImage', () => {
   it('创建隐藏 file input（同一 accept）并 click', () => {
     const sheet = new Sheet()

package/src/components/sheet/__test__/sheet-context-menu.test.ts

@@ -4,6 +4,7 @@ import { describe, expect, it } from 'vitest'
 
 import { createSheetContext } from '../../../tools/context'
 import {
+  applyNumFmtToSelection,
   buildBodyMenus,
   buildColHeaderMenus,
   buildRowHeaderMenus,
@@ -147,13 +148,19 @@ describe('build*Menus', () => {
     ])
   })
 
-  it('body 菜单三项：合并/取消合并/插入图片，不含行列插入删除', () => {
+  it('body 菜单：合并/取消合并 + 设置数据格式子菜单 + 插入图片，不含行列插入删除', () => {
     const sheet = new Sheet()
     const ctx = createSheetContext(sheet)
     sheet.selectCell({ row: 0, col: 0 })
     const menus = buildBodyMenus(ctx)
-    expect(menus).toHaveLength(3)
-    expect(menus.map((m) => m.label)).toEqual(['合并单元格', '取消合并单元格', '插入图片'])
+    expect(menus).toHaveLength(5)
+    expect(menus.map((m) => m.label ?? (m.divider ? '---' : ''))).toEqual([
+      '合并单元格',
+      '取消合并单元格',
+      '---',
+      '设置数据格式',
+      '插入图片'
+    ])
     const insertImage = menus.find((m) => m.label === '插入图片')!
     expect(insertImage.disabled).toBeFalsy()
     expect(insertImage.callback).toBeTruthy()
@@ -164,12 +171,92 @@ describe('build*Menus', () => {
     expect(labels).not.toContain('删除列')
   })
 
-  it('body 插入图片：无活动格时禁用', () => {
+  it('body 设置数据格式子菜单：日期 / 千分位金额 / 大写金额 / 小数位数', () => {
+    const sheet = new Sheet()
+    const ctx = createSheetContext(sheet)
+    sheet.selectCell({ row: 0, col: 0 })
+    const sub = buildBodyMenus(ctx).find((m) => m.label === '设置数据格式')!
+    expect(sub.disabled).toBeFalsy()
+    const children = sub.children!
+    expect(children.map((c) => c.label)).toEqual(['日期', '千分位金额', '大写金额', '小数位数'])
+    // 小数位数项内嵌位数输入（keepOpen + render），其余三项直点直用
+    expect(children[3]?.keepOpen).toBe(true)
+    expect(children[3]?.render).toBeTruthy()
+    expect(children.slice(0, 3).every((c) => typeof c.callback === 'function')).toBe(true)
+  })
+
+  it('设置数据格式：四项各应用 numFmt 到当前选区全部单元格，原始值不变', () => {
+    const sheet = new Sheet()
+    const ctx = createSheetContext(sheet)
+    sheet.setCellValue({ row: 0, col: 0 }, 45000)
+    sheet.setCellValue({ row: 0, col: 1 }, 1234567.89)
+    const range = createRange({ row: 0, col: 0 }, { row: 0, col: 1 })
+
+    const cases = [
+      { label: '日期', numFmt: { type: 'date' } },
+      { label: '千分位金额', numFmt: { type: 'thousands' } },
+      { label: '大写金额', numFmt: { type: 'cnUpper' } }
+    ] as const
+    for (const c of cases) {
+      sheet.selectRange(range)
+      const sub = buildBodyMenus(ctx).find((m) => m.label === '设置数据格式')!
+      sub.children!.find((child) => child.label === c.label)!.callback!()
+      for (const addr of [
+        { row: 0, col: 0 },
+        { row: 0, col: 1 }
+      ]) {
+        expect(ctx.getCellStyle(addr)?.numFmt).toEqual(c.numFmt)
+      }
+      // 仅样式变化，原始值不变
+      expect(ctx.getCellData({ row: 0, col: 0 })?.v).toBe(45000)
+      expect(ctx.getCellData({ row: 0, col: 1 })?.v).toBe(1234567.89)
+      sheet.undo()
+    }
+
+    // 小数位数：经同一入口 applyNumFmtToSelection（render onConfirm 同路径）
+    sheet.selectRange(range)
+    applyNumFmtToSelection(ctx, { type: 'fixed', digits: 2 })
+    expect(ctx.getCellStyle({ row: 0, col: 0 })?.numFmt).toEqual({ type: 'fixed', digits: 2 })
+    expect(ctx.getCellStyle({ row: 0, col: 1 })?.numFmt).toEqual({ type: 'fixed', digits: 2 })
+    sheet.undo()
+  })
+
+  it('设置数据格式：undo/redo 恢复样式', () => {
+    const sheet = new Sheet()
+    const ctx = createSheetContext(sheet)
+    sheet.setCellValue({ row: 1, col: 1 }, 1.005)
+    sheet.selectRange(createRange({ row: 1, col: 1 }, { row: 1, col: 1 }))
+    const sub = buildBodyMenus(ctx).find((m) => m.label === '设置数据格式')!
+    sub.children!.find((c) => c.label === '千分位金额')!.callback!()
+    expect(ctx.getCellStyle({ row: 1, col: 1 })?.numFmt).toEqual({ type: 'thousands' })
+
+    expect(ctx.undo()).toBe(true)
+    expect(ctx.getCellStyle({ row: 1, col: 1 })?.numFmt).toBeUndefined()
+    expect(ctx.redo()).toBe(true)
+    expect(ctx.getCellStyle({ row: 1, col: 1 })?.numFmt).toEqual({ type: 'thousands' })
+    expect(ctx.getCellData({ row: 1, col: 1 })?.v).toBe(1.005)
+  })
+
+  it('设置数据格式：清空选区时为无操作（不产生 undo 单元）', () => {
+    const sheet = new Sheet()
+    const ctx = createSheetContext(sheet)
+    sheet.setCellValue({ row: 0, col: 0 }, 1)
+    sheet.selection.clear()
+    applyNumFmtToSelection(ctx, { type: 'date' })
+    expect(ctx.getCellStyle({ row: 0, col: 0 })).toBeUndefined()
+    // undo 直接回滚到 setCellValue 之前，证明未新增 undo 单元
+    expect(ctx.undo()).toBe(true)
+    expect(ctx.getCellData({ row: 0, col: 0 })).toBeUndefined()
+    expect(ctx.canUndo).toBe(false)
+  })
+
+  it('body 插入图片 / 设置数据格式：无活动格时禁用', () => {
     const sheet = new Sheet()
     const ctx = createSheetContext(sheet)
     sheet.selection.clear()
     const menus = buildBodyMenus(ctx)
     expect(menus.find((m) => m.label === '插入图片')?.disabled).toBe(true)
+    expect(menus.find((m) => m.label === '设置数据格式')?.disabled).toBe(true)
   })
 
   it('行号/列头菜单仍含插入删除行列', () => {

package/src/components/sheet/insert-image.ts

@@ -1,5 +1,5 @@
 import { message } from '@veltra/desktop'
-import type { SheetImageType } from '@veltra/sheet-core/core/image'
+import type { SheetImageAnchor, SheetImageType } from '@veltra/sheet-core/core/image'
 
 import type { SheetContext } from '../../tools/context'
 
@@ -32,6 +32,16 @@ export function resolveImageType(file: File): SheetImageType | undefined {
   return EXT_TO_TYPE[ext.toLowerCase()]
 }
 
+/** 取当前活动格锚点；无选区时 message.error 提示并返回 undefined */
+function activeCellAnchor(ctx: SheetContext): SheetImageAnchor | undefined {
+  const active = ctx.getSelection().activeCell
+  if (!active) {
+    message.error('请先选择单元格')
+    return undefined
+  }
+  return { from: { row: active.row, col: active.col } }
+}
+
 /**
  * 从本地 File 插入浮动图片：读字节 → 映射类型 → 锚定活动格 → ctx.insertImage。
  * 不支持的格式 / 无活动格时 message.error 提示并返回 undefined。
@@ -45,17 +55,35 @@ export async function insertImageFromFile(
     message.error('不支持的图片格式，请选择 png / jpeg / gif / svg / webp')
     return undefined
   }
-  const active = ctx.getSelection().activeCell
-  if (!active) {
-    message.error('请先选择单元格')
+  const anchor = activeCellAnchor(ctx)
+  if (!anchor) return undefined
+  const buffer = await file.arrayBuffer()
+  return ctx.insertImage({ data: new Uint8Array(buffer), type, anchor })
+}
+
+/**
+ * 从 URL 插入浮动图片：URL 直存 src（渲染层直接引用），data 为空字节、
+ * type 仅作提示（取 URL 路径扩展名，未知按 png）。锚定活动格，经 ctx.insertImage 写入。
+ * 空串 / 非法 URL / 无活动格时 message.error 提示并返回 undefined。
+ */
+export function insertImageFromUrl(ctx: SheetContext, url: string): string | undefined {
+  const src = url.trim()
+  if (!src) {
+    message.error('请输入图片 URL')
     return undefined
   }
-  const buffer = await file.arrayBuffer()
-  return ctx.insertImage({
-    data: new Uint8Array(buffer),
-    type,
-    anchor: { from: { row: active.row, col: active.col } }
-  })
+  let pathname: string
+  try {
+    pathname = new URL(src).pathname
+  } catch {
+    message.error('请输入有效的图片 URL')
+    return undefined
+  }
+  const anchor = activeCellAnchor(ctx)
+  if (!anchor) return undefined
+  const ext = pathname.includes('.') ? pathname.slice(pathname.lastIndexOf('.') + 1) : ''
+  const type = EXT_TO_TYPE[ext.toLowerCase()] ?? 'png'
+  return ctx.insertImage({ data: new Uint8Array(), type, src, anchor })
 }
 
 /**

package/src/components/sheet/popups/insert-image-popup.vue

@@ -9,19 +9,32 @@
       <div :class="cls.e('insert-image-sub')">支持 png / jpeg / gif / svg / webp</div>
     </div>
   </u-file-picker>
+  <div :class="cls.e('popup-row')">
+    <u-input
+      v-model="imageUrl"
+      placeholder="输入图片 URL"
+      size="small"
+      @keydown.enter="handleUrlInsert"
+    />
+    <u-button size="small" type="primary" :disabled="!imageUrl.trim()" @click="handleUrlInsert">
+      插入
+    </u-button>
+  </div>
 </template>
 
 <script lang="ts" setup>
-import { UFilePicker } from '@veltra/desktop'
+import { UButton, UFilePicker, UInput } from '@veltra/desktop'
 import { bem } from '@veltra/utils'
+import { ref } from 'vue'
 
 import type { SheetContext } from '../../../tools/context'
-import { INSERT_IMAGE_ACCEPT, insertImageFromFile } from '../insert-image'
+import { INSERT_IMAGE_ACCEPT, insertImageFromFile, insertImageFromUrl } from '../insert-image'
 
 defineOptions({ name: 'USheetInsertImagePopup' })
 
 /**
- * 插入图片面板（UFilePicker）：选文件后走共享 insertImageFromFile，锚定当前选区活动格。
+ * 插入图片面板：UFilePicker 选本地文件，或输入图片 URL 插入；均走共享
+ * insertImageFromFile / insertImageFromUrl，锚定当前选区活动格。
  * 不参与面板事务（单次插入 = 一个 undo 单元）。
  */
 const props = defineProps<{ context: SheetContext }>()
@@ -30,10 +43,18 @@ const emit = defineEmits<{ close: [] }>()
 
 const cls = bem('sheet')
 
+const imageUrl = ref('')
+
 function handlePick(files: File[]): void {
   const file = files[0]
   if (!file) return
   emit('close')
   void insertImageFromFile(props.context, file)
 }
+
+function handleUrlInsert(): void {
+  if (!imageUrl.value.trim()) return
+  emit('close')
+  insertImageFromUrl(props.context, imageUrl.value)
+}
 </script>

package/src/components/sheet/sheet-context-menu.ts

@@ -1,5 +1,6 @@
 import type { ContextmenuItem } from '@veltra/desktop'
 import { createRange, type CellAddress, type CellRange } from '@veltra/sheet-core/core/address'
+import type { NumFmt } from '@veltra/sheet-core/core/style/types'
 import { defineComponent, h } from 'vue'
 
 import type { SheetContext } from '../../tools/context'
@@ -11,6 +12,10 @@ import { pickAndInsertImage } from './insert-image'
 export const INSERT_COUNT_MIN = 1
 export const INSERT_COUNT_MAX = 1000
 
+/** 小数位数钳制范围 */
+export const DECIMAL_PLACES_MIN = 0
+export const DECIMAL_PLACES_MAX = 10
+
 /** 选区覆盖行/列数 → 插入默认 N（min 1 / max 1000） */
 export function defaultInsertCount(range: CellRange | null, axis: 'row' | 'col'): number {
   if (!range) return INSERT_COUNT_MIN
@@ -55,28 +60,40 @@ export function resolveRenderSize(
   }
 }
 
-function insertCountRender(options: {
+/** 菜单内嵌数量输入项（插入行列数 / 小数位数共用） */
+function menuNumberRender(options: {
   prefix: string
   suffix: string
   defaultValue: number
+  min: number
+  max: number
   onConfirm: (n: number) => void
 }): ContextmenuItem['render'] {
   return defineComponent({
-    name: 'SheetInsertCountMenuRender',
+    name: 'SheetMenuNumberRender',
     setup() {
       return () =>
         h(InsertCountMenuItem, {
           prefix: options.prefix,
           suffix: options.suffix,
           defaultValue: options.defaultValue,
-          min: INSERT_COUNT_MIN,
-          max: INSERT_COUNT_MAX,
+          min: options.min,
+          max: options.max,
           onConfirm: options.onConfirm
         })
     }
   })
 }
 
+function insertCountRender(options: {
+  prefix: string
+  suffix: string
+  defaultValue: number
+  onConfirm: (n: number) => void
+}): ContextmenuItem['render'] {
+  return menuNumberRender({ ...options, min: INSERT_COUNT_MIN, max: INSERT_COUNT_MAX })
+}
+
 function primaryRange(ctx: SheetContext): CellRange | null {
   return ctx.getSelection().ranges[0] ?? null
 }
@@ -171,7 +188,15 @@ export function buildColHeaderMenus(ctx: SheetContext): ContextmenuItem[] {
   ]
 }
 
-/** body 格右键菜单：合并/取消合并 + 插入图片（行列插入/删除仅行号/列头菜单） */
+/**
+ * 对当前选区应用 numFmt（经 applyStyle → 命令系统，天然可 undo/redo）。
+ * 仅影响显示，单元格恒存原始值（见 sheet-core `core/format.ts`）。
+ */
+export function applyNumFmtToSelection(ctx: SheetContext, numFmt: NumFmt): void {
+  for (const range of ctx.getSelection().ranges) ctx.applyStyle(range, { numFmt })
+}
+
+/** body 格右键菜单：合并/取消合并 + 设置数据格式 + 插入图片（行列插入/删除仅行号/列头菜单） */
 export function buildBodyMenus(ctx: SheetContext): ContextmenuItem[] {
   const mergeTool = defaultToolRegistry.get('merge')
   const unmergeTool = defaultToolRegistry.get('unmerge')
@@ -188,6 +213,28 @@ export function buildBodyMenus(ctx: SheetContext): ContextmenuItem[] {
       disabled: unmergeTool?.disabled?.(ctx) ?? true,
       callback: () => unmergeTool?.onClick(ctx)
     },
+    { divider: true },
+    {
+      label: '设置数据格式',
+      disabled: !active,
+      children: [
+        { label: '日期', callback: () => applyNumFmtToSelection(ctx, { type: 'date' }) },
+        { label: '千分位金额', callback: () => applyNumFmtToSelection(ctx, { type: 'thousands' }) },
+        { label: '大写金额', callback: () => applyNumFmtToSelection(ctx, { type: 'cnUpper' }) },
+        {
+          label: '小数位数',
+          keepOpen: true,
+          render: menuNumberRender({
+            prefix: '保留',
+            suffix: '位小数',
+            defaultValue: 2,
+            min: DECIMAL_PLACES_MIN,
+            max: DECIMAL_PLACES_MAX,
+            onConfirm: (n) => applyNumFmtToSelection(ctx, { type: 'fixed', digits: n })
+          })
+        }
+      ]
+    },
     { label: '插入图片', disabled: !active, callback: () => pickAndInsertImage(ctx) }
   ]
 }

package/src/components/sheet/style.ts

@@ -7,7 +7,8 @@ import '@veltra/desktop/components/scroll/style'
 import '@veltra/desktop/components/tip/style'
 import '@veltra/desktop/components/loading/style' // v-loading（sheet.vue grid 容器）
 import '@veltra/desktop/components/message/style' // message / messageConfirm（弹层、tabs、公式栏）
-import '@veltra/desktop/components/input/style' // UInput（find-popup）
+import '@veltra/desktop/components/input/style' // UInput（find-popup / insert-image-popup）
 import '@veltra/desktop/components/file-picker/style' // UFilePicker（insert-image-popup）
+import '@veltra/desktop/components/button/style' // UButton（insert-image-popup URL 插入）
 import '@veltra/desktop/components/icon/style' // UIcon（sheet-toolbar / sheet-tabs）
 import './style.scss'