Excelize v2.7.1

《Excelize 权威指南》图书出版，网上购买方式：人民邮电出版社 |异步社区 |天猫 |京东 |当当 |微店 |抖音 |拼多多

版本说明

此版本中最显著的变化包括：

兼容性提示

  • 移除了 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

性能优化

  • 提高了应用带有自定义月份数字格式的速度，相关 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