Angular 电子表格组件 | ng-hub-ui-spreadsheet

可编辑的 Angular 电子表格,支持 Excel 键盘操作、矩形选区、可与 Excel 双向往返的剪贴板、冻结窗格和合并单元格。MIT 许可,无障碍,没有付费版。

最后更新 2026年11月15日

概览

团队为何搜索这个库

当界面需要让用户在单元格中输入和粘贴,又不想为表格付费、也不想放弃屏幕阅读器支持时,请使用 ng-hub-ui-spreadsheet。

安装

npm install ng-hub-ui-spreadsheet

跳转到

适用于

  • 发票和订单明细行
  • 价格和费率表
  • 工时表和排班表
  • 批量数据修正

关于 spreadsheet

ng-hub-ui-spreadsheet is a standalone Angular component that renders rows and columns you already hold and reports what the reader did to them. It never writes to your data. It brings in-cell editing with Excel's keyboard, rectangular selection by shift or dragging, a clipboard that writes and reads both flavours so figures survive a journey between locales, frozen rows and columns, merged blocks, and a save state per cell. It carries real grid semantics — role="grid", row and column indices, a roving tab stop — and depends on nothing outside Angular: its grid primitives live in ng-hub-ui-utils rather than @angular/cdk. 公式既可以用列别名写,也可以用坐标写;长表格在两个方向上只画视口覆盖到的部分;整张表可以导出成真正的 .xlsx 或 CSV,再导回来——zip 和 XML 都在这里写,所以这些都不带来任何依赖。

功能指南

该库尚未记录任何功能指南。

核心特性

最近更改

Version 22.13.0 - 11/15/26, 12:00 AM

added: hubSpreadsheetHeader 使用你自己的模板绘制列标题,例如带编辑按钮的名称。其中的按钮、链接或输入框可以按下而不会拖动列;标题保留其宽度、冻结和全选复选框。

Version 22.12.2 - 11/4/26, 12:00 AM

fixed: 运算产生误差的数字会像电子表格一样显示:单元格、复制内容和编辑器中的数字都按 15 位有效数字书写,因此 3260.4 − 3120.8 显示为 139.6。存储的值不变。

Version 22.12.1 - 11/4/26, 12:00 AM

fixed: 末端对齐的列表列或日期列会在单元格和表头中为下拉箭头留出空间,箭头不再遮住值的末尾。

fixed: 列表打开时保持同一个箭头:原生列表隐藏浏览器自带的箭头,在同一位置保留表格的箭头。

Version 22.12.0 - 11/4/26, 12:00 AM

added: editCell 从代码中打开单元格的编辑器,并等待刚添加的行,因此添加备注的按钮会让读者直接在其中输入。

added: Alt+Enter(Mac 上为 Option+Enter)打开同时可输入的单元格的操作,Enter 仍然打开其输入框。

Version 22.11.0 - 11/4/26, 12:00 AM

added: 列上的 append 在主值之后显示从短列表中选择的第二个值:数量的单位或折扣的类型。对它的修改以键为 append.key 的 commit 到达,复制、粘贴和填充都会带上两部分。

Version 22.10.0 - 11/4/26, 12:00 AM

added: focusCell 可在代码中把光标放到单元格上,并等待刚添加的行,因此点击“添加行”按钮后即可直接在新行中输入。

added: 启用 fillHandle 时,Ctrl+D(Mac 上为 Cmd+D)向下填充:把选区首行复制到下面各行,只发出一次 filled。

added: 比表格更长的粘贴会在 structure 允许时通过 insertRequested 请求缺少的行,并在这些行绘制后整体粘贴。

added: checkAll 在是/否列的表头放一个复选框,可一次勾选所有行;各行不一致时显示为部分选中,并只发出一次 filled。

changed: 单元格的 title 改为显示在表格自己的提示框中,鼠标悬停和键盘到达时都会出现,而不再使用键盘看不到的原生 title。

changed: 单元格模板会保留单元格自身的控件:是/否列保留复选框,模板显示在旁边;列表或日期列保留打开它的箭头。

fixed: 空行与有内容的行一样高,不再缩成只剩内边距。

fixed: 位于边框下角的单元格会沿着圆角显示,光标轮廓不再超出边框。

Version 22.9.1 - 11/3/26, 12:00 AM

changed: 表格的标签改用 hubTranslate,不再使用已弃用的 translate 管道。宿主无需任何改动。

Version 22.9.0 - 11/3/26, 12:00 AM

added: 可用 Alt+Shift 加上下方向键从键盘移动一行,像放下时一样通过 rowMoved 报告,并由实时区域朗读它的去向。

fixed: 在自带编辑器或展开行中键入的按键归它们所有:选择器的搜索框可以输入了,方向键移动的是其中的文本光标而不是表格光标。

fixed: 自带编辑器像表格自己的编辑器一样,在按 Escape、按 Tab 和焦点离开时关闭,选中答案的那次 Enter 也不再打开下面的单元格。上下文新增 draft,供有内容需要确认的编辑器使用。

fixed: 单元格无法保存的文本在读者离开时不再丢失:单元格会保留它,加框并说明原因,invalidDrafts 会告知宿主。

Version 22.8.0 - 10/28/26, 12:00 AM

added: 行现在可以像列一样拖到其他位置。悬停在行上时,其起始边缘会出现一个拖动手柄;悬停在列上时,其表头上方也会出现一个。放下时通过 rowMoved 报告,已按新顺序排列,结构与 columnMoved 相同。

changed: 移动过程现在可见:副本跟随指针,经过的行或列会让开以腾出位置,靠近边缘时表格会自动滚动。按住鼠标按钮时手柄会隐藏。

Version 22.7.0 - 10/27/26, 12:00 AM

changed: 单元格的校验消息会在悬停或键盘移到该单元格时显示在红色提示框中,取代浏览器的灰色 title。

changed: 在单个单元格上按 Backspace 或 Delete 会清空它并打开编辑器,便于立即输入新值。多个单元格仍通过 cleared 清空。

changed: 光标和选区仅在表格拥有焦点时绘制,离开后的表格不再看起来可以直接输入。

added: 在单元格中打开的表单字段会在提示框中显示错误,行高保持不变。

Version 22.6.0 - 9/30/26, 12:00 AM

added: 单元格可以说明它空在哪里:placeholder 是在该单元格为空时、悬停显示的提示,回退到列自身的。

Version 22.5.0 - 9/29/26, 12:00 AM

changed: hubSpreadsheetCellAction 现在也可以接受行的函数:一列中可以只有部分单元格可打开,Enter 留给它们,其余交给表格。

Version 22.4.0 - 9/28/26, 12:00 AM

added: 行在原位展开,配合 expansion 与 expandedRow:把该行在数字背后所包含的内容绘制在该行自身的下方,而不是放在其上方的对话框中。

added: 可打开某物的单元格,由其自身的模板声明:hubSpreadsheetCellAction 为单元格保留 Enter,按下时通过 opened 通知。

added: 列和行按大纲折叠,与 Excel 的分组相同:某一层级的连续列或行用一个按钮折叠,折叠哪些组由你决定。

Version 22.2.0 - 9/27/26, 12:00 AM

added: 由公式计算而非输入的单元格,其右上角带有一个小 fx,指针悬停时显示。它有自己的两个变量:--hub-spreadsheet-formula-bg 和 --hub-spreadsheet-formula-color。

fixed: 坐标仅在公式时出现。编辑普通单元格不再在其周围画出字母和数字的边框——它们等待第一个 =。

fixed: 坐标绘制在表格边框之外。边框移开以腾出空间,徽标浮在其外,因此边框留在徽标与表格之间。

fixed: 可放入公式的内容列表会跟随边框。输入第一个 = 会移动表格,列表在移动后重新定位,挂在单元格现在的位置。

Version 22.1.0 - 9/27/26, 12:00 AM

added: 一次多个区块:按住 Ctrl 点击会把正在画的矩形收起来并另起一个,Delete 会全部清空,selectionRangesChange 会报告全部。只有区块能拼成表时才复制,选中多个时填充手柄会消失。

added: hub-spreadsheet-theme:一次 include 就能设置表格的 65 个可主题化变量,所有参数都是可选的,只输出你传进来的那些。

added: 公式以彩色书写:输入时,函数、列别名、单元格引用和带引号的字符串各以自己的颜色绘制,使语法一目了然。

added: 指向单元格以写入其引用:书写公式时,按下或拖过其他单元格会把所指内容插入到光标处的公式中——单个为 B3,矩形为 B3:D7——而不会提交文本。

added: 当单元格打开时,列字母和行号会出现:表格稍微移开,腾出的空间里浮出徽标——每列上方是字母和别名,左侧是行号——这样就能从表上读出引用而不用去数,并带有简短的出场动画。

fixed: 现在从外部给表格设主题真的有用了。那些变量原来声明在宿主元素上,而这会盖过任何继承而来的值,于是 :root、外层类名和按路由设置的主题都被默默忽略。现在改成在用到的地方读取,默认值没有变化。

fixed: 可放入公式的内容列表现在真正可见了。它一直存在,但被工作表的滚动区域以及单元格与页面之间的任何 overflow:hidden 裁剪,因此最后一行上从不出现。现在它固定在窗口上,当下方没有空间时会开在单元格上方。

Version 22.0.0 - 9/27/26, 12:00 AM

added: hub-spreadsheet:单元格内编辑、完整的键盘导航和矩形选区。

added: 与 Excel 双向往返的剪贴板,从 HTML 格式中读取原始数字。

added: 冻结的行和列,从边缘开始计数。

added: 由所有者声明的合并区块,导航和选择时视为一个单元格。

added: 插入和删除请求,受权限控制,别名绝不重复使用。

常见问题

如何把 Excel 的内容粘贴到 Angular 表格而不破坏数字?

读取剪贴板的 HTML 格式,而不只是纯文本。Excel 会把原始数字写在其中的一个属性里;纯文本则是源区域设置所显示的内容,所以 1.234,56 会被解析成文本,或者根据复制来源被解析成 1.23。ng-hub-ui-spreadsheet 两种都会读取,并优先使用原始值。

有免费的 Angular 电子表格组件吗?

ng-hub-ui-spreadsheet 采用 MIT 许可,没有付费版,也没有受限功能。编辑、矩形选区、剪贴板、冻结窗格和合并单元格都包含在这个包里;而大多数表格并非如此,它们的剪贴板和范围选择都放在企业版许可之后。

支持屏幕阅读器吗?

支持。它渲染真正的 role="grid",每个单元格带 aria-colindex,每一行带 aria-rowindex,aria-selected 跟随选区,不可输入的单元格带 aria-readonly,单元格保存时带 aria-busy,并提供唯一的移动制表位和方向键导航。

它需要 @angular/cdk 吗?

不需要。二维导航、矩形选区和键盘映射都在 ng-hub-ui-utils 中,因此安装 spreadsheet 不会引入 Angular 之外的任何东西。