@christophervr/xlsx-react-viewer

中文文档
1.4.1发布于 2026/11/07Apache-2.0TypeScriptES Module构建来源已验证近 30 天下载 2443

Excel 电子表格编辑器的响应组件。 自成一体:包括编辑器,公式引擎和遗留的.xls读取器.

中文使用文档
文档目录10 节
  1. 安装
  2. 快开始
  3. 特征
  4. API 密码
  5. 构件
  6. 限制
  7. 文档
  8. 隐私和网络使用
  9. 许可证
  10. 一驾驱动器集成

@christophervr/xlsx-反应-查看器

npm version license types

React的浏览器Excel电子表格编辑器,使用一个共享编辑器和Cononical OOXML文档引擎.

现场演示 | 无 | 完整文档 | 来源

部分 氧化物数字 : 办公室 • 妇女 单词 • 妇女 埃克塞尔 • 妇女 电源点 • 妇女 维西奥 • 妇女 打开小组 • 妇女 核心

安装

npm install @christophervr/xlsx-react-viewer

使用此软件包宣布的框架对等点 : react (单位:千美元)>=18) (中文(简体) ). 现有框架应用程序通常已经提供.

软件包将它的编辑器UI和适配器捆绑. 核心模式和共享控制 被安装为正常的注册依赖,并重新出口模型API. 一个取景器包就够了;不需要单独安装核心.

快开始

import { useState } from 'react';
import { createWorkbook, SpreadsheetEditor } from '@christophervr/xlsx-react-viewer';

export function Editor() {
    const [workbook, setWorkbook] = useState(() => createWorkbook());
    return <SpreadsheetEditor workbook={workbook} onWorkbookChange={setWorkbook} />;
}

在浏览器中挂载并给主机一个高度. 每个编辑包使用一个 应用程序:每个编辑器都登记相同的自定义元素.

特征

特性说明
编辑共享网格,丝带,公式栏,工作表标签和工作簿更改事件.
文件XLSX,XLSM,XLTX,遗产XLS和CSV通过核心加载.
型号createWorkbook, (中文(简体) ), loadWorkbook, (中文(简体) ), saveXlsx 和软件包条目的核心类型.
框架一样 <xlsx-editor> UI在6个薄适配器后面.

API 密码

共享选项类型, loadWorkbook 财务报告和审定财务报表 detectWorkbookFormat 导出助手 从包裹。 框架处理被曝光 load, (中文(简体) ), save 财务报告和审定财务报表 download编辑 香草包用品 mountEditor(container, options) 无框架 生命周期管理. ooxml-core 财务报告和审定财务报表 ooxml-ui 常规 依赖性。 解析,公式,编辑和网格计算在核心中直播.

构件

在网格周围建立自己的UI,使用 useViewerBuildingBlocks 与 SpreadsheetCanvas 财务报告和审定财务报表 选项 Toolbar, (中文(简体) ), FormulaBar 财务报告和审定财务报表 SheetTabs钩子返回 canvasProps, (中文(简体) ), toolbarProps (国家, enabled 用于格式化、撤销、重做、公式条目和 工作表导航, loading, (中文(简体) ), error, (中文(简体) ), mode, (中文(简体) ), dirty, (中文(简体) ), selection, (中文(简体) ), collaboration 财务报告和审定财务报表 editError,并收回主机调用,例如 onOpenShareDialog 财务报告和审定财务报表 onValidationError编辑 表面只读直到您通过 canEdit: true。无 标题栏、丝带、后台或对话框被挂起。 见 组件指南。 。 。 .

限制

这是一个早期的编辑器,没有 Microsoft Excel 等值或保证无损失 保存不支持的特性。 Legacy XLS 输入保存为 XLSX. 关键表, 切片和花花纹不能编辑;宏永远不会执行. 审查核心 诊断和特征指南先依赖保存.

文档

框架指南 | 约束

隐私和网络使用

Excel软件包在打开,渲染,编辑或保存文档时不提出网络请求:链接图片没有被取出,链接数据没有被刷新,字体只来自该设备(没有从Google字体或任何其他字体服务下载到任何内容). 超链接只有在读者跟随时才打开. 没有东西收集分析或遥测。 见 简 单。 。 。 .

许可证

阿帕奇2.0 (英语).

一驾驱动器集成

使用可选共享 ooxml-core/embedding/onedrive 连接到主机提供的微软 注册。 见 办公包和综合参考资料 用于此产品的负载/保存 API,本地存储接线,共享权限和冲突恢复. 这个 测试指南 将测试-局部运输与活的微软接受分离. 没有运送模拟服务; OneDrive存储器不提供Microsoft Office的同名或自动文档合并.

版本与发布记录

@christophervr/xlsx-react-viewer 共发布 25 个版本,首次发布于 2026/10/02;过去 12 个月发布了 25 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
1.4.1latest2026/11/072 天前
1.4.02026/11/054 天前
1.3.02026/11/045 天前
1.2.22026/10/2911 天前
1.2.12026/10/2317 天前
1.2.02026/10/2218 天前

关于 @christophervr/xlsx-react-viewer 的常见问题

@christophervr/xlsx-react-viewer 是什么?

Excel 电子表格编辑器的响应组件。 自成一体:包括编辑器,公式引擎和遗留的.xls读取器.

如何安装 @christophervr/xlsx-react-viewer?

在项目目录运行 npm install @christophervr/xlsx-react-viewer,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:react(>=18)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@christophervr/xlsx-react-viewer 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@christophervr/xlsx-react-viewer 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@christophervr/xlsx-react-viewer 可以商用吗?

@christophervr/xlsx-react-viewer 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@christophervr/xlsx-react-viewer 的下载量有多少?

根据 npm 官方下载统计,@christophervr/xlsx-react-viewer 在 2026/10/10 – 2026/11/08 这 30 天内被下载 2,443 次,日均约 81 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@christophervr/xlsx-react-viewer 还在维护吗?

最新版本 1.4.1 发布于 2026/11/07(2 天前);至今共发布 25 个版本,其中过去 12 个月发布了 25 个;首次发布于 2026/10/02。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。