13.1. 创建表格

Excelize 开发者指南 /

创建表格

func (f *File) AddTable(sheet, hCell, vCell, format string) error

根据给定的工作表名、单元格坐标区域和条件格式创建表格。

例1，在名为 Sheet1 的工作表 A1:D5 区域创建表格：

创建表格

err := f.AddTable("Sheet1", "A1", "D5", ``)

例2，在名为 Sheet2 的工作表 F2:H6 区域创建带有条件格式的表格：

创建带有条件格式的表格

err := f.AddTable("Sheet2", "F2", "H6", `{
    "table_name": "table",
    "table_style": "TableStyleMedium2",
    "show_first_column": true,
    "show_last_column": true,
    "show_row_stripes": false,
    "show_column_stripes": true
}`)

注意，表格坐标区域至少需要包含两行：字符型的标题行和内容行。每列标题行的字符需保证是唯一的，并且必须在调用 AddTable 函数前设置表格的标题行数据。多个表格的坐标区域不能有交集。

可选参数 table_name 用以设置自定义表格名称，同一个工作表内的表格名称应该是唯一的。

Excelize 支持的表格样式 table_style 参数：

TableStyleLight1 - TableStyleLight21
TableStyleMedium1 - TableStyleMedium28
TableStyleDark1 - TableStyleDark11

索引	索引	索引
	TableStyleLight1	TableStyleLight2
TableStyleLight3	TableStyleLight4	TableStyleLight5
TableStyleLight6	TableStyleLight7	TableStyleLight8
TableStyleLight9	TableStyleLight10	TableStyleLight11
TableStyleLight12	TableStyleLight13	TableStyleLight14
TableStyleLight15	TableStyleLight16	TableStyleLight17
TableStyleLight18	TableStyleLight19	TableStyleLight20
TableStyleLight21	TableStyleMedium1	TableStyleMedium2
TableStyleMedium3	TableStyleMedium4	TableStyleMedium5
TableStyleMedium6	TableStyleMedium7	TableStyleMedium8
TableStyleMedium9	TableStyleMedium10	TableStyleMedium11
TableStyleMedium12	TableStyleMedium13	TableStyleMedium14
TableStyleMedium15	TableStyleMedium16	TableStyleMedium17
TableStyleMedium18	TableStyleMedium19	TableStyleMedium20
TableStyleMedium21	TableStyleMedium22	TableStyleMedium23
TableStyleMedium24	TableStyleMedium25	TableStyleMedium26
TableStyleMedium27	TableStyleMedium28	TableStyleDark1
TableStyleDark2	TableStyleDark3	TableStyleDark4
TableStyleDark5	TableStyleDark6	TableStyleDark7
TableStyleDark8	TableStyleDark9	TableStyleDark10
TableStyleDark11