样式

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

Alignment 映射单元格对齐样式设置。

type Alignment struct {
    Horizontal      string
    Indent          int
    JustifyLastLine bool
    ReadingOrder    uint64
    RelativeIndent  int
    ShrinkToFit     bool
    TextRotation    int
    Vertical        string
    WrapText        bool
}

Border 映射单元格边框样式设置。

type Border struct {
    Type  string
    Color string
    Style int
}

Font 映射字体样式设置。

type Font struct {
    Bold         bool
    Italic       bool
    Underline    string
    Family       string
    Size         float64
    Strike       bool
    Color        string
    ColorIndexed int
    ColorTheme   *int
    ColorTint    float64
    VertAlign    string
}

Fill 映射单元格样式填充设置。

type Fill struct {
    Type         string
    Pattern      int
    Color        []string
    Shading      int
    Transparency int
}

Protection 映射保护单元格属性设置。

type Protection struct {
    Hidden bool
    Locked bool
}

Style 映射单元格样式设置。

type Style struct {
    Border        []Border
    Fill          Fill
    Font          *Font
    Alignment     *Alignment
    Protection    *Protection
    NumFmt        int
    DecimalPlaces int
    CustomNumFmt  *string
    NegRed        bool
}

创建样式

func (f *File) NewStyle(style *Style) (int, error)

通过给定的样式格式结构体创建样式并返回样式索引，样式索引对于每个工作簿是唯一的，并且仅对当前工作簿有效，不可跨工作簿使用。此功能是并发安全的。请注意，Font.Color 需要使用 RRGGBB 格式的 RGB 十六进制色值代码。

边框

下面的表格是 Excelize 中 Border.Type 支持的边框类型：

下面的表格是 Excelize 中 Border.Style 支持的边框线型索引与对应的线型名称、粗细及预览效果：

索引	线型名称	粗细	预览效果
0	无	0
1	连续线	1
2	连续线	2
3	短线	1
4	点线	1
5	连续线	3
6	双线	3
7	连续线	0
8	短线	2
9	短线与点间隔线	1
10	短线与点间隔线	2
11	短线与两个点一组重复线	1
12	短线与两个点一组重复线	2
13	斜线与点线	2

Excelize 中的 Border.Style 边框线型索引与 Office Excel 应用程序“设置单元格格式” - “边框”对话框中的关系对照：

索引	预览效果	索引	预览效果
0		12
7		13
4		10
11		8
9		2
3		5
1		6

填充类型

参数 Fill.Type 用于设置填充的类型，可选值为 gradient 或 pattern。设置 gradient 类型填充时，必须同时有效的 Fill.Shading 值，Fill.Color 必须是仅包含两个有效色值的数组；设置 pattern 类型填充时，必须同时有效的 Fill.Pattern 值，Fill.Color 必须是仅包含一个有效色值的数组。请参阅 SetCellStyle 函数章节中使用填充类型的案例。

颜色填充

下面的表格是 Excelize 中单元格颜色填充样式和索引 Fill.Shading 参数的关系对照：

图案填充

下面的表格是 Excelize 中单元格图案填充样式和索引 Fill.Pattern 参数的关系对照：

索引	样式	索引	样式
0	无	10
1		11
2		12
3		13
4		14
5		15
6		16
7		17
8		18
9

透明度

选项 Fill.Transparency 仅用于设置图表与形状中的填充透明度，而不用于设置单元格填充透明度。透明度的取值范围是 0 至 100，代表 0% 至 100%，默认值为 0，表示完全不透明。

对齐方式

缩进

Indent 以整数表示文本缩进的空格数，每增加 1 缩进 3 个空格，即缩进的空格数计算如下：

缩进的空格数 = 缩进值 * 3

例如，当使用普通样式字体时，缩进值为 1 表示文本从单元格边缘开始保留 3 个空格宽度。注意：每个空格字符的宽度由字体定义，缩进设置仅在使用靠左、靠右或分散对齐时生效。

水平对齐方式

下面的表格是 Excelize 中单元格水平对齐方式 Alignment.Horizontal 参数与样式关系对照表：

垂直对齐方式

下面的表格是 Excelize 中单元格垂直对齐方式 Alignment.Vertical 参数与样式关系对照表：

阅读顺序

ReadingOrder 是以 uint64 数据类型的值表示的单元格阅读顺序文字方向。下面是该字段的有效值与文字方向对照表：

相对缩进

RelativeIndent 是一个整数值，用以表示为单元格中的文本调整的额外缩进空格数。

字体下划线

下面的表格是 Excelize 中单元格字体下划线 Font.Underline 参数与样式关系对照表：

自定义数字格式

下面的表格是 Excelize 中支持的索引 Style.NumFmt 参数与自定义数字格式类型对照表：

繁体中文自定义数字格式

下面的表格是 Excelize 中支持的索引 Style.NumFmt 参数与繁体中文 zh-tw 版本自定义数字格式类型对照表：

简体中文自定义数字格式

下面的表格是 Excelize 中支持的索引 Style.NumFmt 参数与简体中文 zh-cn 版本自定义数字格式类型对照表：

日本语自定义数字格式

下面的表格是 Excelize 中支持的索引 Style.NumFmt 参数与日本语 ja-jp 版本自定义数字格式类型对照表：

韩语自定义数字格式

下面的表格是 Excelize 中支持的索引 Style.NumFmt 参数与韩语 ko-kr 版本自定义数字格式类型对照表：

泰国语自定义数字格式

下面的表格是 Excelize 中支持的索引 Style.NumFmt 参数与泰国语 th-th 版本自定义数字格式类型对照表：

货币格式

Excelize 目前支持的货币格式索引如下表所示，索引号仅用于标记，不在 Office Excel 文件中使用，目前无法通过函数 GetCellValue 获取格式化值后的值。

Excelize 支持为单元格设置自定义数字格式。例如，将 Sheet1 工作表的 A6 单元格 设置为乌拉圭（西班牙）格式的日期类型：

f := excelize.NewFile()
defer func() {
    if err := f.Close(); err != nil {
        fmt.Println(err)
    }
}()
if err := f.SetCellValue("Sheet1", "A6", 42920.5); err != nil {
    fmt.Println(err)
    return
}
exp := "[$-380A]dddd\\,\\ dd\" de \"mmmm\" de \"yyyy;@"
style, err := f.NewStyle(&excelize.Style{CustomNumFmt: &exp})
if err != nil {
    fmt.Println(err)
    return
}
err = f.SetCellStyle("Sheet1", "A6", "A6", style)

单元格 Sheet1!A6 在 Office Excel 应用程序中将会被格式化为：martes, 04 de Julio de 2017

获取样式

func (f *File) GetStyle(idx int) (*Style, error)

根据给定的样式索引获取样式定义。

设置列样式

func (f *File) SetColStyle(sheet, columns string, styleID int) error

根据给定的工作表名称、列区域和样式索引设置列样式。此功能是并发安全的。请注意，这将覆盖列的已有样式，而不会将样式与已有样式叠加或合并。

例1，为名称为 Sheet1 的工作表中的 H 列设置样式：

err = f.SetColStyle("Sheet1", "H", style)

例2，为名称为 Sheet1 的工作表中的 C:F 列设置样式：

err = f.SetColStyle("Sheet1", "C:F", style)

获取列样式

func (f *File) GetColStyle(sheet, col string) (int, error)

根据给定的工作表名称和列名称获取列的样式索引。此功能是并发安全的。

设置行样式

func (f *File) SetRowStyle(sheet string, start, end, styleID int) error

根据给定的工作表名称、行区域和样式索引设置行样式。请注意，这将覆盖行的已有样式，而不会将样式与已有样式叠加或合并。

例1，为名称为 Sheet1 的工作表的第 1 行设置样式:

err := f.SetRowStyle("Sheet1", 1, 1, styleID)

例2，为名称为 Sheet1 的工作表的第 1 至 10 行设置样式:

err := f.SetRowStyle("Sheet1", 1, 10, styleID)

设置默认字体

func (f *File) SetDefaultFont(fontName string)

根据给定的字体名称为工作簿设置默认字体。

获取默认字体

func (f *File) GetDefaultFont() string

获取当前工作簿的默认字体名称。通过 Excelize 创建的工作簿默认字体为 Calibri。