# @bergfreunde/x-data-spreadsheet 中文文档
规范地址：https://npmcn.com/package/%40bergfreunde/x-data-spreadsheet/
版本：2\.0\.75
npm 元数据更新时间：2024-10-11T12:04:23.108Z
中文译文更新时间：2026-11-07T22:56:09.697Z
软件包许可：MIT
本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。
原始 npm 页面：https://www.npmjs.com/package/%40bergfreunde/x-data-spreadsheet
原文对照：https://npmcn.com/package/%40bergfreunde/x-data-spreadsheet/?lang=original
项目主页：https://github.com/bergfreunde/x-spreadsheet#readme
源码仓库：https://github.com/bergfreunde/x-spreadsheet
## 关键信息（来自 npm 元数据）
- 包体积（解压后）：772 kB，114 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- 运行依赖：1 个
- 首次发布：2021-11-10T14:54:36.657Z
- 最新版本发布：2024-10-11T12:04:22.938Z
- 近 30 天下载量：2493（2026-10-08 至 2026-11-06，npm 官方下载统计）
- 已发布版本数：92（近 12 个月 0 个）
## 中文简介
一个 javascript xpread表
## 安装
```sh
npm install @bergfreunde/x-data-spreadsheet
```
也可以使用：`pnpm add @bergfreunde/x-data-spreadsheet`、`yarn add @bergfreunde/x-data-spreadsheet`、`bun add @bergfreunde/x-data-spreadsheet`
## README
# x 电子表格
[](https://www.npmjs.org/package/x-data-spreadsheet) [](https://npmjs.org/package/x-data-spreadsheet) [](https://npmjs.org/package/x-data-spreadsheet) [](https://travis-ci.org/myliang/x-spreadsheet) [](https://codecov.io/gh/myliang/x-spreadsheet)   [](https://gitter.im/x-datav/spreadsheet?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
> 基于网络的 JavaScript 电子表格
[](https://github.com/myliang/x-spreadsheet)
## 文档
- 内
- [日-克纳](https://hondrytravis.github.io/x-spreadsheet-doc/)
## 光盘N
```html
```
## 国家预防机制
```shell
npm install x-data-spreadsheet
```
```html
```
```javascript
import Spreadsheet from "x-data-spreadsheet";
// If you need to override the default options, you can set the override
// const options = {};
// new Spreadsheet('#x-spreadsheet-demo', options);
const s = new Spreadsheet("#x-spreadsheet-demo")
.loadData({}) // load data
.change(data => {
// save data to db
});
// data validation
s.validate()
```
```javascript
// default options
{
mode: 'edit', // edit | read
showToolbar: true,
showGrid: true,
showContextmenu: true,
view: {
height: () => document.documentElement.clientHeight,
width: () => document.documentElement.clientWidth,
},
row: {
len: 100,
height: 25,
},
col: {
len: 26,
width: 100,
indexWidth: 60,
minWidth: 60,
},
style: {
bgcolor: '#ffffff',
align: 'left',
valign: 'middle',
textwrap: false,
strike: false,
underline: false,
color: '#0a0a0a',
font: {
name: 'Helvetica',
size: 10,
bold: false,
italic: false,
},
},
}
```
## 导入% 1 导出 xlsx
[https://github.com/SheetJS/sheetjs/tree/master/demos/xspreadsheet#保存-数据 互联网档案馆的存檔,存档日期2013-12-02](https://github.com/SheetJS/sheetjs/tree/master/demos/xspreadsheet#saving-data)
谢谢 [https://github.com/SheetJS/sheetjs (中文(简体) )](https://github.com/SheetJS/sheetjs)
## 捆绑事件
```javascript
const s = new Spreadsheet("#x-spreadsheet-demo")
// event of click on cell
s.on('cell-selected', (cell, ri, ci) => {});
s.on('cells-selected', (cell, { sri, sci, eri, eci }) => {});
// edited on cell
s.on('cell-edited', (text, ri, ci) => {});
```
## 更新单元格文本
```javascript
const s = new Spreadsheet("#x-spreadsheet-demo")
// cellText(ri, ci, text, sheetIndex = 0)
s.cellText(5, 5, 'xxxx').cellText(6, 5, 'yyy').reRender();
```
## 获得单元格和单元格样式
```javascript
const s = new Spreadsheet("#x-spreadsheet-demo")
// cell(ri, ci, sheetIndex = 0)
s.cell(ri, ci);
// cellStyle(ri, ci, sheetIndex = 0)
s.cellStyle(ri, ci);
```
## 国际化
```javascript
// npm
import Spreadsheet from 'x-data-spreadsheet';
import zhCN from 'x-data-spreadsheet/dist/locale/zh-cn';
Spreadsheet.locale('zh-cn', zhCN);
new Spreadsheet(document.getElementById('xss-demo'));
```
```html
```
## 特征
- 撤销重做( R)
- 绘图格式
- 清晰格式
- 格式
- 字体
- 字体大小
- 字体粗体
- 字体斜体
- 下划线
- 罢工
- 文本颜色
- 填充颜色
- 边框
- 合并单元格
- 对齐
- 文本包装
- 冻结单元格
- 职能
- 调整行高和相距大小
- 复制、剪接、粘贴
- 自动填充
- 插入行,列
- 删除行, 列
- 隐藏行, 列
- 多个工作表
- 打印
- 数据验证
## 发展
```sheel
git clone https://github.com/myliang/x-spreadsheet.git
cd x-spreadsheet
npm install
npm run dev
```
打开浏览器访问 http://127.0.0.1:8080.
## 浏览器支持
现代浏览器(chrome, firefox, Safari).
## 自由主义
麻省理工学院
## 常见问题
### @bergfreunde/x-data-spreadsheet 是什么？
一个 javascript xpread表
### 如何安装 @bergfreunde/x-data-spreadsheet？
在项目目录运行 npm install @bergfreunde/x-data-spreadsheet，或使用 pnpm add / yarn add / bun add。
### @bergfreunde/x-data-spreadsheet 支持 TypeScript 吗？
支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。
### @bergfreunde/x-data-spreadsheet 支持 ESM 还是 CommonJS？
以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。
### @bergfreunde/x-data-spreadsheet 可以商用吗？
@bergfreunde/x-data-spreadsheet 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。
### @bergfreunde/x-data-spreadsheet 的下载量有多少？
根据 npm 官方下载统计，@bergfreunde/x-data-spreadsheet 在 2026/10/08 – 2026/11/06 这 30 天内被下载 2,493 次，日均约 83 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。
### @bergfreunde/x-data-spreadsheet 还在维护吗？
最新版本 2\.0\.75 发布于 2024/10/11（2 年前）；至今共发布 92 个版本，其中过去 12 个月发布了 0 个；首次发布于 2021/11/10。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。