From 56f2a4d6e4a75d83b6a73aeb2bbd1047d9971f9f Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=D0=9A=D1=83=D1=80=D0=BD=D0=B0=D1=82=20=D0=90=D0=BD=D0=B4?= =?UTF-8?q?=D1=80=D0=B5=D0=B9?= Date: Mon, 1 Jun 2026 07:55:45 +0300 Subject: [PATCH] Preserve QExcell cell borders --- README.md | 4 ++-- src/features/qexcell/QExcell.tsx | 15 +++++++++++-- src/io/excellOffice.test.ts | 37 ++++++++++++++++++++++++++++--- src/io/excellOffice.ts | 38 +++++++++++++++++++++++++++++--- src/styles.css | 5 +++++ src/types.ts | 1 + 6 files changed, 90 insertions(+), 10 deletions(-) diff --git a/README.md b/README.md index a19c3c4..8a754f5 100644 --- a/README.md +++ b/README.md @@ -32,7 +32,7 @@ npm run build ## Поддержка форматов - QWord открывает `.docx` и сохраняет `.docx`; при импорте базовых DOCX-абзацев читает выравнивание, внешние гиперссылки, явные цвета текста, подсветку, размер и семейство шрифта из OOXML, а при экспорте DOCX сохраняются заголовки, абзацы, выравнивание абзацев, списки, простые таблицы, внешние гиперссылки, базовые растровые изображения и базовое inline-форматирование текста: полужирный, курсив, подчеркивание, зачеркивание, цвет текста, подсветка, размер и семейство шрифта. -- QExcell открывает `.xlsx` и сохраняет `.xlsx`; сетка расширяется по фактически заполненным ячейкам, поддерживает несколько листов, формулы за пределами стартового диапазона A-H, базовые merged cells, внешние гиперссылки ячеек, базовые диаграммы листа и базовое форматирование ячеек: полужирный, курсив, подчеркивание, зачеркивание, размер и семейство шрифта, цвет текста, заливку, горизонтальное и вертикальное выравнивание, перенос текста и числовые форматы XLSX для дат, процентов, денежных и дробных значений. +- QExcell открывает `.xlsx` и сохраняет `.xlsx`; сетка расширяется по фактически заполненным ячейкам, поддерживает несколько листов, формулы за пределами стартового диапазона A-H, базовые merged cells, внешние гиперссылки ячеек, базовые диаграммы листа и базовое форматирование ячеек: полужирный, курсив, подчеркивание, зачеркивание, размер и семейство шрифта, цвет текста, заливку, горизонтальное и вертикальное выравнивание, перенос текста, границы ячеек и числовые форматы XLSX для дат, процентов, денежных и дробных значений. - QPowerPoint открывает `.pptx` и сохраняет `.pptx`; импорт учитывает порядок слайдов из `presentation.xml`, читает заметки докладчика через relationships слайда, сохраняет заметки докладчика, базовые растровые изображения слайдов, пользовательский цвет фона слайда, а также цвет, размер и семейство шрифта текста заголовка/подзаголовка. - QOutlook открывает `.eml` и одиночные сообщения Outlook `.msg`, сохраняет письма в `.eml`; импорт EML поддерживает простые текстовые письма, `multipart/alternative`, `multipart/mixed`, `text/plain`, fallback из `text/html` в читаемый текст, base64, quoted-printable, MIME-вложения, `To`, `Cc` и `Bcc`. Импорт MSG читает тему, отправителя, получателей `To/Cc/Bcc`, текст/HTML body и вложения, если эти поля доступны в MSG-файле. Новые письма можно адресовать через `To/Cc/Bcc` и сохранять в EML вместе с добавленными файлами. `.pst` и экспорт в `.msg` пока не реализованы. @@ -46,7 +46,7 @@ Desktop-меню поддерживает системные команды дл - `Ctrl/Cmd+Shift+E`: экспортировать текущую рабочую область в PDF. - `Ctrl/Cmd+P`: печать текущей рабочей области. -Импорт и экспорт реализуют базовую совместимость с Office Open XML, EML и чтением MSG: текст, базовое inline-форматирование, явные `w:color`, `w:shd`, `w:highlight`, `w:sz`, `w:rFonts` и `w:strike` для цвета/подсветки/размера/семейства/зачеркивания текста DOCX, выравнивание абзацев DOCX, внешние гиперссылки DOCX/XLSX, базовые растровые изображения DOCX/PPTX, простые таблицы, несколько листов XLSX, ячейки, формулы, базовые merged cells, базовые стили, цвета текста, размеры и семейства шрифта, зачеркивание ячеек, горизонтальное и вертикальное выравнивание и перенос текста ячеек, числовые форматы и простые bar/line/pie диаграммы ячеек XLSX, текстовые слайды PPTX, пользовательский фон слайдов PPTX, цвет, размер и семейство шрифта текста заголовка/подзаголовка PPTX, импорт и экспорт заметок докладчика, адресацию `To/Cc/Bcc`, MIME-вложения EML и базовые поля одиночных MSG-писем. Сложные стили, макросы, сложные диаграммы, сложное позиционирование и обтекание изображений, PST, экспорт MSG и полная fidelity документов Microsoft Office в текущем инкременте не заявлены. +Импорт и экспорт реализуют базовую совместимость с Office Open XML, EML и чтением MSG: текст, базовое inline-форматирование, явные `w:color`, `w:shd`, `w:highlight`, `w:sz`, `w:rFonts` и `w:strike` для цвета/подсветки/размера/семейства/зачеркивания текста DOCX, выравнивание абзацев DOCX, внешние гиперссылки DOCX/XLSX, базовые растровые изображения DOCX/PPTX, простые таблицы, несколько листов XLSX, ячейки, формулы, базовые merged cells, базовые стили, цвета текста, размеры и семейства шрифта, зачеркивание ячеек, горизонтальное и вертикальное выравнивание, перенос текста и границы ячеек, числовые форматы и простые bar/line/pie диаграммы ячеек XLSX, текстовые слайды PPTX, пользовательский фон слайдов PPTX, цвет, размер и семейство шрифта текста заголовка/подзаголовка PPTX, импорт и экспорт заметок докладчика, адресацию `To/Cc/Bcc`, MIME-вложения EML и базовые поля одиночных MSG-писем. Сложные стили, макросы, сложные диаграммы, сложное позиционирование и обтекание изображений, PST, экспорт MSG и полная fidelity документов Microsoft Office в текущем инкременте не заявлены. ## Сборка пакета diff --git a/src/features/qexcell/QExcell.tsx b/src/features/qexcell/QExcell.tsx index cad53c6..ee3d547 100644 --- a/src/features/qexcell/QExcell.tsx +++ b/src/features/qexcell/QExcell.tsx @@ -22,6 +22,7 @@ import { Plus, Save, Sigma, + SquareDashed, Strikethrough, Trash2, Type, @@ -135,6 +136,7 @@ function normalizedCellFormat(format: CellFormat): CellFormat | undefined { ...(horizontalAlign ? { horizontalAlign } : {}), ...(verticalAlign ? { verticalAlign } : {}), ...(format.wrapText ? { wrapText: true } : {}), + ...(format.border ? { border: true } : {}), ...(numberFormat ? { numberFormat } : {}) }; @@ -286,7 +288,7 @@ export function QExcell({ workbook, onChange }: QExcellProps) { }); } - function toggleSelectedFormat(key: "bold" | "italics" | "underline" | "strike" | "wrapText") { + function toggleSelectedFormat(key: "bold" | "italics" | "underline" | "strike" | "wrapText" | "border") { updateCellFormat(selectedCell, { [key]: !selectedCellFormat[key] }); } @@ -536,6 +538,15 @@ export function QExcell({ workbook, onChange }: QExcellProps) { > + {horizontalAlignOptions.map((option) => { const Icon = option.icon; const isActive = selectedCellFormat.horizontalAlign === option.value; @@ -691,7 +702,7 @@ export function QExcell({ workbook, onChange }: QExcellProps) { return ( { expect(stylesXml).toContain('vertical="center"'); }); + it("записывает границы ячейки XLSX в styles.xml", async () => { + const blob = await exportXlsxBlob({ + id: "workbook", + title: "Borders.xlsx", + updatedAt: "2026-06-01T00:00:00.000Z", + activeSheet: "sheet-1", + sheets: [ + { + id: "sheet-1", + name: "Sheet 1", + cells: { A1: "Bordered" }, + cellFormats: { A1: { border: true } } + } + ] + }); + const zip = await JSZip.loadAsync(await blob.arrayBuffer()); + const stylesXml = await zip.file("xl/styles.xml")?.async("string"); + + expect(stylesXml).toContain(''); + expect(stylesXml).toContain('applyBorder="1"'); + expect(stylesXml).toContain(''); + expect(stylesXml).toContain(''); + expect(stylesXml).toContain(''); + expect(stylesXml).toContain(''); + }); + it("читает базовое форматирование ячеек XLSX из styles.xml и XML листа", () => { const styleTable = xlsxStylesXmlToCellFormatTable({ styleSheet: { @@ -189,10 +215,13 @@ describe("excellOffice OOXML helpers", () => { fills: { fill: [{}, {}, { patternFill: { fgColor: { rgb: "FFFFF2CC" } } }] }, + borders: { + border: [{}, { left: { style: "thin" }, right: { style: "thin" }, top: { style: "thin" }, bottom: { style: "thin" } }] + }, cellXfs: { xf: [ { fontId: "0", fillId: "0" }, - { fontId: "1", fillId: "2", numFmtId: "164", alignment: { horizontal: "center", vertical: "center", wrapText: "1" } }, + { fontId: "1", fillId: "2", borderId: "1", numFmtId: "164", alignment: { horizontal: "center", vertical: "center", wrapText: "1" } }, { fontId: "0", fillId: "0", numFmtId: "14" } ] } @@ -211,6 +240,7 @@ describe("excellOffice OOXML helpers", () => { horizontalAlign: "center", verticalAlign: "middle", wrapText: true, + border: true, numberFormat: "dd.mm.yyyy" }); expect(styleTable[2]).toEqual({ numberFormat: "m/d/yy" }); @@ -241,6 +271,7 @@ describe("excellOffice OOXML helpers", () => { horizontalAlign: "center", verticalAlign: "middle", wrapText: true, + border: true, numberFormat: "dd.mm.yyyy" } }); @@ -442,7 +473,7 @@ describe("excellOffice OOXML helpers", () => { mergedCells: [{ start: "A1", end: "C1" }], hyperlinks: { A1: "https://example.com/budget" }, cellFormats: { - A1: { bold: true, strike: true, fontSize: 14, fontFamily: "Arial", textColor: "0F5FAE", fillColor: "FFF2CC", horizontalAlign: "center", verticalAlign: "middle", wrapText: true }, + A1: { bold: true, strike: true, fontSize: 14, fontFamily: "Arial", textColor: "0F5FAE", fillColor: "FFF2CC", horizontalAlign: "center", verticalAlign: "middle", wrapText: true, border: true }, AC20: { underline: true }, D20: { numberFormat: "dd.mm.yyyy" }, E20: { numberFormat: "0%" } @@ -476,7 +507,7 @@ describe("excellOffice OOXML helpers", () => { expect(imported.sheets[0].mergedCells).toEqual([{ start: "A1", end: "C1" }]); expect(imported.sheets[0].hyperlinks).toEqual({ A1: "https://example.com/budget" }); expect(imported.sheets[0].cellFormats).toEqual({ - A1: { bold: true, strike: true, fontSize: 14, fontFamily: "Arial", textColor: "0F5FAE", fillColor: "FFF2CC", horizontalAlign: "center", verticalAlign: "middle", wrapText: true }, + A1: { bold: true, strike: true, fontSize: 14, fontFamily: "Arial", textColor: "0F5FAE", fillColor: "FFF2CC", horizontalAlign: "center", verticalAlign: "middle", wrapText: true, border: true }, AC20: { underline: true }, D20: { numberFormat: "dd.mm.yyyy" }, E20: { numberFormat: "0%" } diff --git a/src/io/excellOffice.ts b/src/io/excellOffice.ts index efabc2e..c2edf04 100644 --- a/src/io/excellOffice.ts +++ b/src/io/excellOffice.ts @@ -844,11 +844,13 @@ export function xlsxStylesXmlToCellFormatTable(stylesXml?: unknown): Array { const record = asRecord(xf); const fontFormat = fonts[numberAttribute(record.fontId)]; const fillFormat = fills[numberAttribute(record.fillId)]; + const borderFormat = borders[numberAttribute(record.borderId)]; const numberFormat = normalizedNumberFormat(numberFormats[numberAttribute(record.numFmtId)]); const alignment = childRecord(record, "alignment"); const horizontalAlign = normalizedHorizontalAlign(String(alignment.horizontal || "")); @@ -857,6 +859,7 @@ export function xlsxStylesXmlToCellFormatTable(stylesXml?: unknown): Array', '']; + const borders = [baseBorderXml()]; const fontIdsByKey: Record = {}; const fillIdsByColor: Record = {}; const numberFormatIdsByCode: Record = {}; @@ -893,6 +897,14 @@ function buildStylesXml(styleRegistry = createCellStyleRegistry([])) { } } + let borderId = 0; + if (format.border) { + borderId = 1; + if (borders.length === 1) { + borders.push(formatBorderXml()); + } + } + let numFmtId = 0; if (format.numberFormat) { numFmtId = numberFormatIdsByCode[format.numberFormat] ?? customNumberFormatStartId + customNumberFormats.length; @@ -904,6 +916,7 @@ function buildStylesXml(styleRegistry = createCellStyleRegistry([])) { const applyFont = fontId > 0 ? ' applyFont="1"' : ""; const applyFill = fillId > 0 ? ' applyFill="1"' : ""; + const applyBorder = borderId > 0 ? ' applyBorder="1"' : ""; const applyAlignment = format.horizontalAlign || format.verticalAlign || format.wrapText ? ' applyAlignment="1"' : ""; const applyNumberFormat = numFmtId > 0 ? ' applyNumberFormat="1"' : ""; const alignmentAttributes = [ @@ -914,7 +927,7 @@ function buildStylesXml(styleRegistry = createCellStyleRegistry([])) { .filter(Boolean) .join(" "); const alignmentXml = alignmentAttributes ? `` : ""; - return `${alignmentXml}`; + return `${alignmentXml}`; }); const numFmtsXml = @@ -925,7 +938,7 @@ function buildStylesXml(styleRegistry = createCellStyleRegistry([])) { : ""; return xmlDeclaration( - `${numFmtsXml}${fonts.join("")}${fills.join("")}${cellXfs.join("")}` + `${numFmtsXml}${fonts.join("")}${fills.join("")}${borders.join("")}${cellXfs.join("")}` ); } @@ -953,7 +966,7 @@ function cellFormatKey(format: CellFormat | undefined) { return ""; } - return `${normalized.bold ? "1" : "0"}|${normalized.italics ? "1" : "0"}|${normalized.underline ? "1" : "0"}|${normalized.strike ? "1" : "0"}|${normalized.fontSize ?? ""}|${normalized.fontFamily ?? ""}|${normalized.textColor ?? ""}|${normalized.fillColor ?? ""}|${normalized.horizontalAlign ?? ""}|${normalized.verticalAlign ?? ""}|${normalized.wrapText ? "1" : "0"}|${normalized.numberFormat ?? ""}`; + return `${normalized.bold ? "1" : "0"}|${normalized.italics ? "1" : "0"}|${normalized.underline ? "1" : "0"}|${normalized.strike ? "1" : "0"}|${normalized.fontSize ?? ""}|${normalized.fontFamily ?? ""}|${normalized.textColor ?? ""}|${normalized.fillColor ?? ""}|${normalized.horizontalAlign ?? ""}|${normalized.verticalAlign ?? ""}|${normalized.wrapText ? "1" : "0"}|${normalized.border ? "1" : "0"}|${normalized.numberFormat ?? ""}`; } function fontStyleKey(format: CellFormat) { @@ -982,6 +995,7 @@ function normalizedCellFormat(format: CellFormat | undefined): CellFormat | null ...(horizontalAlign ? { horizontalAlign } : {}), ...(verticalAlign ? { verticalAlign } : {}), ...(format?.wrapText ? { wrapText: true } : {}), + ...(format?.border ? { border: true } : {}), ...(numberFormat ? { numberFormat } : {}) }; @@ -1012,6 +1026,16 @@ function fillXmlToCellFormat(fill: unknown): CellFormat { return fillColor ? { fillColor } : {}; } +function borderXmlToCellFormat(border: unknown): CellFormat { + const record = asRecord(border); + const hasBorder = ["left", "right", "top", "bottom"].some((side) => { + const style = String(childRecord(record, side).style || childRecord(record, side)["@_style"] || "").trim().toLowerCase(); + return style && style !== "none"; + }); + + return hasBorder ? { border: true } : {}; +} + function baseFontXml() { return ''; } @@ -1026,6 +1050,14 @@ function formatFillXml(fillColor: string) { return ``; } +function baseBorderXml() { + return ""; +} + +function formatBorderXml() { + return ''; +} + function normalizeFillColor(value?: string) { const raw = value?.trim().replace(/^#/, "").toUpperCase() ?? ""; if (/^[0-9A-F]{8}$/.test(raw)) { diff --git a/src/styles.css b/src/styles.css index bbaaab2..5976ad5 100644 --- a/src/styles.css +++ b/src/styles.css @@ -732,6 +732,11 @@ button { height: 58px; } +.sheet-grid td.is-bordered { + border-color: #334155; + box-shadow: inset 0 0 0 1px #334155; +} + .sheet-grid td.is-valign-top input { padding-top: 0; padding-bottom: 8px; diff --git a/src/types.ts b/src/types.ts index 31b8277..e89d3d2 100644 --- a/src/types.ts +++ b/src/types.ts @@ -37,6 +37,7 @@ export interface CellFormat { horizontalAlign?: "left" | "center" | "right"; verticalAlign?: "top" | "middle" | "bottom"; wrapText?: boolean; + border?: boolean; numberFormat?: string; }