Preserve QExcell print areas in XLSX

2026-06-01 19:48:24 +03:00
parent f22c7af88b
commit 7337dbf5cd
5 changed files with 163 additions and 7 deletions
@@ -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 в текущем инкременте не заявлены.

 ## Сборка пакета

@@ -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) {
            Имя листа
            <input value={activeSheet.name} onChange={(event) => updateActiveSheetName(event.target.value)} />
          </label>
+          <label>
+            Область печати
+            <input
+              value={activeSheet.printArea ?? ""}
+              placeholder="A1:E20"
+              onChange={(event) => updateActiveSheetPrintArea(event.target.value)}
+              onBlur={(event) => updateActiveSheetPrintArea(normalizedPrintAreaInput(event.target.value))}
+            />
+          </label>
        </section>
        <section>
          <h3>Выделение</h3>
@@ -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('<definedNames><definedName name="_xlnm.Print_Area" localSheetId="0">\'Отчет\'!$A$1:$D$20</definedName>');
+    expect(workbookXml).toContain('<definedName name="_xlnm.Print_Area" localSheetId="1">\'Архив\'!$B$2:$C$4,\'Архив\'!$E$1:$E$3</definedName></definedNames>');
+    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",
@@ -16,6 +16,7 @@ export interface ImportedExcellWorkbook {
    rowHeights?: Record<string, number>;
    showGridLines?: boolean;
    zoomScale?: number;
+    printArea?: string;
    cells: Record<string, string>;
    mergedCells?: MergedCellRange[];
    hyperlinks?: Record<string, string>;
@@ -70,6 +71,7 @@ interface ParsedSheet {
  rowHeights?: Record<string, number>;
  showGridLines?: boolean;
  zoomScale?: number;
+  printArea?: string;
  cells: Record<string, string>;
  mergedCells?: MergedCellRange[];
  hyperlinks?: Record<string, string>;
@@ -210,12 +212,22 @@ export async function importXlsxFile(file: File): Promise<ImportedExcellWorkbook
  const themeColors = await readOptionalWorkbookThemeColors(zip, parser);
  const styleTable = xlsxStylesXmlToCellFormatTable(await readOptionalWorkbookStyles(zip, parser), themeColors);
  const sheetRefs = workbookSheetRefs(workbookXml);
+  const printAreas = workbookPrintAreas(workbookXml, sheetRefs);
  const relationshipTargets = workbookRelationshipTargets(relationshipsXml);
  const sheets = await Promise.all(
    sheetRefs.map(async (sheet, index) => {
      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<ImportedExcellWorkbook
      const sheetRelationshipsXml = await readOptionalSheetRelationships(zip, parser, sheetPath);
      const parsedSheet = parsedWorksheetToSheet(sheetXml, sheet, index, sharedStrings, sheetRelationshipsXml, styleTable, themeColors);
      const charts = await worksheetXmlToCharts(zip, parser, sheetXml, sheetRelationshipsXml, sheetPath, parsedSheet.name);
-      return { ...parsedSheet, charts };
+      return { ...parsedSheet, ...(printAreas[sheet.id] ? { printArea: printAreas[sheet.id] } : {}), charts };
    })
  );
  const activeSheet = workbookActiveSheetId(workbookXml, sheets);
@@ -253,7 +265,8 @@ export async function exportXlsxBlob(workbook: Workbook): Promise<Blob> {
    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<string, string> {
+  const workbook = childRecord(workbookXml, "workbook");
+  const definedNames = childRecord(workbook, "definedNames");
+
+  return toArray(definedNames.definedName).reduce<Record<string, string>>((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<string, string> = {};
@@ -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 = `<bookViews><workbookView activeTab="${activeTab}"/></bookViews>`;
  const sheetXml = sheets
@@ -963,12 +998,27 @@ function buildWorkbookXml(sheets: Array<{ name: string; visibility?: WorkbookShe
      return `<sheet name="${escapeXmlAttribute(sheet.name)}" sheetId="${index + 1}" r:id="rId${index + 1}"${visibility}/>`;
    })
    .join("");
+  const definedNames = buildWorkbookDefinedNamesXml(sheets);

  return xmlDeclaration(
-    `<workbook xmlns="http://schemas.openxmlformats.org/spreadsheetml/2006/main" xmlns:r="http://schemas.openxmlformats.org/officeDocument/2006/relationships">${bookViews}<sheets>${sheetXml}</sheets></workbook>`
+    `<workbook xmlns="http://schemas.openxmlformats.org/spreadsheetml/2006/main" xmlns:r="http://schemas.openxmlformats.org/officeDocument/2006/relationships">${bookViews}<sheets>${sheetXml}</sheets>${definedNames}</workbook>`
  );
 }

+function buildWorkbookDefinedNamesXml(sheets: Array<{ name: string; printArea?: string }>) {
+  const definedNames = sheets
+    .map((sheet, index) => {
+      const printArea = normalizePrintArea(sheet.printArea ?? "");
+      return printArea
+        ? `<definedName name="_xlnm.Print_Area" localSheetId="${index}">${escapeXmlText(printAreaFormula(sheet.name, printArea))}</definedName>`
+        : "";
+    })
+    .filter(Boolean)
+    .join("");
+
+  return definedNames ? `<definedNames>${definedNames}</definedNames>` : "";
+}
+
 function buildWorkbookRelationshipsXml(sheetCount: number) {
  const sheetRelationships = Array.from({ length: sheetCount }, (_, index) => {
    return `<Relationship Id="rId${index + 1}" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/worksheet" Target="worksheets/sheet${index + 1}.xml"/>`;
@@ -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);
 }
@@ -26,6 +26,7 @@ export interface Sheet {
  rowHeights?: Record<string, number>;
  showGridLines?: boolean;
  zoomScale?: number;
+  printArea?: string;
  cells: Record<string, string>;
  mergedCells?: MergedCellRange[];
  hyperlinks?: Record<string, string>;