Границы и рамки: бордюры таблиц

Поле Borders в структуре Style — это срез структур excelize.Border, и запрос excelize границы упирается в одну схему: на каждую линию — свой элемент среза. У элемента три поля. Type говорит, на какой стороне ячейки рисовать: top, bottom, left, right, а заодно diagonalDown и diagonalUp — диагонали из угла в угол. Style — вид линии строкой из каталога Excel, от тонкой thin до двойной double, полный разбор в следующем разделе. Color — строка вида #RRGGBB с решёткой, как у шрифтов. Срез — не избыточность, а честность: ячейка xlsx вправе нести до шести линий одновременно, по числу сторон и диагоналей, и API отражает это массивом вместо шести отдельных полей. Внутри файла границы живут в xl/styles.xml таблицей borders рядом с шрифтами и заливками; одинаковые комбинации схлопываются в одну запись, поэтому сетка на пятьсот ячеек не распухает файл. Ошибку NewStyle вернёт на кривом цвете или несуществующем стиле линии — проверка err здесь такой же рабочий инструмент, как и в стилях.

Поле Style у Border — строка, и её значения — каталог линий Excel из спецификации xlsx. Базовый набор короткий: none — линии нет, hair — самая тонкая, thin — тонкая сплошная, medium — средняя, thick — толстая, dashed и dotted — штрих и точки, double — двойная. Есть и составные: mediumDashed, dashDot, mediumDashDotDot, slantDashDot — в деловых отчётах они встречаются реже диагоналей, но в спецификации живут, и Excel рисует их честно. Практика выбора укладывается в три правила: сетке данных — thin; внешней рамке, шапке и разделителям секций — medium; итоговой строке сверху — double по бухгалтерской традиции. Цвет от толщины не зависит: серый #999999 вместо чёрного превращает сетку в фон, который не спорит с текстом, а красная medium на отрицательном итоге читается как тревога — акцент без единого условного правила. Толстые линии на каждой ячейке не поднимайте: отчёт рискует стать клетчатой бумагой из блокнота.

Срез Borders принимает сколько угодно линий, и здесь проступает главный приём темы: сетка диапазона строится одним стилем. Логика простая — если каждой ячейке прямоугольника дать все четыре линии, соседние линии совпадут, и на экране это выглядит как единая сетка. Excel рисует совпадающие края друг на друге; при одинаковых Style и Color артефактов нет, а вот смешивать толщины на одном стыке не стоит: тонкая и средняя линии на общей границе выглядят рвано. Отсюда правило одной толщины внутри блока: выбрали thin — держите thin во всём прямоугольнике. Внешнюю рамку потолще делают вторым проходом: отдельный стиль, у которого внешняя сторона medium, а внутренние линии остаются thin, прикладывается к крайним строкам и колонкам. Это два стиля и несколько вызовов SetCellStyle — оба создаются до цикла, и правила урока про excelize стили работают без изменений: идентификаторы переиспользуются, в styles.xml лежат две записи вместо пятисот.

Диагонали — редкие гости, но знать их стоит: diagonalDown ведёт линию из левого верхнего угла в правый нижний, diagonalUp — из левого нижнего в правый верхний, вместе они дают крест-накрест. В актах сверки и инвентаризации перечёркнутые позиции рисуют именно диагональю, потому что зачёркивание Strike из урока про стили видно только на тексте, а диагональ перечёркивает и пустую ячейку, и число. Края диапазона при приёме «четыре линии каждой ячейке» получаются той же толщины, что и внутренняя сетка, — и это хорошо: единый контур без исключений. Если макет требует среднюю линию только по внешнему периметру, соберите второй стиль с medium на внешних сторонах и приложите его к крайним строкам и колонкам диапазона. И помните про шов: соседние ячейки делят границу, Excel рисует обе линии стыка, поэтому параметры совпадающих краёв держите одинаковыми, иначе на общем ребре появится рваный стык из двух разных линий.