樣式

《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。