# @christophervr/xlsx-react-viewer 中文文档 规范地址：https://npmcn.com/package/%40christophervr/xlsx-react-viewer/ 版本：1\.4\.1 npm 元数据更新时间：2026-11-06T21:15:41.228Z 中文译文更新时间：2026-11-09T15:07:37.421Z 软件包许可：Apache-2\.0 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40christophervr/xlsx-react-viewer 原文对照：https://npmcn.com/package/%40christophervr/xlsx-react-viewer/?lang=original 项目主页：https://christophervr.github.io/ooxml/xlsx/ 源码仓库：https://github.com/ChristopherVR/ooxml ## 关键信息（来自 npm 元数据） - 包体积（解压后）：47.7 kB，6 个文件 - 模块格式：ES Module - TypeScript 类型：包内自带 - 运行依赖：3 个 - peer 依赖：react \>=18 - 首次发布：2026-10-02T13:31:01.031Z - 最新版本发布：2026-11-06T21:15:40.767Z - 近 30 天下载量：2443（2026-10-10 至 2026-11-08，npm 官方下载统计） - 已发布版本数：25（近 12 个月 25 个） ## 中文简介 Excel 电子表格编辑器的响应组件。 自成一体:包括编辑器,公式引擎和遗留的.xls读取器. ## 安装 ```sh npm install @christophervr/xlsx-react-viewer ``` 也可以使用：`pnpm add @christophervr/xlsx-react-viewer`、`yarn add @christophervr/xlsx-react-viewer`、`bun add @christophervr/xlsx-react-viewer` ## README # @christophervr/xlsx-反应-查看器 [![npm version](https://img.shields.io/npm/v/%40christophervr%2Fxlsx-react-viewer.svg)](https://www.npmjs.com/package/@christophervr/xlsx-react-viewer) [![license](https://img.shields.io/npm/l/%40christophervr%2Fxlsx-react-viewer.svg)](https://github.com/ChristopherVR/ooxml/blob/main/viewers/xlsx/LICENSE) [![types](https://img.shields.io/npm/types/%40christophervr%2Fxlsx-react-viewer.svg)](https://www.npmjs.com/package/@christophervr/xlsx-react-viewer) > React的浏览器Excel电子表格编辑器,使用一个共享编辑器和Cononical OOXML文档引擎. [现场演示](https://christophervr.github.io/ooxml/xlsx/demo/) | [无](https://www.npmjs.com/package/@christophervr/xlsx-react-viewer) | [完整文档](https://christophervr.github.io/ooxml/xlsx/) | [来源](https://github.com/ChristopherVR/ooxml/tree/main/viewers/xlsx) 部分 [氧化物](https://github.com/ChristopherVR/ooxml#readme)数字 : [办公室](https://github.com/ChristopherVR/ooxml#ooxml-office-the-whole-suite-in-one-app) • 妇女 [单词](https://github.com/ChristopherVR/ooxml/tree/main/viewers/docx#readme) • 妇女 **[埃克塞尔](https://github.com/ChristopherVR/ooxml/tree/main/viewers/xlsx#readme)** • 妇女 [电源点](https://github.com/ChristopherVR/ooxml/tree/main/viewers/pptx#readme) • 妇女 [维西奥](https://github.com/ChristopherVR/ooxml/tree/main/viewers/visio#readme) • 妇女 [打开小组](https://github.com/ChristopherVR/ooxml/tree/main/viewers/teams#readme) • 妇女 [核心](https://github.com/ChristopherVR/ooxml/tree/main/src/core#readme) ## 安装 ```bash npm install @christophervr/xlsx-react-viewer ``` 使用此软件包宣布的框架对等点 : `react` (单位:千美元)`>=18`) (中文(简体) ). 现有框架应用程序通常已经提供. 软件包将它的编辑器UI和适配器捆绑. 核心模式和共享控制 被安装为正常的注册依赖,并重新出口模型API. 一个取景器包就够了;不需要单独安装核心. ## 快开始 ```tsx import { useState } from 'react'; import { createWorkbook, SpreadsheetEditor } from '@christophervr/xlsx-react-viewer'; export function Editor() { const [workbook, setWorkbook] = useState(() => createWorkbook()); return ; } ``` 在浏览器中挂载并给主机一个高度. 每个编辑包使用一个 应用程序:每个编辑器都登记相同的自定义元素. ## 特征 | 特性 | 说明 | | --- | --- | | 编辑 | 共享网格,丝带,公式栏,工作表标签和工作簿更改事件. | | 文件 | XLSX,XLSM,XLTX,遗产XLS和CSV通过核心加载. | | 型号 | `createWorkbook`, (中文(简体) ), `loadWorkbook`, (中文(简体) ), `saveXlsx` 和软件包条目的核心类型. | | 框架 | 一样 `` 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`。无 标题栏、丝带、后台或对话框被挂起。 见 [组件指南](https://christophervr.github.io/ooxml/xlsx/building-blocks)。 。 。 . ## 限制 这是一个早期的编辑器,没有 Microsoft Excel 等值或保证无损失 保存不支持的特性。 Legacy XLS 输入保存为 XLSX. 关键表, 切片和花花纹不能编辑;宏永远不会执行. 审查核心 诊断和特征指南先依赖保存. ## 文档 [框架指南](https://christophervr.github.io/ooxml/xlsx/frameworks/react) | [约束](https://christophervr.github.io/ooxml/xlsx/bindings) ## 隐私和网络使用 Excel软件包在打开,渲染,编辑或保存文档时不提出网络请求:链接图片没有被取出,链接数据没有被刷新,字体只来自该设备(没有从Google字体或任何其他字体服务下载到任何内容). 超链接只有在读者跟随时才打开. 没有东西收集分析或遥测。 见 [简 单](https://github.com/ChristopherVR/ooxml/blob/main/PRIVACY.md)。 。 。 . ## 许可证 阿帕奇2.0 (英语). ## 一驾驱动器集成 使用可选共享 `ooxml-core/embedding/onedrive` 连接到主机提供的微软 注册。 见 [办公包和综合参考资料](https://github.com/ChristopherVR/ooxml/blob/main/docs/onedrive-integration.md#excel-xlsx) 用于此产品的负载/保存 API,本地存储接线,共享权限和冲突恢复. 这个 [测试指南](https://github.com/ChristopherVR/ooxml/blob/main/docs/onedrive-testing.md) 将测试-局部运输与活的微软接受分离. 没有运送模拟服务; OneDrive存储器不提供Microsoft Office的同名或自动文档合并. ## 常见问题 ### @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 和提交记录判断。