Go语言excelize包-02-工作表操作（新建/删除/复制/分组/重命名/设置属性/可见性）

1. 新建工作表

• 语法

func (f *File) NewSheet(sheet string) int

• 示例

见 1.1

2. 删除工作表

func (f *File) DeleteSheet(sheet string)

3. 复制工作表

将第"x"张表的内容，复制到已有的第“y”张表。

• 语法

func (f *File) CopySheet(from, to int) error

• 示例

package main

import (
    "fmt"

    "github.com/xuri/excelize/v2"
)

func main() {
    f := excelize.NewFile()
    // 创建工作表
    indexXiShu := f.NewSheet("西蜀")
    f.NewSheet("东吴")
    f.NewSheet("曹魏")
    // 向表中单元格写入数据
    f.SetCellValue("西蜀", "B2", "刘备")
    f.SetCellValue("西蜀", "B3", "关羽")
    f.SetCellValue("西蜀", "B4", "张飞")
    f.SetCellValue("东吴", "B2", "孙权")
    f.SetCellValue("曹魏", "B2", "曹操")
    //第1张表的内容复制到第2张表（从0号开始计）
    f.CopySheet(1,2)
    // 设置工作簿的默认工作表
    f.SetActiveSheet(indexXiShu)
    // 根据指定路径保存文件
    if err := f.SaveAs("sanGuo.xlsx"); err != nil {
        fmt.Println(err)
    }
}

说明：

• 创建的代码创建了四张表： sheet1（创建工作簿时默认创建）、"西蜀"、“东吴”、“曹魏”
• 从第1张表复制（0号开始计），即复制“西蜀”表
• 复制到第2张表，即复制到“东吴表”
• 如果目标表的值超出了已有表，则不会新创建（什么也不会发生）

• 查看结果
  如下可见，“东吴”表复制了“西蜀”表的内容。且原有内容被覆盖。

  
  
  image.png

4. 工作表分组

4.1 创建组

• 语法

func (f *File) GroupSheets(sheets []string) error

• 示例

err = f.GroupSheets([]string{"西蜀","东吴"})

4.2 删除分组

• 语法

func (f *File) UngroupSheets() error

• 示例

err := f.UngroupSheets()

5. 默认工作表

5.1 设置默认工作表

• 语法

func (f *File) SetActiveSheet(index int)

• 示例

见 1.1

5.2 获取默认工作表

• 语法

func (f *File) GetActiveSheetIndex() int

6. 工作表可见性

6.1 设置工作表可见性

• 语法

func (f *File) SetSheetVisible(sheet string, visible bool) error

visible 的值 true表示可见，flase表示不可见。

• 示例

隐藏东吴表

package main

import (
    "fmt"

    "github.com/xuri/excelize/v2"
)

func main() {
    f := excelize.NewFile()
    // 创建工作表
    indexXiShu := f.NewSheet("西蜀")
    f.NewSheet("东吴")
    f.NewSheet("曹魏")
    // 向表中单元格写入数据
    f.SetCellValue("西蜀", "B2", "刘备")
    f.SetCellValue("西蜀", "B3", "关羽")
    f.SetCellValue("西蜀", "B4", "张飞")
    f.SetCellValue("东吴", "B2", "孙权")
    f.SetCellValue("曹魏", "B2", "曹操")
    f.SetSheetVisible("东吴",false)

    // 设置工作簿的默认工作表
    f.SetActiveSheet(indexXiShu)
    // 根据指定路径保存文件
    if err := f.SaveAs("sanGuo.xlsx"); err != nil {
        fmt.Println(err)
    }
}

• 结果显示

  
  
  image.png

如图可见，东吴表被隐藏。

6.2 获取工作表可见性

• 代码

func (f *File) GetSheetVisible(sheet string) bool

• 示例

上例中添加如下代码：

statusDongWu := f.GetSheetVisible("东吴")
fmt.Printf("东吴表的状态是：%t ",statusDongWu)

结果显示

东吴表的状态是：false

7. 表格整体属性

• 语法

func (f *File) SetSheetFormatPr(sheet string, opts ...SheetFormatPrOptions) error

• 可选参数

可选格式参数	作用	数据类型
BaseColWidth	基础宽度	uint8
DefaultColWidth	默认列宽	float64
DefaultRowHeight	默认行高	float64
CustomHeight	自定义高度	bool
ZeroHeight	表格高仅为有内容的部分	bool
ThickTop	顶部厚	bool
ThickBottom	底部厚	bool

7.1 自定义列宽

• 语法示例

f.SetSheetFormatPr("西蜀",excelize.DefaultColWidth(30.0))

或者

f.SetSheetFormatPr("西蜀",excelize.BaseColWidth(30))

• 完整示例

package main

import (
    "fmt"

    "github.com/xuri/excelize/v2"
)

func main() {
    f := excelize.NewFile()
    // 创建工作表
    indexXiShu := f.NewSheet("西蜀")
    // 向表中单元格写入数据
    f.SetCellValue("西蜀", "A1", "刘备")
    f.SetCellValue("西蜀", "A2", "关羽")
    f.SetCellValue("西蜀", "A3", "张飞")
    f.SetSheetFormatPr("西蜀",excelize.DefaultColWidth(30.0))

    // 设置工作簿的默认工作表
    f.SetActiveSheet(indexXiShu)
    // 根据指定路径保存文件
    if err := f.SaveAs("sanGuo.xlsx"); err != nil {
        fmt.Println(err)
    }
}

• 结果显示

  
  
  image.png

7.2 自定义行高

• 语法示例

处设置默认列宽之外还需要设置 自定义列宽为true

f.SetSheetFormatPr("西蜀",excelize.DefaultRowHeight(30.0),excelize.CustomHeight(true))

• 完整示例

package main

import (
    "fmt"

    "github.com/xuri/excelize/v2"
)

func main() {
    f := excelize.NewFile()
    // 创建工作表
    indexXiShu := f.NewSheet("西蜀")

    // 向表中单元格写入数据
    f.SetCellValue("西蜀", "A1", "刘备")
    f.SetCellValue("西蜀", "A2", "关羽")
    f.SetCellValue("西蜀", "A3", "张飞")
    f.SetSheetFormatPr("西蜀",excelize.DefaultRowHeight(30.0),excelize.CustomHeight(true))

    // 设置工作簿的默认工作表
    f.SetActiveSheet(indexXiShu)
    // 根据指定路径保存文件
    if err := f.SaveAs("sanGuo.xlsx"); err != nil {
        fmt.Println(err)
    }
}

• 结果显示

  
  
  image.png

7.3 行高为内容部分

• 语法示例

f.SetSheetFormatPr("西蜀",excelize.ZeroHeight(true))

• 完整示例

package main

import (
    "fmt"

    "github.com/xuri/excelize/v2"
)

func main() {
    f := excelize.NewFile()
    // 创建工作表
    indexXiShu := f.NewSheet("西蜀")

    // 向表中单元格写入数据
    f.SetCellValue("西蜀", "A1", "刘备")
    f.SetCellValue("西蜀", "A2", "关羽")
    f.SetCellValue("西蜀", "A3", "张飞")
    f.SetSheetFormatPr("西蜀",excelize.ZeroHeight(true))

    // 设置工作簿的默认工作表
    f.SetActiveSheet(indexXiShu)
    // 根据指定路径保存文件
    if err := f.SaveAs("sanGuo.xlsx"); err != nil {
        fmt.Println(err)
    }
}

• 结果显示

  
  
  image.png

7.4 获取表格属性

• 语法

func (f *File) GetSheetFormatPr(sheet string, opts ...SheetFormatPrOptionsPtr) error

• 完整示例

说明：该示例摘自官方文档。

package main

import (
    "fmt"
    "github.com/xuri/excelize/v2"
)

func main() {
    f := excelize.NewFile()
    const sheet = "Sheet1"

    var (
        baseColWidth     excelize.BaseColWidth
        defaultColWidth  excelize.DefaultColWidth
        defaultRowHeight excelize.DefaultRowHeight
        customHeight     excelize.CustomHeight
        zeroHeight       excelize.ZeroHeight
        thickTop         excelize.ThickTop
        thickBottom      excelize.ThickBottom
    )

    if err := f.GetSheetFormatPr(sheet,
        &baseColWidth,
        &defaultColWidth,
        &defaultRowHeight,
        &customHeight,
        &zeroHeight,
        &thickTop,
        &thickBottom,
    ); err != nil {
        fmt.Println(err)
    }
    fmt.Println("Defaults:")
    fmt.Println("- baseColWidth:", baseColWidth)
    fmt.Println("- defaultColWidth:", defaultColWidth)
    fmt.Println("- defaultRowHeight:", defaultRowHeight)
    fmt.Println("- customHeight:", customHeight)
    fmt.Println("- zeroHeight:", zeroHeight)
    fmt.Println("- thickTop:", thickTop)
    fmt.Println("- thickBottom:", thickBottom)
}

• 结果显示

Defaults:
- baseColWidth: 0
- defaultColWidth: 0
- defaultRowHeight: 15
- customHeight: false
- zeroHeight: false
- thickTop: false
- thickBottom: false

8. 表名

8.1 根据索引获取工作表名

• 语法

func (f *File) GetSheetName(index int) (name string)

• 示例

package main

import (
    "fmt"
    "github.com/xuri/excelize/v2"
)

func main() {
    f := excelize.NewFile()
    sheetName := f.GetSheetName(0)
    fmt.Println(sheetName)
}

结果显示

Sheet1

8.2 根据表名获取工作表索引

• 语法

func (f *File) GetSheetIndex(sheet string) int

表不存在返回-1

8.3 获取工作表列表

func (f *File) GetSheetList() []string

8.4 修改工作表名

• 语法

func (f *File) SetSheetName(oldName, newName string)

• 完整示例

package main

import (
    "fmt"
    "github.com/xuri/excelize/v2"
)

func main() {
    f := excelize.NewFile()
    fmt.Println("修改前0号表表名：",f.GetSheetName(0))
    f.SetSheetName("Sheet1","xiShu")
    fmt.Println("修改后0号表表名：",f.GetSheetName(0))

}

结果显示

修改前0号表表名： Sheet1
修改后0号表表名： xiShu

9. 表查询

• 语法

func (f *File) SearchSheet(sheet string, value string, reg ...bool) ([]string, error)

说明：

• sheet ：表名
• value：要查找的字串
• reg：是否匹配正则

• 完整示例

package main

import (
    "fmt"

    "github.com/xuri/excelize/v2"
)

func main() {
    f := excelize.NewFile()

    // 向表中单元格写入数据
    f.SetCellValue("Sheet1", "A1", "刘备")
    f.SetCellValue("Sheet1", "A2", "诸葛亮")
    f.SetCellValue("Sheet1", "A3", "关羽")
    f.SetCellValue("Sheet1", "A4", "张飞")
    f.SetCellValue("Sheet1", "A5", "赵云")
    f.SetCellValue("Sheet1", "A6", "马超")
    f.SetCellValue("Sheet1", "A7", "黄忠")
    f.SetCellValue("Sheet1", "A8", "关兴")
    f.SetCellValue("Sheet1", "A9", "关平")
    //精确查找
    result1,_ := f.SearchSheet("Sheet1","关羽")
    //正则匹配
    result2,_ := f.SearchSheet("Sheet1","^关.*",true)
    fmt.Printf("精确搜索：%+v\n正则匹配： %+v",result1,result2)
}

• 打印结果

精确搜索：[A3]
正则匹配： [A3 A8 A9]

---