Go-Excelize API 源码阅读（八）——UngroupSheets()
一、Go-Excelize 简介
Excelize 是 Go 语言编写的用于操作 Office Excel 文档基础库，基于 ECMA-376，ISO/IEC 29500 国际标准。可以使用它来读取、写入由 Microsoft Excel™ 2007 及以上版本创建的电子表格文档。支持 XLAM / XLSM / XLSX / XLTM / XLTX 等多种文档格式，高度兼容带有样式、图片(表)、透视表、切片器等复杂组件的文档，并提供流式读写 API，用于处理包含大规模数据的工作簿。可应用于各类报表平台、云计算、边缘计算等系统。使用本类库要求使用的 Go 语言为 1.15 或更高版本。
二、GroupSheets(sheets []string)
func (f *File) GroupSheets(sheets []string) error
复制代码
该 API 的功能是根据给定的工作表名称对工作表进行分组，给定的工作表中需包含默认工作表。
func (f *File) GroupSheets(sheets []string) error { // check an active worksheet in group worksheets var inActiveSheet bool activeSheet := f.GetActiveSheetIndex() sheetMap := f.GetSheetList() for idx, sheetName := range sheetMap { for _, s := range sheets { if s == sheetName && idx == activeSheet { inActiveSheet = true } } } if !inActiveSheet { return ErrGroupSheets } // check worksheet exists var wss []*xlsxWorksheet for _, sheet := range sheets { worksheet, err := f.workSheetReader(sheet) if err != nil { return err } wss = append(wss, worksheet) } for _, ws := range wss { sheetViews := ws.SheetViews.SheetView if len(sheetViews) > 0 { for idx := range sheetViews { ws.SheetViews.SheetView[idx].TabSelected = true } continue } } return nil}
复制代码
整个 API 实现分为两大步骤：
1.在组工作表中找到一个活跃的工作表
activeSheet是活跃的工作表索引。sheetMap := f.GetSheetList()GetSheetList 提供了一个函数，用于获取工作簿的工作表、图表工作表和对话框工作表名称列表。
func (f *File) GetSheetList() (list []string) { wb := f.workbookReader() if wb != nil { for _, sheet := range wb.Sheets.Sheet { list = append(list, sheet.Name) } } return}
复制代码
for idx, sheetName := range sheetMap { for _, s := range sheets { if s == sheetName && idx == activeSheet { inActiveSheet = true } } }
复制代码
这段代码是寻找 sheets 里面是不是有 s 与 idx 等于 activeSheet 的 sheetName 相等。
2.检查工作表是否存在
var wss []*xlsxWorksheet for _, sheet := range sheets { worksheet, err := f.workSheetReader(sheet) if err != nil { return err } wss = append(wss, worksheet) } for _, ws := range wss { sheetViews := ws.SheetViews.SheetView if len(sheetViews) > 0 { for idx := range sheetViews { ws.SheetViews.SheetView[idx].TabSelected = true } continue } }
复制代码
xlsxWorksheet 直接映射命名空间中的工作表元素 http://schemas.openxmlformats.org/spreadsheetml/2006/main。
新建这样一个结构体，然后遍历 sheets，读取每一个 sheet，加入 wss。
然后遍历这些 wss，获取 wss 中每一个 sheet 的视图。
遍历视图，将每一个视图的 TabSelected 置为 true。
三、UngroupSheets()
该 API 的功能是取消工作表分组。
func (f *File) UngroupSheets() error
复制代码
func (f *File) UngroupSheets() error { activeSheet := f.GetActiveSheetIndex() for index, sheet := range f.GetSheetList() { if activeSheet == index { continue } ws, _ := f.workSheetReader(sheet) sheetViews := ws.SheetViews.SheetView if len(sheetViews) > 0 { for idx := range sheetViews { ws.SheetViews.SheetView[idx].TabSelected = false } } } return nil}
复制代码
获取活跃工作表的索引 activeSheet。
然后遍历文件的工作表，只处理活跃工作表。
遍历到活跃工作表的索引时，读取该工作表，将其的每一个视图的 TabSelected 置为 false.
三、结语
这里是老岳，这是 Go 语言相关源码的解读第八篇，我会不断努力，给大家带来更多类似的文章，恳请大家不吝赐教。
评论