Excelize v2.7.1
《Excelize 权威指南》图书出版,网上购买方式:人民邮电出版社 | 异步社区 | 天猫 | 京东 | 当当 | 微店 | 抖音 | 拼多多
- 发布日期: 2023年4月10日
- GitHub Release: https://github.com/xuri/excelize/releases/tag/v2.7.1
版本说明
此版本中最显著的变化包括:
兼容性提示
- 移除了
ChartLine
数据类型中的Color
字段 - 使用
RichTextRun
数据类型代替ShapeParagraph
- 使用
Fill
代替Shape
数据类型中的Color
字段 - 移除了已导出的数据类型
AutoFilterListOptions
- 将数据类型
TableOptions
重命名为Table
- 添加图表函数
AddChart
改为使用ChartType
类型枚举值指定图表类型 - 修改了以下 7 个函数的签名
- 将
func (f *File) AutoFilter(sheet, rangeRef string, opts *AutoFilterOptions) error
修改为func (f *File) AutoFilter(sheet, rangeRef string, opts []AutoFilterOptions) error
- 将
func (f *File) AddPictureFromBytes(sheet, cell, name, extension string, file []byte, opts *GraphicOptions) error
修改为func (f *File) AddPictureFromBytes(sheet, cell string, pic *Picture) error
- 将
func (f *File) GetPicture(sheet, cell string) (string, []byte, error)
修改为func (f *File) GetPictures(sheet, cell string) ([]Picture, error)
- 将
func (f *File) AddVBAProject(bin string) error
修改为func (f *File) AddVBAProject(file []byte) error
- 将
func (f *File) GetComments() (map[string][]Comment, error)
修改为func (f *File) GetComments(sheet string) ([]Comment, error)
- 将
func (f *File) AddTable(sheet, rangeRef string, opts *TableOptions) error
修改为func (f *File) AddTable(sheet string, table *Table) error
- 将
func (sw *StreamWriter) AddTable(rangeRef string, opts *TableOptions) error
修改为func (sw *StreamWriter) AddTable(table *Table) error
- 将
新增功能
- 新增函数
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
性能优化
其他
- 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