Excel 文档字段

下载 .tgz

版本v0.1.0

大小3.0 MB

分类其他

平台全平台

运行方式纯前端（无独立进程）

下载量4

SHA-256c7a13532751ff7eaa26bd8b15d03cd8aae23164edce7dcaae6b847d2b2ffa1b3

「插件自定义字段」官方示范插件：单元格里放一份 Excel 文档。人物卡等复杂信息按字段级 Excel 模版填写，网格里只显示摘要文本。市场插件（非内置），按需安装。

存储形态（不需协同，全 JSON 内联）

• 字段 = 基础文本字段（type=1），身份挂 properties.xPluginField（typeKey excelDoc）。
• cell 值：{"summary":"张三 · 武力92","tplRev":2,"doc":{ ...IWorkbookData... }}
  • summary 首键 → 按基础文本排序 ≈ 按摘要排序；没配摘要格时保存自动抓第一个 sheet 前几个非空值，宿主侧另有「📄」占位兜底
  • doc = Univer workbook snapshot 全文内联，无资产间接层
  • 宿主 validation.maxBytes = 1MB 硬闸
• 模版：config.template 内联 snapshot；tplRev 修订号，cell 落后时编辑器提示重建。

Univer 与 xlsx（全开源，零服务零授权）

• 编辑：@univerjs/presets 的 core preset（开源，纯前端跑 iframe）；主题跟随宿主 明暗 + 品牌主色梯度。
• xlsx 导入/导出：本地 exceljs（MIT）转换（ui/src/convert/），纯浏览器端—— 值/公式/合并/列宽行高/字体/底色/对齐/边框/数字格式保留；图表/透视/宏不保留。 不依赖 Univer Pro / universer 服务。

构建 / 安装 / 测试

pnpm --filter @xinghan/plugin-excel-field ui:build     # → ui/dist
pnpm --filter @xinghan/plugin-excel-field typecheck
pnpm --filter @xinghan/plugin-excel-field test

# 本地安装到 ~/xinghan/plugins（dev/prod 桌面都从这里热加载）
pnpm plugin:install packages/plugins/excel-field

市场分发：node scripts/plugin-pack.mjs packages/plugins/excel-field 上架 catalog。

怎么安装

1. 下载安装包 —— 点上面的按钮拿到 xinghan.excel-field.tgz。要在内网用，就把这个文件拷进去。
2. 打开客户端 —— 右上角 插件市场 → 右上角 「从本地安装」。
3. 选中文件 —— 解包到 ~/xinghan/plugins/ 后热加载，不用重启应用。

完整的内网 / 离线说明见 离线与内网安装。