Excelize 发布 2.7.1 版本,Go 语言 Excel 文档基础库
Excelize 是 Go 语言编写的用于操作 Office Excel 文档基础库,基于 ECMA-376,ISO/IEC 29500 国际标准。可以使用它来读取、写入由 Microsoft Excel™ 2007 及以上版本创建的电子表格文档。支持 XLAM / XLSM / XLSX / XLTM / XLTX 等多种文档格式,高度兼容带有样式、图片(表)、透视表、切片器等复杂组件的文档,并提供流式读写 API,用于处理包含大规模数据的工作簿。可应用于各类报表平台、云计算、边缘计算等系统。入选 2020 Gopher China - Go 领域明星开源项目(GSP)、2018 年开源中国码云最有价值开源项目 GVP (Gitee Most Valuable Project),目前已成为 Go 语言最受欢迎的 Excel 文档基础库。
开源代码
GitHub: github.com/xuri/excelize
Gitee: gitee.com/xurime/excelize
中文文档: xuri.me/excelize/zh-hans
2023 年 4 月 10 日,社区正式发布了 2.7.1 版本,该版本包含了多项新增功能、错误修复和兼容性提升优化。下面是有关该版本更新内容的摘要,完整的更改列表可查看 changelog。
此版本中最显著的变化包括:
兼容性提示
移除了
ChartLine
数据类型中的Color
字段使用
RichTextRun
数据类型代替ShapeParagraph
使用
Fill
代替Shape
数据类型中的Color
字段移除了已导出的数据类型
AutoFilterListOptions
将数据类型
TableOptions
重命名为Table
添加图表函数
AddChart
改为使用ChartType
类型枚举值指定图表类型修改了 7 个函数的签名,具体更改详见官方文档中的更新说明
新增功能
新增函数
SetSheetDimension
与GetSheetDimension
以支持设置与获取工作表已用区域,相关 issue #1463创建样式函数
NewStyle
现已支持 17 种渐变填充样式增加创建样式数量上限至 65430
通过
AddPicture
添加图片时,现已允许插入 BMP 格式图片函数
GetPictures
支持读取被添加至同一单元格中的多张图片设置条件格式函数
SetConditionalFormat
支持设置带有“如果为真则停止”和“图标集”条件的条件格式规则设置条件格式函数
SetConditionalFormat
支持设置在条件格式中使用带有纯色填充样式的数据条,并支持指定数据条的颜色,相关 issue #1462添加图表函数
AddChart
支持设置图表中各个数据系列使用自定义填充颜色,相关 issue #1474添加图表函数
AddChart
支持设置气泡图图表中各个系列气泡的大小添加图表函数
AddChart
支持设置子母饼图和复合条饼图中第二绘图区域的数据系列添加图表函数
AddChart
支持为图表中数据标签设置自定义数字格式,相关 issue #1499创建表格函数
AddTable
支持在创建表格时指定是否包含标题行创建表格函数
AddTable
创建表格时增加对表格名称的校验,并导出了错误常量ErrTableNameLength
,相关 issue #1468函数
AutoFilter
支持为筛选范围内的多个列设置筛选条件计算单元格的值函数
CalcCellValue
现已支持指定是否为公式计算结果应用数字格式计算单元格的值函数
CalcCellValue
对于以下公式函数加入了双字节字符的支持:LEFT, LEN, LENB, MID, MIDB, RIGHT 和 RIGHTB,相关 issue #1476计算单元格的值函数
CalcCellValue
函数对于存在错误的公式将在计算结果中返回公式错误代码,并将详细错误信息在 error 数据类型的返回值中返回,相关 issue #1490对输入图片文件的扩展名调整为大小写不敏感,相关 issue #1503
使用流式写入器流式按行赋值时,对于值为 nil 的单元格将会跳过生成该单元格,相关 issue #756
获取超链接
GetCellHyperLink
函数支持读取合并单元格中的超链接添加了新的导出类型
ChartType
以表示图表类型枚举
兼容性提升
兼容带有函数组的工作簿
兼容带有严格模式 XML 命名空间地址的工作簿主题,相关 issue #1447
提高了与文档内部不含工作簿关系部件工作簿的兼容性,以修复打开此类工作簿可能出现的 panic
问题修复
修复了特定情况下读取日期时间类型单元格的值存在精度误差的问题
修复了特定情况下当修改原本存储了日期时间类型的单元格为文本类型值,修改后单元格数据类型有误的问题,解决 issue #1464
修复了部分情况下公式计算结果为空的问题,解决 issue #1469
修复了设置数据条类型条件格式时,指定自定义最大/最小值无效的问题,解决 issue #1492
修复了打开行高或列宽为 0 的工作表,保存后行高列宽设置失效的问题,解决 issue #1461
提高了读取带有空白字符共享字符串表索引值的兼容性,解决 issue #1508
性能优化
提高了应用带有自定义月份数字格式的速度,相关 issue #1455
大幅提高了对于带有合并单元格工作表的处理速度,相关 issue #1448
其他
Go Excelize 提供了支持 WebAssembly / Javascript 环境的 excelize-wasm NPM 包
Go Modules 依赖模块更新
单元测试与文档更新
优化内部变量与函数命名
包含简体中文、英语、法语、俄语、日语、韩语、阿拉伯语、德语和西班牙语的多国语言文档网站更新
致谢
感谢 Excelize 的所有贡献者,以下是为此版本提交代码的贡献者列表:
liron-l (Liron Levin)
nathj07 (Nathan Davies)
Josh-Weston (Josh Weston)
jaby
FlowingSPDG (Shugo Kawamura)
barismar (Baris Mar Aziz)
doingNobb (张涛)
rpoetrap (Rizki Putra)
huangshaokun
CHANTXU64 (ChantXu64)
playGitboy
版权声明: 本文为 InfoQ 作者【xuri】的原创文章。
原文链接:【http://xie.infoq.cn/article/8d90dc7d5a6d0930c7def3a83】。
本文遵守【CC-BY 4.0】协议,转载请保留原文出处及本版权声明。
评论