在使用vite等打包工具的网页工程里,安装univer sheets core预设、创建容器并调用createuniver,即可嵌入电子表格。需要保留编辑结果时,用工作簿的save()生成json快照,并在下次初始化时用快照创建工作簿,不能先建空白表再把它覆盖掉。
安装预设并准备容器
pnpm add @univerjs/presets @univerjs/preset-sheets-core
相关@univerjs协调发布包保持同一版本线,并提交包管理器锁文件。此例使用开源Sheets功能和英文语言包,不需要Server SDK或商业许可证;不等于同时获得XLSX转换、云端协作或商业AI功能。
<button id="save" disabled>保存当前工作簿</button> <div id="app" style="height:80vh"></div>

Univer官方表格编辑器示例
初始化时选择恢复快照或创建空表
import { UniverSheetsCorePreset } from '@univerjs/preset-sheets-core'
import EnUS from '@univerjs/preset-sheets-core/locales/en-US'
import { createUniver, LocaleType, mergeLocales } from '@univerjs/presets'
import '@univerjs/preset-sheets-core/lib/index.css'
const { univer, univerAPI } = createUniver({
locale: LocaleType.EN_US,
locales: { [LocaleType.EN_US]: mergeLocales(EnUS) },
presets: [UniverSheetsCorePreset({ container: 'app' })],
})
const key = 'my-univer-workbook'
let snapshot
try {
const saved = localStorage.getItem(key)
snapshot = saved ? JSON.parse(saved) : undefined
} catch { console.warn('无法读取或解析快照,本次打开空白工作簿') }
univerAPI.createWorkbook(snapshot ?? {})
const button = document.querySelector<htmlbuttonelement>('#save')!
const steady = univerAPI.Enum.LifecycleStages.Steady
const listener = univerAPI.addEvent(univerAPI.Event.LifeCycleChanged, ({ stage }) => {
if (stage >= steady) button.disabled = false
})
if (univerAPI.getCurrentLifecycleStage() >= steady) button.disabled = false
button.addEventListener('click', () => {
const workbook = univerAPI.getActiveWorkbook()
if (!workbook) return
try { localStorage.setItem(key, JSON.stringify(workbook.save())) }
catch { window.alert('保存失败,请检查浏览器存储空间或权限') }
})</htmlbuttonelement>

Univer官方应用示例,展示表格与业务界面的组合
检查持久化范围
编辑几个单元格后点击保存,再刷新页面确认内容恢复。localStorage只属于当前浏览器和站点来源,不会自动同步到其他电脑;处理敏感业务数据时应由应用实现适当的服务端存储和访问控制。快照保存与XLSX文件导入导出是不同能力,不能把JSON改扩展名当成Excel文件。
一个基于官方 Mailtrap Node.js SDK 构建的 ASE 技能,用于发送事务邮件并与 Mailtrap 沙盒或生产流程协作。它非常适合需要 API 驱动邮件投递、测试邮箱验证和结构化消息自动化的代理工作流。
Steady表示标准界面进入相应生命周期阶段,并不保证所有异步资源或公式计算都完成。若要在自动改公式后立即保存计算结果,还需等待公式结果应用事件。组件卸载时移除listener并调用univer.dispose(),避免反复挂载留下旧实例。










