From f4da4dc283da2471e5fd28c7a2f1d60f0e12d1e9 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:21:01 +0300 Subject: [PATCH] Preserve QExcell worksheet zoom in XLSX --- README.md | 4 ++-- src/io/excellOffice.test.ts | 47 +++++++++++++++++++++++++++++++++++++ src/io/excellOffice.ts | 42 ++++++++++++++++++++++++++++----- src/types.ts | 1 + 4 files changed, 86 insertions(+), 8 deletions(-) diff --git a/README.md b/README.md index b036214..8b1c9ab 100644 --- a/README.md +++ b/README.md @@ -32,7 +32,7 @@ npm run build ## Поддержка форматов - QWord открывает `.docx` и сохраняет `.docx`; при импорте базовых DOCX-абзацев читает выравнивание, переносы строк, табуляцию, внешние гиперссылки, простые таблицы, базовые растровые изображения, явные цвета текста, подсветку, размер и семейство шрифта из OOXML, а при экспорте DOCX сохраняются заголовки, абзацы, переносы строк, табуляция, выравнивание абзацев, списки, простые таблицы, внешние гиперссылки, базовые растровые изображения и базовое inline-форматирование текста: полужирный, курсив, подчеркивание, зачеркивание, цвет текста, подсветка, размер и семейство шрифта. -- QExcell открывает `.xlsx` и сохраняет `.xlsx`; сетка расширяется по фактически заполненным ячейкам, поддерживает несколько листов, скрытые и veryHidden листы через `sheet state`, закрепленные области через `sheetViews pane`, скрытие сетки через `sheetView showGridLines`, автофильтр через `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`, цвет вкладки листа через `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` внутри текстовых блоков, а также заметки докладчика через 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:tab`, `w:color`, `w:shd`, `w:highlight`, `w:sz`, `w:rFonts` и `w:strike` для переносов строк/табуляции/цвета/подсветки/размера/семейства/зачеркивания текста DOCX, выравнивание абзацев DOCX, внешние гиперссылки DOCX, внешние и внутренние гиперссылки XLSX, базовые растровые изображения DOCX/PPTX, простые таблицы, несколько листов, скрытые/veryHidden листы через `sheet state`, закрепленные области через `sheetViews pane`, скрытие сетки через `sheetView showGridLines`, автофильтр через `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, цвет, размер и семейство шрифта текста заголовка/подзаголовка 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:tab`, `w:color`, `w:shd`, `w:highlight`, `w:sz`, `w:rFonts` и `w:strike` для переносов строк/табуляции/цвета/подсветки/размера/семейства/зачеркивания текста DOCX, выравнивание абзацев DOCX, внешние гиперссылки 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, цвет, размер и семейство шрифта текста заголовка/подзаголовка 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/io/excellOffice.test.ts b/src/io/excellOffice.test.ts index 345e676..4aebf9d 100644 --- a/src/io/excellOffice.test.ts +++ b/src/io/excellOffice.test.ts @@ -29,6 +29,7 @@ import { worksheetXmlToRowHeights, worksheetXmlToShowGridLines, worksheetXmlToTabColor, + worksheetXmlToZoomScale, xlsxStylesXmlToCellFormatTable, xlsxThemeXmlToColors, xlsxCellToText @@ -688,6 +689,52 @@ describe("excellOffice OOXML helpers", () => { expect(imported.sheets[0].showGridLines).toBe(false); }); + it("читает и записывает масштаб листа XLSX через sheetView zoomScale", async () => { + expect( + worksheetXmlToZoomScale({ + worksheet: { + sheetViews: { + sheetView: { zoomScale: "125" } + } + } + }) + ).toBe(125); + expect( + worksheetXmlToZoomScale({ + worksheet: { + sheetViews: { + sheetView: { zoomScale: "100" } + } + } + }) + ).toBe(0); + expect(buildSheetViewsXml(undefined, undefined, 125)).toBe(''); + expect(buildSheetViewsXml({ columns: 1 }, false, 90)).toBe( + '' + ); + + const blob = await exportXlsxBlob({ + id: "book-1", + title: "Zoom.xlsx", + updatedAt: "2026-06-01T00:00:00.000Z", + activeSheet: "sheet-1", + sheets: [ + { + id: "sheet-1", + name: "Zoom", + zoomScale: 125, + cells: { A1: "Zoomed" } + } + ] + }); + const zip = await JSZip.loadAsync(await blob.arrayBuffer()); + const sheetXml = (await zip.file("xl/worksheets/sheet1.xml")?.async("string")) ?? ""; + const imported = await importXlsxFile(new File([blob], "Zoom.xlsx", { type: blob.type })); + + expect(sheetXml).toContain(''); + expect(imported.sheets[0].zoomScale).toBe(125); + }); + it("читает и записывает автофильтр XLSX через autoFilter ref", async () => { expect( worksheetXmlToAutoFilter({ diff --git a/src/io/excellOffice.ts b/src/io/excellOffice.ts index afb134c..d381478 100644 --- a/src/io/excellOffice.ts +++ b/src/io/excellOffice.ts @@ -15,6 +15,7 @@ export interface ImportedExcellWorkbook { columnWidths?: Record; rowHeights?: Record; showGridLines?: boolean; + zoomScale?: number; cells: Record; mergedCells?: MergedCellRange[]; hyperlinks?: Record; @@ -68,6 +69,7 @@ interface ParsedSheet { columnWidths?: Record; rowHeights?: Record; showGridLines?: boolean; + zoomScale?: number; cells: Record; mergedCells?: MergedCellRange[]; hyperlinks?: Record; @@ -276,7 +278,8 @@ export async function exportXlsxBlob(workbook: Workbook): Promise { sheet.tabColor, sheet.columnWidths, sheet.rowHeights, - sheet.showGridLines + sheet.showGridLines, + sheet.zoomScale ) ); const relationshipsXml = buildWorksheetRelationshipsXml( @@ -315,6 +318,7 @@ export function parsedWorksheetToSheet( const columnWidths = worksheetXmlToColumnWidths(worksheetXml); const rowHeights = worksheetXmlToRowHeights(worksheetXml); const showGridLines = worksheetXmlToShowGridLines(worksheetXml); + const zoomScale = worksheetXmlToZoomScale(worksheetXml); return { id: sheet.id || `sheet-${index + 1}`, @@ -326,6 +330,7 @@ export function parsedWorksheetToSheet( ...(Object.keys(columnWidths).length > 0 ? { columnWidths } : {}), ...(Object.keys(rowHeights).length > 0 ? { rowHeights } : {}), ...(showGridLines === false ? { showGridLines } : {}), + ...(zoomScale ? { zoomScale } : {}), cells: worksheetXmlToCells(worksheetXml, sharedStrings), mergedCells: worksheetXmlToMergedCells(worksheetXml), hyperlinks: worksheetXmlToHyperlinks(worksheetXml, relationshipsXml), @@ -456,6 +461,13 @@ export function worksheetXmlToShowGridLines(worksheetXml: unknown): boolean | un return !isFalseXmlBoolean(value); } +export function worksheetXmlToZoomScale(worksheetXml: unknown) { + const worksheet = childRecord(worksheetXml, "worksheet"); + const sheetViews = childRecord(worksheet, "sheetViews"); + const sheetView = asRecord(toArray(sheetViews.sheetView)[0]); + return normalizedSheetZoomScale(sheetView.zoomScale); +} + export function worksheetXmlToAutoFilter(worksheetXml: unknown) { const worksheet = childRecord(worksheetXml, "worksheet"); const autoFilter = childRecord(worksheet, "autoFilter"); @@ -681,7 +693,8 @@ export function buildWorksheetXml( tabColor?: string, columnWidths: Record = {}, rowHeights: Record = {}, - showGridLines?: boolean + showGridLines?: boolean, + zoomScale?: number ) { const normalizedRowHeights = normalizedSheetRowHeights(rowHeights); const rows = sortedWorksheetEntries(cells, cellFormats).reduce>>((grouped, entry) => { @@ -712,7 +725,7 @@ export function buildWorksheetXml( const hyperlinksXml = buildHyperlinksXml(hyperlinks); const drawingXml = drawingRelationshipId ? `` : ""; const sheetPrXml = buildSheetPrXml(tabColor); - const sheetViewsXml = buildSheetViewsXml(frozenPane, showGridLines); + const sheetViewsXml = buildSheetViewsXml(frozenPane, showGridLines, zoomScale); const colsXml = buildColumnWidthsXml(columnWidths); return xmlDeclaration( @@ -773,13 +786,20 @@ export function buildHyperlinksXml(hyperlinks: Record = {}) { return `${hyperlinkXml}`; } -export function buildSheetViewsXml(frozenPane?: SheetFrozenPane, showGridLines?: boolean) { +export function buildSheetViewsXml(frozenPane?: SheetFrozenPane, showGridLines?: boolean, zoomScale?: number) { const pane = normalizedFrozenPane(frozenPane); - if (!pane && showGridLines !== false) { + const normalizedZoomScale = normalizedSheetZoomScale(zoomScale); + if (!pane && showGridLines !== false && !normalizedZoomScale) { return ""; } - const sheetViewAttributes = ["workbookViewId=\"0\"", showGridLines === false ? 'showGridLines="0"' : ""].filter(Boolean).join(" "); + const sheetViewAttributes = [ + "workbookViewId=\"0\"", + showGridLines === false ? 'showGridLines="0"' : "", + normalizedZoomScale ? `zoomScale="${normalizedZoomScale}"` : "" + ] + .filter(Boolean) + .join(" "); if (!pane) { return ``; } @@ -1545,6 +1565,16 @@ function normalizedSheetRowHeights(rowHeights: Record = {}) { }, {}); } +function normalizedSheetZoomScale(value: unknown) { + const number = Number(value); + if (!Number.isFinite(number)) { + return 0; + } + + const zoomScale = Math.round(number); + return zoomScale >= 10 && zoomScale <= 400 && zoomScale !== 100 ? zoomScale : 0; +} + function buildRowHeightAttributes(height?: number) { return height ? ` ht="${formatSheetDimension(height)}" customHeight="1"` : ""; } diff --git a/src/types.ts b/src/types.ts index 1cdda86..d4877bd 100644 --- a/src/types.ts +++ b/src/types.ts @@ -25,6 +25,7 @@ export interface Sheet { columnWidths?: Record; rowHeights?: Record; showGridLines?: boolean; + zoomScale?: number; cells: Record; mergedCells?: MergedCellRange[]; hyperlinks?: Record;