From 7337dbf5cd57916142de910108cef387379e93d9 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 19:48:24 +0300 Subject: [PATCH] Preserve QExcell print areas in XLSX --- README.md | 4 +- src/features/qexcell/QExcell.tsx | 24 ++++++++ src/io/excellOffice.test.ts | 41 +++++++++++++ src/io/excellOffice.ts | 100 +++++++++++++++++++++++++++++-- src/types.ts | 1 + 5 files changed, 163 insertions(+), 7 deletions(-) diff --git a/README.md b/README.md index 1f97664..9a03c8f 100644 --- a/README.md +++ b/README.md @@ -32,7 +32,7 @@ npm run build ## Поддержка форматов - QWord открывает `.docx` и сохраняет `.docx`; при импорте базовых DOCX-абзацев читает выравнивание, переносы строк, разрывы страниц, табуляцию, закладки, внешние и внутренние гиперссылки-якоря, простые таблицы, базовые растровые изображения, явные цвета текста, подсветку, размер и семейство шрифта из OOXML, а при экспорте DOCX сохраняются заголовки, абзацы, переносы строк, разрывы страниц, табуляция, выравнивание абзацев, закладки из HTML `id`, списки, простые таблицы, внешние и внутренние гиперссылки-якоря, базовые растровые изображения и базовое inline-форматирование текста: полужирный, курсив, подчеркивание, зачеркивание, цвет текста, подсветка, размер и семейство шрифта. -- QExcell открывает `.xlsx` и сохраняет `.xlsx`; сетка расширяется по фактически заполненным ячейкам, поддерживает несколько листов, скрытые и veryHidden листы через `sheet state`, закрепленные области через `sheetViews pane`, скрытие сетки через `sheetView showGridLines`, масштаб листа через `sheetView zoomScale`, автофильтр через `autoFilter ref`, цвет вкладки листа через `sheetPr tabColor`, ширину колонок через `cols/col width`, высоту строк через `row ht/customHeight`, активный лист через `workbookView activeTab`, формулы за пределами стартового диапазона A-H, shared formulas XLSX с относительными ссылками, базовые merged cells, внешние и внутренние гиперссылки ячеек, базовые диаграммы листа и базовое форматирование ячеек: полужирный, курсив, подчеркивание, зачеркивание, размер и семейство шрифта, прямые RGB/theme/indexed цвета текста с учетом `xl/theme/theme1.xml`, заливку, горизонтальное и вертикальное выравнивание, перенос текста, границы и цвет границ ячеек, числовые форматы XLSX для дат, процентов, денежных и дробных значений. +- QExcell открывает `.xlsx` и сохраняет `.xlsx`; сетка расширяется по фактически заполненным ячейкам, поддерживает несколько листов, скрытые и veryHidden листы через `sheet state`, закрепленные области через `sheetViews pane`, скрытие сетки через `sheetView showGridLines`, масштаб листа через `sheetView zoomScale`, автофильтр через `autoFilter ref`, область печати через `_xlnm.Print_Area`, цвет вкладки листа через `sheetPr tabColor`, ширину колонок через `cols/col width`, высоту строк через `row ht/customHeight`, активный лист через `workbookView activeTab`, формулы за пределами стартового диапазона A-H, shared formulas XLSX с относительными ссылками, базовые merged cells, внешние и внутренние гиперссылки ячеек, базовые диаграммы листа и базовое форматирование ячеек: полужирный, курсив, подчеркивание, зачеркивание, размер и семейство шрифта, прямые RGB/theme/indexed цвета текста с учетом `xl/theme/theme1.xml`, заливку, горизонтальное и вертикальное выравнивание, перенос текста, границы и цвет границ ячеек, числовые форматы XLSX для дат, процентов, денежных и дробных значений. - QPowerPoint открывает `.pptx` и сохраняет `.pptx`; импорт учитывает порядок слайдов из `presentation.xml`, переносы абзацев и ручные переносы строк `a:br` внутри текстовых блоков, скрытые слайды через атрибут `show`, а также заметки докладчика через relationships слайда, сохраняет скрытые слайды, заметки докладчика, базовые растровые изображения слайдов, пользовательский цвет фона слайда, а также цвет, размер и семейство шрифта текста заголовка/подзаголовка. - QOutlook открывает `.eml` и одиночные сообщения Outlook `.msg`, сохраняет письма в `.eml`; импорт EML поддерживает простые текстовые письма, `multipart/alternative`, `multipart/mixed`, `multipart/related`, `text/plain`, fallback из `text/html` в читаемый текст, base64, quoted-printable, MIME encoded-word заголовки UTF-8/windows-1251, MIME-вложения и inline-вложения с `Content-ID`, `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:br`, `w:br w:type="page"`, `w:tab`, `w:color`, `w:shd`, `w:highlight`, `w:sz`, `w:rFonts` и `w:strike` для переносов строк/разрывов страниц/табуляции/цвета/подсветки/размера/семейства/зачеркивания текста DOCX, выравнивание абзацев DOCX, закладки DOCX через `w:bookmarkStart`/`w:bookmarkEnd`, внешние `w:hyperlink r:id` и внутренние `w:hyperlink w:anchor` гиперссылки DOCX, внешние и внутренние гиперссылки XLSX, базовые растровые изображения DOCX/PPTX, простые таблицы, несколько листов, скрытые/veryHidden листы через `sheet state`, закрепленные области через `sheetViews pane`, скрытие сетки через `sheetView showGridLines`, масштаб листа через `sheetView zoomScale`, автофильтр через `autoFilter ref`, цвет вкладки листа через `sheetPr tabColor`, ширину колонок через `cols/col width`, высоту строк через `row ht/customHeight` и активный лист XLSX через `workbookView activeTab`, ячейки, формулы, shared formulas XLSX с относительными ссылками, базовые merged cells, базовые стили, RGB/theme/indexed цвета XLSX с учетом `xl/theme/theme1.xml`, размеры и семейства шрифта, зачеркивание ячеек, горизонтальное и вертикальное выравнивание, перенос текста, границы и цвет границ ячеек, числовые форматы и простые bar/line/pie диаграммы ячеек XLSX, текстовые слайды PPTX с переносами абзацев и ручными переносами строк `a:br` при импорте, скрытые слайды PPTX через атрибут `show`, пользовательский фон слайдов PPTX, цвет, размер и семейство шрифта текста заголовка/подзаголовка PPTX, импорт и экспорт заметок докладчика, адресацию `To/Cc/Bcc`, MIME encoded-word заголовки UTF-8/windows-1251, MIME-вложения EML, inline-вложения EML с `Content-ID` и базовые поля одиночных MSG-писем. Сложные стили, макросы, сложные диаграммы, сложное позиционирование и обтекание изображений, PST, экспорт MSG и полная fidelity документов Microsoft Office в текущем инкременте не заявлены. +Импорт и экспорт реализуют базовую совместимость с Office Open XML, EML и чтением MSG: текст, базовое inline-форматирование, явные `w:br`, `w:br w:type="page"`, `w:tab`, `w:color`, `w:shd`, `w:highlight`, `w:sz`, `w:rFonts` и `w:strike` для переносов строк/разрывов страниц/табуляции/цвета/подсветки/размера/семейства/зачеркивания текста DOCX, выравнивание абзацев DOCX, закладки DOCX через `w:bookmarkStart`/`w:bookmarkEnd`, внешние `w:hyperlink r:id` и внутренние `w:hyperlink w:anchor` гиперссылки DOCX, внешние и внутренние гиперссылки XLSX, базовые растровые изображения DOCX/PPTX, простые таблицы, несколько листов, скрытые/veryHidden листы через `sheet state`, закрепленные области через `sheetViews pane`, скрытие сетки через `sheetView showGridLines`, масштаб листа через `sheetView zoomScale`, автофильтр через `autoFilter ref`, область печати XLSX через `_xlnm.Print_Area`, цвет вкладки листа через `sheetPr tabColor`, ширину колонок через `cols/col width`, высоту строк через `row ht/customHeight` и активный лист XLSX через `workbookView activeTab`, ячейки, формулы, shared formulas XLSX с относительными ссылками, базовые merged cells, базовые стили, RGB/theme/indexed цвета XLSX с учетом `xl/theme/theme1.xml`, размеры и семейства шрифта, зачеркивание ячеек, горизонтальное и вертикальное выравнивание, перенос текста, границы и цвет границ ячеек, числовые форматы и простые bar/line/pie диаграммы ячеек XLSX, текстовые слайды PPTX с переносами абзацев и ручными переносами строк `a:br` при импорте, скрытые слайды PPTX через атрибут `show`, пользовательский фон слайдов PPTX, цвет, размер и семейство шрифта текста заголовка/подзаголовка PPTX, импорт и экспорт заметок докладчика, адресацию `To/Cc/Bcc`, MIME encoded-word заголовки UTF-8/windows-1251, MIME-вложения EML, inline-вложения EML с `Content-ID` и базовые поля одиночных MSG-писем. Сложные стили, макросы, сложные диаграммы, сложное позиционирование и обтекание изображений, PST, экспорт MSG и полная fidelity документов Microsoft Office в текущем инкременте не заявлены. ## Сборка пакета diff --git a/src/features/qexcell/QExcell.tsx b/src/features/qexcell/QExcell.tsx index f93e481..9ca5121 100644 --- a/src/features/qexcell/QExcell.tsx +++ b/src/features/qexcell/QExcell.tsx @@ -216,6 +216,14 @@ function normalizedChartRange(value: string) { return `${start}:${end}`; } +function normalizedPrintAreaInput(value: string) { + const ranges = value + .split(",") + .map(normalizedChartRange) + .filter(Boolean); + return [...new Set(ranges)].join(","); +} + function chartTypeIcon(type: SheetChartType) { if (type === "line") { return LineChart; @@ -353,6 +361,13 @@ export function QExcell({ workbook, onChange }: QExcellProps) { }); } + function updateActiveSheetPrintArea(printArea: string) { + onChange({ + ...workbook, + sheets: workbook.sheets.map((sheet) => (sheet.id === activeSheet.id ? { ...sheet, printArea: printArea || undefined } : sheet)) + }); + } + function selectChart(chart: SheetChart) { setSelectedChartId(chart.id); setChartTitle(chart.title); @@ -815,6 +830,15 @@ export function QExcell({ workbook, onChange }: QExcellProps) { Имя листа updateActiveSheetName(event.target.value)} /> +

Выделение

diff --git a/src/io/excellOffice.test.ts b/src/io/excellOffice.test.ts index 4aebf9d..0b21c22 100644 --- a/src/io/excellOffice.test.ts +++ b/src/io/excellOffice.test.ts @@ -17,6 +17,7 @@ import { chartDataPoints, chartXmlToSheetChart, workbookActiveSheetId, + workbookPrintAreas, workbookRelationshipTargets, workbookSheetRefs, worksheetXmlToAutoFilter, @@ -576,6 +577,46 @@ describe("excellOffice OOXML helpers", () => { expect(imported.activeSheet).toBe("sheet-2"); }); + it("сохраняет и импортирует область печати XLSX через definedName _xlnm.Print_Area", async () => { + expect( + workbookPrintAreas( + { + workbook: { + definedNames: { + definedName: [ + { name: "_xlnm.Print_Area", localSheetId: "0", "#text": "'Отчет'!$D$20:$A$1" }, + { name: "_xlnm.Print_Area", localSheetId: "1", "#text": "'Архив'!$B$2:$C$4,'Архив'!$E$1:$E$3" } + ] + } + } + }, + [ + { id: "sheet-1", name: "Отчет" }, + { id: "sheet-2", name: "Архив" } + ] + ) + ).toEqual({ "sheet-1": "A1:D20", "sheet-2": "B2:C4,E1:E3" }); + + const blob = await exportXlsxBlob({ + id: "book-1", + title: "Область печати.xlsx", + updatedAt: "2026-06-01T00:00:00.000Z", + activeSheet: "sheet-1", + sheets: [ + { id: "sheet-1", name: "Отчет", printArea: "D20:A1", cells: { A1: "Начало", D20: "Итог" } }, + { id: "sheet-2", name: "Архив", printArea: "B2:C4,E1:E3", cells: { B2: "Архив" } } + ] + }); + const zip = await JSZip.loadAsync(await blob.arrayBuffer()); + const workbookXml = await zip.file("xl/workbook.xml")?.async("string"); + const imported = await importXlsxFile(new File([blob], "Область печати.xlsx", { type: blob.type })); + + expect(workbookXml).toContain('\'Отчет\'!$A$1:$D$20'); + expect(workbookXml).toContain('\'Архив\'!$B$2:$C$4,\'Архив\'!$E$1:$E$3'); + expect(imported.sheets[0].printArea).toBe("A1:D20"); + expect(imported.sheets[1].printArea).toBe("B2:C4,E1:E3"); + }); + it("сохраняет и импортирует скрытые листы XLSX через sheet state", async () => { const blob = await exportXlsxBlob({ id: "book-1", diff --git a/src/io/excellOffice.ts b/src/io/excellOffice.ts index d381478..5949449 100644 --- a/src/io/excellOffice.ts +++ b/src/io/excellOffice.ts @@ -16,6 +16,7 @@ export interface ImportedExcellWorkbook { rowHeights?: Record; showGridLines?: boolean; zoomScale?: number; + printArea?: string; cells: Record; mergedCells?: MergedCellRange[]; hyperlinks?: Record; @@ -70,6 +71,7 @@ interface ParsedSheet { rowHeights?: Record; showGridLines?: boolean; zoomScale?: number; + printArea?: string; cells: Record; mergedCells?: MergedCellRange[]; hyperlinks?: Record; @@ -210,12 +212,22 @@ export async function importXlsxFile(file: File): Promise { const target = relationshipTargets[sheet.relationshipId]; if (!target) { - return { id: sheet.id, name: sheet.name, cells: {}, mergedCells: [], hyperlinks: {}, cellFormats: {}, charts: [] }; + return { + id: sheet.id, + name: sheet.name, + ...(printAreas[sheet.id] ? { printArea: printAreas[sheet.id] } : {}), + cells: {}, + mergedCells: [], + hyperlinks: {}, + cellFormats: {}, + charts: [] + }; } const sheetPath = resolveWorkbookTarget(target); @@ -223,7 +235,7 @@ export async function importXlsxFile(file: File): Promise { buildWorkbookXml( sheets.map((sheet, index) => ({ name: sheet.name.trim() || `Лист ${index + 1}`, - ...(sheet.visibility ? { visibility: sheet.visibility } : {}) + ...(sheet.visibility ? { visibility: sheet.visibility } : {}), + ...(sheet.printArea ? { printArea: sheet.printArea } : {}) })), activeSheetIndex ) @@ -901,6 +914,28 @@ export function workbookActiveSheetId(workbookXml: unknown, sheets: Array<{ id: return sheets[activeTab]?.id ?? ""; } +export function workbookPrintAreas(workbookXml: unknown, sheets: Array<{ id: string; name: string }>): Record { + const workbook = childRecord(workbookXml, "workbook"); + const definedNames = childRecord(workbook, "definedNames"); + + return toArray(definedNames.definedName).reduce>((areas, definedName) => { + const record = asRecord(definedName); + const name = String(record.name ?? record["@_name"] ?? "").trim(); + const localSheetId = Number.parseInt(String(record.localSheetId ?? record["@_localSheetId"] ?? ""), 10); + const sheet = Number.isInteger(localSheetId) && localSheetId >= 0 ? sheets[localSheetId] : undefined; + if (name !== "_xlnm.Print_Area" || !sheet) { + return areas; + } + + const printArea = printAreaFromDefinedName(xmlNodeText(record), sheet.name); + if (printArea) { + areas[sheet.id] = printArea; + } + + return areas; + }, {}); +} + export function workbookRelationshipTargets(relationshipsXml: unknown) { const relationships = childRecord(relationshipsXml, "Relationships"); const targets: Record = {}; @@ -954,7 +989,7 @@ function buildRootRelationshipsXml() { ); } -function buildWorkbookXml(sheets: Array<{ name: string; visibility?: WorkbookSheetRef["visibility"] }>, activeSheetIndex = 0) { +function buildWorkbookXml(sheets: Array<{ name: string; visibility?: WorkbookSheetRef["visibility"]; printArea?: string }>, activeSheetIndex = 0) { const activeTab = Math.min(Math.max(0, activeSheetIndex), Math.max(0, sheets.length - 1)); const bookViews = ``; const sheetXml = sheets @@ -963,12 +998,27 @@ function buildWorkbookXml(sheets: Array<{ name: string; visibility?: WorkbookShe return ``; }) .join(""); + const definedNames = buildWorkbookDefinedNamesXml(sheets); return xmlDeclaration( - `${bookViews}${sheetXml}` + `${bookViews}${sheetXml}${definedNames}` ); } +function buildWorkbookDefinedNamesXml(sheets: Array<{ name: string; printArea?: string }>) { + const definedNames = sheets + .map((sheet, index) => { + const printArea = normalizePrintArea(sheet.printArea ?? ""); + return printArea + ? `${escapeXmlText(printAreaFormula(sheet.name, printArea))}` + : ""; + }) + .filter(Boolean) + .join(""); + + return definedNames ? `${definedNames}` : ""; +} + function buildWorkbookRelationshipsXml(sheetCount: number) { const sheetRelationships = Array.from({ length: sheetCount }, (_, index) => { return ``; @@ -1122,6 +1172,13 @@ function chartRangeFormula(sheetName: string, range: string) { return `${quotedSheetName(sheetName)}!${absoluteChartRange(range)}`; } +function printAreaFormula(sheetName: string, printArea: string) { + return normalizePrintArea(printArea) + .split(",") + .map((range) => `${quotedSheetName(sheetName)}!${absolutePrintAreaRange(range)}`) + .join(","); +} + function quotedSheetName(sheetName: string) { return `'${sheetName.replace(/'/g, "''")}'`; } @@ -1132,6 +1189,12 @@ function absoluteChartRange(range: string) { return `${absoluteCellAddress(start)}:${absoluteCellAddress(end)}`; } +function absolutePrintAreaRange(range: string) { + const normalized = normalizeCellRange(range); + const [start, end = start] = normalized.split(":"); + return `${absoluteCellAddress(start)}:${absoluteCellAddress(end)}`; +} + function absoluteCellAddress(address: string) { const column = address.match(/^[A-Z]+/i)?.[0]?.toUpperCase() ?? "A"; const row = address.match(/[1-9][0-9]*$/)?.[0] ?? "1"; @@ -1869,6 +1932,33 @@ function normalizeCellRange(range: string) { return normalized ? `${normalized.start}:${normalized.end}` : normalizedStart; } +function normalizePrintArea(value: string) { + const ranges = value + .split(",") + .map((range) => normalizeCellRange(range)) + .filter(Boolean); + return [...new Set(ranges)].join(","); +} + +function printAreaFromDefinedName(value: string, sheetName: string) { + const ranges = value + .split(",") + .map((range) => printAreaRangeFromFormula(range, sheetName)) + .filter(Boolean); + return [...new Set(ranges)].join(","); +} + +function printAreaRangeFromFormula(formula: string, sheetName: string) { + const raw = formula.trim(); + const separatorIndex = raw.lastIndexOf("!"); + const rawSheetName = separatorIndex >= 0 ? raw.slice(0, separatorIndex).replace(/^'|'$/g, "").replace(/''/g, "'") : ""; + if (rawSheetName && rawSheetName !== sheetName) { + return ""; + } + + return normalizeCellRange((separatorIndex >= 0 ? raw.slice(separatorIndex + 1) : raw).replace(/\$/g, "")); +} + function uniqueNumbers(values: number[]) { return [...new Set(values)].sort((first, second) => first - second); } diff --git a/src/types.ts b/src/types.ts index 807b618..7027c84 100644 --- a/src/types.ts +++ b/src/types.ts @@ -26,6 +26,7 @@ export interface Sheet { rowHeights?: Record; showGridLines?: boolean; zoomScale?: number; + printArea?: string; cells: Record; mergedCells?: MergedCellRange[]; hyperlinks?: Record;