клетка

RichTextRun напрямую отображает настройки прогона расширенного текста.

type RichTextRun struct {
    Font *Font
    Text string
}

HyperlinkOpts можно передать в SetCellHyperlink для установки дополнительных атрибутов гиперссылки (например, отображаемого текста и текста подсказки на экране).

type HyperlinkOpts struct {
    Display *string
    Tooltip *string
}

FormulaOpts может быть передана SetCellFormula для использования других типов формул.

type FormulaOpts struct {
    Type *string // Тип формулы
    Ref  *string // Общие ссылки на формулы
}

Установить значение ячейки

func (f *File) SetCellValue(sheet, cell string, value interface{}) error

SetCellValue предоставляет функцию для установки значения ячейки. Эта функция может быть использована для безопасности параллелизма. Указанные координаты не должны быть в первом ряду таблицы. Ниже приведены поддерживаемые типы данных:

Обратите внимание, что формат даты по умолчанию — m/d/yy h:mm со значением типа time.Time. Вы можете установить формат чисел с помощью метода SetCellStyle. Если вам нужно установить специальную дату в Excel, например 0 января 1900 года или 29 февраля 1900 года, это время не может быть представлено в типе данных time.Time языка Go. Установите значение ячейки как число 0 или 60, затем создайте и привяжите стиль формата даты и времени для ячейки.

Установить логическое значение

func (f *File) SetCellBool(sheet, cell string, value bool) error

SetCellBool предоставляет функцию для установки значения типа bool ячейки с помощью заданного имени листа, координат ячейки и значения ячейки.

Установить значение RAW

func (f *File) SetCellDefault(sheet, cell, value string) error

SetCellDefault предоставляет функцию для установки значения типа строки ячейки как формата по умолчанию, не выходя из ячейки.

Установить целочисленное значение

func (f *File) SetCellInt(sheet, cell string, value int) error

SetCellInt предоставляет функцию для установки значения типа int ячейки с помощью заданного имени листа, координат ячейки и значения ячейки.

Установить беззнаковое целое значение

func (f *File) SetCellUint(sheet, cell string, value uint64) error

SetCellUint предоставляет функцию для установки значения целочисленного типа данных без знака для ячейки по заданному имени рабочего листа, ссылке на ячейку и значению ячейки.

Установить значение с плавающей запятой

func (f *File) SetCellFloat(sheet, cell string, value float64, precision, bitSize int) error

SetCellFloat устанавливает значение с плавающей запятой в ячейку. Параметр precision указывает, сколько знаков после запятой будет отображаться, а -1 — это специальное значение, которое будет использовать столько знаков после запятой, сколько необходимо для представления числа. bitSize равен 32 или 64 в зависимости от того, использовался ли изначально для значения float32 или float64.

Установить строковое значение

func (f *File) SetCellStr(sheet, cell, value string) error

SetCellStr предоставляет функцию для установки значения типа строки для ячейки. Общее количество символов, которое ячейка может содержать символы 32767.

Установить стиль ячейки

func (f *File) SetCellStyle(sheet, topLeftCell, bottomRightCell string, styleID int) error

SetCellStyle предоставляет функцию добавления атрибута стиля для ячеек по заданному имени рабочего листа, области координат и идентификатору стиля. Эта функция может быть использована для безопасности параллелизма. Индексы стиля можно получить с помощью функции NewStyle. Обратите внимание, что границы diagonalDown и diagonalUp должны использоваться одинаковым цветом в одной и той же координатной области. SetCellStyle перезапишет существующие стили для ячейки, он не будет добавлять или объединять стиль с существующими стилями.

• Пример 1, создайте границы ячейки D7 на Sheet1:

style, err := f.NewStyle(&excelize.Style{
    Border: []excelize.Border{
        {Type: "left", Color: "0000FF", Style: 3},
        {Type: "top", Color: "00FF00", Style: 4},
        {Type: "bottom", Color: "FFFF00", Style: 5},
        {Type: "right", Color: "FF0000", Style: 6},
        {Type: "diagonalDown", Color: "A020F0", Style: 8},
        {Type: "diagonalUp", Color: "A020F0", Style: 8},
    },
})
if err != nil {
    fmt.Println(err)
}
err = f.SetCellStyle("Sheet1", "D7", "D7", style)

Четыре границы ячейки D7 установлены с разными стилями и цветами. Это связано с параметрами при вызове функции NewStyle. Вам нужно установить разные стили для ссылки на документацию для этой главы.

• Пример 2, установив стиль градиента для ячейки D7 листа Sheet1:

style, err := f.NewStyle(&excelize.Style{
    Fill: excelize.Fill{Type: "gradient", Color: []string{"FFFFFF", "E0EBF5"}, Shading: 1},
})
if err != nil {
    fmt.Println(err)
}
err = f.SetCellStyle("Sheet1", "D7", "D7", style)

В ячейке D7 задается цветовая заливка эффекта градиента. Эффект градиентной заливки связан с параметром при вызове функции NewStyle. Вам нужно установить разные стили для ссылки на документацию этой главы.

• Пример 3, установите сплошную заливку для ячейки D7 с именем Sheet1:

style, err := f.NewStyle(&excelize.Style{
    Fill: excelize.Fill{Type: "pattern", Color: []string{"E0EBF5"}, Pattern: 1},
})
if err != nil {
    fmt.Println(err)
}
err = f.SetCellStyle("Sheet1", "D7", "D7", style)

Ячейка D7 установлена с заполнением.

• Пример 4, задайте расстояние между символами и угол поворота для ячейки D7 с именем Sheet1:

f.SetCellValue("Sheet1", "D7", "样式")
style, err := f.NewStyle(&excelize.Style{
    Alignment: &excelize.Alignment{
        Horizontal:      "center",
        Indent:          1,
        JustifyLastLine: true,
        ReadingOrder:    0,
        RelativeIndent:  1,
        ShrinkToFit:     true,
        TextRotation:    45,
        Vertical:        "",
        WrapText:        true,
    },
})
if err != nil {
    fmt.Println(err)
}
err = f.SetCellStyle("Sheet1", "D7", "D7", style)

• Пример 5, дата и время в Excel представлены действительными числами, например 2017/7/4 12:00:00 PM могут быть представлены числом 42920.5. Установите формат времени для ячейки таблицы D7 с именем Sheet1:

f.SetCellValue("Sheet1", "D7", 42920.5)
f.SetColWidth("Sheet1", "D", "D", 13)
style, err := f.NewStyle(&excelize.Style{NumFmt: 22})
if err != nil {
    fmt.Println(err)
}
err = f.SetCellStyle("Sheet1", "D7", "D7", style)

В ячейке D7 установлен формат времени. Обратите внимание, что когда ширина ячейки с применяемым временным форматом слишком узкая, чтобы ее можно было полностью отобразить, она будет отображаться как ####, вы можете перетащить ширину столбца или установить столбец в соответствующий размер, вызвав SetColWidth, чтобы сделать его нормальным. дисплей.

• Пример 6, установив шрифт, размер шрифта, цвет и стиль перекоса для ячейки D7 листа Sheet1:

f.SetCellValue("Sheet1", "D7", "Excel")
style, err := f.NewStyle(&excelize.Style{
    Font: &excelize.Font{
        Bold:   true,
        Italic: true,
        Family: "Times New Roman",
        Size:   36,
        Color:  "777777",
    },
})
if err != nil {
    fmt.Println(err)
}
err = f.SetCellStyle("Sheet1", "D7", "D7", style)

• Пример 7, блокировка и скрытие ячейки D7 с именем Sheet1:

style, err := f.NewStyle(&excelize.Style{
    Protection: &excelize.Protection{
        Hidden: true,
        Locked: true,
    },
})
if err != nil {
    fmt.Println(err)
}
err = f.SetCellStyle("Sheet1", "D7", "D7", style)

Чтобы заблокировать ячейку или скрыть формулу, защитите рабочий лист. На вкладке «Обзор» нажмите «Защитить рабочий лист».

Установить гиперссылку

func (f *File) SetCellHyperLink(sheet, cell, link, linkType string, opts ...HyperlinkOpts) error

SetCellHyperLink предоставляет функцию для установки гиперссылки на ячейки с помощью заданного имени рабочего листа и URL-адреса URL-адреса. LinkType определяет два типа гиперссылки External для сайта или Location для перехода к одной из сот в этой книге. Максимальный лимит гиперссылок на листе составляет 65530. Эта функция используется только для установки гиперссылки ячейки и не влияет на значение ячейки. Если вам нужно установить значение ячейки, используйте другие функции, такие как SetCellStyle или SetSheetRow. Ниже приведен пример внешней ссылки.

• Пример 1, добавление внешней ссылки на ячейку A3 на листе с именем Sheet1:

display, tooltip := "https://github.com/xuri/excelize", "Excelize on GitHub"
if err := f.SetCellHyperLink("Sheet1", "A3",
    "https://github.com/xuri/excelize", "External", excelize.HyperlinkOpts{
        Display: &display,
        Tooltip: &tooltip,
    }); err != nil {
    fmt.Println(err)
}
// Задайте стиль шрифта и подчеркивания для ячейки
style, err := f.NewStyle(&excelize.Style{
    Font: &excelize.Font{Color: "1265BE", Underline: "single"},
})
if err != nil {
    fmt.Println(err)
}
err = f.SetCellStyle("Sheet1", "A3", "A3", style)

• Пример 2: добавление внутренней ссылки на ячейку A3 с именем Sheet1:

err := f.SetCellHyperLink("Sheet1", "A3", "Sheet1!A40", "Location")

Установить форматированный текст для ячейки

func (f *File) SetCellRichText(sheet, cell string, runs []RichTextRun) error

SetCellRichText предоставляет функцию для установки ячейки с расширенным текстом по заданному рабочему листу.

Например, установите расширенный текст в ячейке A1 листа с именем Sheet1:

package main

import (
    "fmt"

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

func main() {
    f := excelize.NewFile()
    defer func() {
        if err := f.Close(); err != nil {
            fmt.Println(err)
        }
    }()
    if err := f.SetRowHeight("Sheet1", 1, 35); err != nil {
        fmt.Println(err)
        return
    }
    if err := f.SetColWidth("Sheet1", "A", "A", 44); err != nil {
        fmt.Println(err)
        return
    }
    if err := f.SetCellRichText("Sheet1", "A1", []excelize.RichTextRun{
        {
            Text: "bold",
            Font: &excelize.Font{
                Bold:   true,
                Color:  "2354E8",
                Family: "Times New Roman",
            },
        },
        {
            Text: " and ",
            Font: &excelize.Font{
                Family: "Times New Roman",
            },
        },
        {
            Text: "italic ",
            Font: &excelize.Font{
                Bold:   true,
                Color:  "E83723",
                Italic: true,
                Family: "Times New Roman",
            },
        },
        {
            Text: "text with color and font-family,",
            Font: &excelize.Font{
                Bold:   true,
                Color:  "2354E8",
                Family: "Times New Roman",
            },
        },
        {
            Text: "\r\nlarge text with ",
            Font: &excelize.Font{
                Size:  14,
                Color: "AD23E8",
            },
        },
        {
            Text: "strike",
            Font: &excelize.Font{
                Color:  "E89923",
                Strike: true,
            },
        },
        {
            Text: " superscript",
            Font: &excelize.Font{
                Color:     "DBC21F",
                VertAlign: "superscript",
            },
        },
        {
            Text: " and ",
            Font: &excelize.Font{
                Size:      14,
                Color:     "AD23E8",
                VertAlign: "baseline",
            },
        },
        {
            Text: "underline",
            Font: &excelize.Font{
                Color:     "23E833",
                Underline: "single",
            },
        },
        {
            Text: " subscript.",
            Font: &excelize.Font{
                Color:     "017505",
                VertAlign: "subscript",
            },
        },
    }); err != nil {
        fmt.Println(err)
        return
    }
    style, err := f.NewStyle(&excelize.Style{
        Alignment: &excelize.Alignment{
            WrapText: true,
        },
    })
    if err != nil {
        fmt.Println(err)
        return
    }
    if err := f.SetCellStyle("Sheet1", "A1", "A1", style); err != nil {
        fmt.Println(err)
        return
    }
    if err := f.SaveAs("Book1.xlsx"); err != nil {
        fmt.Println(err)
    }
}

Получить форматированный текст ячейки

func (f *File) GetCellRichText(sheet, cell string) ([]RichTextRun, error)

GetCellRichText предоставляет функцию для получения форматированного текста ячеек по заданному листу.

Получить значение ячейки

func (f *File) GetCellValue(sheet, cell string, opts ...Options) (string, error)

Значение ячейки извлекается в соответствии с данным рабочим листом и координатами ячейки, а возвращаемое значение преобразуется в тип string. Эта функция может быть использована для безопасности параллелизма. Если формат ячейки можно применить к значению ячейки, прикладное значение будет возвращено, иначе исходное значение будет возвращено. Значения всех ячеек будут одинаковыми в объединенном диапазоне.

Получить тип данных ячейки

func (f *File) GetCellType(sheet, cell string) (CellType, error)

GetCellType предоставляет функцию для получения типа данных ячейки по заданному имени листа и оси в файле электронной таблицы.

Получить все значения ячейки по столбцам

func (f *File) GetCols(sheet string, opts ...Options) ([][]string, error)

GetCols получает значение всех ячеек по столбцам на рабочем листе на основе заданного имени рабочего листа, возвращаемого в виде двумерного массива, где значение ячейки преобразуется в тип строка. Если формат ячейки можно применить к значению ячейки, будет использовано примененное значение, в противном случае будет использовано исходное значение.

Например, получить и пройти значение всех ячеек по столбцам на листе с именем Лист1:

cols, err := f.GetCols("Лист1")
if err != nil {
    fmt.Println(err)
    return
}
for _, col := range cols {
    for _, rowCell := range col {
        fmt.Print(rowCell, "\t")
    }
    fmt.Println()
}

Получить все значения ячеек по строкам

func (f *File) GetRows(sheet string, opts ...Options) ([][]string, error)

GetRows возвращает все строки на листе по заданному имени рабочего листа, возвращаемые в виде двумерного массива, где значение ячейки преобразуется в тип string. Если формат ячейки можно применить к значению ячейки, будет использовано примененное значение, в противном случае будет использовано исходное значение. GetRows извлекает строки со значениями или ячейками формулы, постоянно пустые ячейки в хвосте каждой строки будут пропущены, поэтому длина каждой строки может быть непоследовательной.

Например, получить и пройти значение всех ячеек по строкам на листе с именем Лист1:

rows, err := f.GetRows("Лист1")
if err != nil {
    fmt.Println(err)
    return
}
for _, row := range rows {
    for _, colCell := range row {
        fmt.Print(colCell, "\t")
    }
    fmt.Println()
}

Получить гиперссылку

func (f *File) GetCellHyperLink(sheet, cell string) (bool, string, error)

Получает гиперссылку на ячейку на основе заданного имени листа и координат ячейки. Если ячейка имеет гиперссылку, она вернет true и адрес ссылки, иначе он вернет false и пустой адрес ссылки.

Например, получите гиперссылку на ячейку H6 на листе с именем Лист1:

link, target, err := f.GetCellHyperLink("Лист1", "H6")

Получить индекс стиля

func (f *File) GetCellStyle(sheet, cell string) (int, error)

Индекс стиля ячейки получается из заданного имени листа и координат ячейки, а полученный индекс может использоваться как параметр для вызова функции SetCellStyle при копировании стиля ячейки.

Объединить ячейки

func (f *File) MergeCell(sheet, topLeftCell, bottomRightCell string) error

Объединить ячейки на основе заданного имени листа и областей координат ячейки. При объединении ячеек сохраняется только значение верхней левой ячейки, а остальные значения отбрасываются. Например, слияние ячеек в области D3:E9 на листе с именем Лист1:

err := f.MergeCell("Лист1", "D3", "E9")

Если заданная координатная область ячейки перекрывается с другими существующими объединенными ячейками, существующие объединенные ячейки будут удалены.

Отменить объединение ячеек

func (f *File) UnmergeCell(sheet, topLeftCell, bottomRightCell string) error

UnmergeCell предоставляет функцию для объединения заданной координатной области. Например, удалите область D3:E9 на Лист1:

err := f.UnmergeCell("Лист1", "D3", "E9")

Внимание: перекрывающиеся области также не будут объединены.

Получить ячейки слияния

GetMergeCells предоставляет функцию для получения всех объединенных ячеек из рабочего листа.

func (f *File) GetMergeCells(sheet string) ([]MergeCell, error)

Получить значение объединенной ячейки

func (m *MergeCell) GetCellValue() string

GetCellValue возвращает значение объединенной ячейки.

Получить координаты верхней левой ячейки объединенного диапазона

func (m *MergeCell) GetStartAxis() string

GetStartAxis возвращает координаты верхней левой ячейки объединенного диапазона, например: C2.

Получить координаты нижней правой ячейки объединенного диапазона

func (m *MergeCell) GetEndAxis() string

GetEndAxis возвращает координаты нижней правой ячейки объединенного диапазона, например: D4.

Получить клетки изображения

func (f *File) GetPictureCells(sheet string) ([]string, error)

GetPictureCells возвращает все ссылки на ячейки изображений на листе по определенному имени листа.

Добавить комментарий

func (f *File) AddComment(sheet string, comment Comment) error

AddComment предоставляет метод добавления комментариев в листе с помощью заданного индекса, набора ячеек и формата (например, автора и текста). Обратите внимание, что максимальная длина автора равна 255, а максимальная длина текста - 32512. Например, добавьте комментарий в Sheet1!A3:

err := f.AddComment("Sheet1", excelize.Comment{
    Cell:   "A3",
    Author: "Excelize",
    Paragraph: []excelize.RichTextRun{
        {Text: "Excelize: ", Font: &excelize.Font{Bold: true}},
        {Text: "This is a comment."},
    },
})

Получить комментари

func (f *File) GetComments(sheet string) ([]Comment, error)

GetComments извлекает все комментарии на листе по заданному имени листа.

Удалить комментарий

func (f *File) DeleteComment(sheet, cell string) error

DeleteComment предоставляет метод для удаления комментария на листе по заданному рабочему листу. Например, удалить комментарий в Лист1!A30:

err := f.DeleteComment("Лист1", "A30")

Установить формулу ячейки

func (f *File) SetCellFormula(sheet, cell, formula string, opts ...FormulaOpts) error

SetCellFormula предоставляет функцию для установки формулы в ячейке в соответствии с заданным именем рабочего листа и настройками формулы ячейки. Результат ячейки формулы может быть рассчитан, когда лист открыт приложением Office Excel или может использовать функцию CalcCellValue также может получить рассчитанное значение ячейки. Если приложение Excel не вычисляет формулу автоматически при открытии книги, вызовите UpdateLinkedValue после установки функций формулы ячейки.

• Пример 1, установите обычную формулу =SUM(A1,B1) для ячейки A3 на Лист1:

err := f.SetCellFormula("Лист1", "A3", "=SUM(A1,B1)")

• Пример 2, установить одномерный вертикальный постоянный массив (массив столбцов) формулой 1;2;3 для ячейки A3 на Лист1:

err := f.SetCellFormula("Лист1", "A3", "={1;2;3}")

• Пример 3, установить одномерный горизонтальный массив констант (массив строк) формулой "a","b","c" для ячейки A3 на Лист1:

err := f.SetCellFormula("Лист1", "A3", "={\"a\",\"b\",\"c\"}")

• Пример 4, установить двумерную формулу массива констант {1,2;"a","b"} для ячейки A3 на Лист1:

formulaType, ref := excelize.STCellFormulaTypeArray, "A3:A3"
err := f.SetCellFormula("Лист1", "A3", "={1,2;\"a\",\"b\"}",
    excelize.FormulaOpts{Ref: &ref, Type: &formulaType})

• Пример 5, установить формулу массива диапазонов A1:A2 для ячейки A3 на Лист1:

formulaType, ref := excelize.STCellFormulaTypeArray, "A3:A3"
err := f.SetCellFormula("Лист1", "A3", "=A1:A2",
    excelize.FormulaOpts{Ref: &ref, Type: &formulaType})

• Пример 6, установить общую формулу =A1+B1 для ячеек C1:C5 на Лист1, C1 - это основная ячейка:

formulaType, ref := excelize.STCellFormulaTypeShared, "C1:C5"
err := f.SetCellFormula("Лист1", "C1", "=A1+B1",
    excelize.FormulaOpts{Ref: &ref, Type: &formulaType})

• Пример 7, установить формулу таблицы =SUM(Table1[[A]:[B]]) для ячейки C2 на Лист1:

package main

import (
    "fmt"

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

func main() {
    f := excelize.NewFile()
    defer func() {
        if err := f.Close(); err != nil {
            fmt.Println(err)
        }
    }()
    if err := f.SetSheetName("Sheet1", "Лист1"); err != nil {
        fmt.Println(err)
        return
    }
    for idx, row := range [][]interface{}{{"A", "B", "C"}, {1, 2}} {
        if err := f.SetSheetRow("Лист1", fmt.Sprintf("A%d", idx+1), &row); err != nil {
            fmt.Println(err)
            return
        }
    }
    if err := f.AddTable("Лист1",
        &excelize.Table{
            Range:     "A1:C2",
            Name:      "Table1",
            StyleName: "TableStyleMedium2",
        }); err != nil {
        fmt.Println(err)
        return
    }
    formulaType := excelize.STCellFormulaTypeDataTable
    if err := f.SetCellFormula("Лист1", "C2", "=SUM(Table1[[A]:[B]])",
        excelize.FormulaOpts{Type: &formulaType}); err != nil {
        fmt.Println(err)
        return
    }
    if err := f.SaveAs("Книга1.xlsx"); err != nil {
        fmt.Println(err)
    }
}

Получить формулу ячейки

func (f *File) GetCellFormula(sheet, cell string) (string, error)

Получите формулу в ячейке на основе заданного имени листа и координат ячейки.

Рассчитать значение ячейки

func (f *File) CalcCellValue(sheet, cell string, opts ...Options) (string, error)

CalcCellValue предоставляет функцию для получения рассчитанного значения ячейки. Эта функция в настоящее время находится в рабочей обработке. Итеративное вычисление, неявное пересечение, явное пересечение, формула массива, формула таблицы и некоторые другие формулы в настоящее время не поддерживаются.

Поддерживаемые формулы: