Preserve QExcell sheet tab colors in XLSX

2026-06-01 12:56:24 +03:00
parent 5ebc9639dc
commit 3d4e1d51ef
4 changed files with 74 additions and 7 deletions
@@ -32,7 +32,7 @@ npm run build
 ## Поддержка форматов

 - QWord открывает `.docx` и сохраняет `.docx`; при импорте базовых DOCX-абзацев читает выравнивание, переносы строк, табуляцию, внешние гиперссылки, простые таблицы, базовые растровые изображения, явные цвета текста, подсветку, размер и семейство шрифта из OOXML, а при экспорте DOCX сохраняются заголовки, абзацы, переносы строк, табуляция, выравнивание абзацев, списки, простые таблицы, внешние гиперссылки, базовые растровые изображения и базовое inline-форматирование текста: полужирный, курсив, подчеркивание, зачеркивание, цвет текста, подсветка, размер и семейство шрифта.
- QExcell открывает `.xlsx` и сохраняет `.xlsx`; сетка расширяется по фактически заполненным ячейкам, поддерживает несколько листов, скрытые и veryHidden листы через `sheet state`, закрепленные области через `sheetViews pane`, автофильтр через `autoFilter ref`, активный лист через `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`, автофильтр через `autoFilter ref`, цвет вкладки листа через `sheetPr tabColor`, активный лист через `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`, автофильтр через `autoFilter ref` и активный лист 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`, автофильтр через `autoFilter ref`, цвет вкладки листа через `sheetPr tabColor` и активный лист 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 в текущем инкременте не заявлены.

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

@@ -6,6 +6,7 @@ import {
  buildAutoFilterXml,
  buildHyperlinksXml,
  buildMergeCellsXml,
+  buildSheetPrXml,
  buildSheetViewsXml,
  createCellStyleRegistry,
  buildWorksheetRelationshipsXml,
@@ -23,6 +24,7 @@ import {
  worksheetXmlToFrozenPane,
  worksheetXmlToHyperlinks,
  worksheetXmlToMergedCells,
+  worksheetXmlToTabColor,
  xlsxStylesXmlToCellFormatTable,
  xlsxThemeXmlToColors,
  xlsxCellToText
@@ -681,6 +683,51 @@ describe("excellOffice OOXML helpers", () => {
    expect(imported.sheets[0].autoFilter).toBe("A1:D20");
  });

+  it("читает и записывает цвет вкладки листа XLSX через sheetPr tabColor", async () => {
+    expect(
+      worksheetXmlToTabColor({
+        worksheet: {
+          sheetPr: { tabColor: { rgb: "FF0F766E" } }
+        }
+      })
+    ).toBe("0F766E");
+    expect(
+      worksheetXmlToTabColor(
+        {
+          worksheet: {
+            sheetPr: { tabColor: { theme: "4" } }
+          }
+        },
+        ["000000", "FFFFFF", "1F497D", "EEECE1", "123456"]
+      )
+    ).toBe("123456");
+    expect(buildSheetPrXml("#0f766e")).toBe('<sheetPr><tabColor rgb="FF0F766E"/></sheetPr>');
+    expect(buildSheetPrXml("bad")).toBe("");
+
+    const blob = await exportXlsxBlob({
+      id: "book-1",
+      title: "Tab color.xlsx",
+      updatedAt: "2026-06-01T00:00:00.000Z",
+      activeSheet: "sheet-1",
+      sheets: [
+        {
+          id: "sheet-1",
+          name: "Color",
+          tabColor: "#0f766e",
+          frozenPane: { rows: 1 },
+          cells: { A1: "Header" }
+        }
+      ]
+    });
+    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], "Tab color.xlsx", { type: blob.type }));
+
+    expect(sheetXml).toContain('<sheetPr><tabColor rgb="FF0F766E"/></sheetPr>');
+    expect(sheetXml.indexOf("<sheetPr>")).toBeLessThan(sheetXml.indexOf("<sheetViews>"));
+    expect(imported.sheets[0].tabColor).toBe("0F766E");
+  });
+
  it("создает OOXML chart part для диаграммы XLSX", () => {
    const xml = buildChartXml(
      {
@@ -11,6 +11,7 @@ export interface ImportedExcellWorkbook {
    visibility?: "hidden" | "veryHidden";
    frozenPane?: SheetFrozenPane;
    autoFilter?: string;
+    tabColor?: string;
    cells: Record<string, string>;
    mergedCells?: MergedCellRange[];
    hyperlinks?: Record<string, string>;
@@ -60,6 +61,7 @@ interface ParsedSheet {
  visibility?: "hidden" | "veryHidden";
  frozenPane?: SheetFrozenPane;
  autoFilter?: string;
+  tabColor?: string;
  cells: Record<string, string>;
  mergedCells?: MergedCellRange[];
  hyperlinks?: Record<string, string>;
@@ -211,7 +213,7 @@ export async function importXlsxFile(file: File): Promise<ImportedExcellWorkbook
      const sheetPath = resolveWorkbookTarget(target);
      const sheetXml = parser.parse(await readZipText(zip, sheetPath));
      const sheetRelationshipsXml = await readOptionalSheetRelationships(zip, parser, sheetPath);
-      const parsedSheet = parsedWorksheetToSheet(sheetXml, sheet, index, sharedStrings, sheetRelationshipsXml, styleTable);
+      const parsedSheet = parsedWorksheetToSheet(sheetXml, sheet, index, sharedStrings, sheetRelationshipsXml, styleTable, themeColors);
      const charts = await worksheetXmlToCharts(zip, parser, sheetXml, sheetRelationshipsXml, sheetPath, parsedSheet.name);
      return { ...parsedSheet, charts };
    })
@@ -264,7 +266,8 @@ export async function exportXlsxBlob(workbook: Workbook): Promise<Blob> {
        styleRegistry,
        drawingRelationshipId,
        sheet.frozenPane,
-        sheet.autoFilter
+        sheet.autoFilter,
+        sheet.tabColor
      )
    );
    const relationshipsXml = buildWorksheetRelationshipsXml(
@@ -294,10 +297,12 @@ export function parsedWorksheetToSheet(
  index: number,
  sharedStrings: string[],
  relationshipsXml?: unknown,
-  styleTable: Array<CellFormat | undefined> = []
+  styleTable: Array<CellFormat | undefined> = [],
+  themeColors: string[] = defaultXlsxThemeColors
 ): ParsedSheet {
  const frozenPane = worksheetXmlToFrozenPane(worksheetXml);
  const autoFilter = worksheetXmlToAutoFilter(worksheetXml);
+  const tabColor = worksheetXmlToTabColor(worksheetXml, themeColors);

  return {
    id: sheet.id || `sheet-${index + 1}`,
@@ -305,6 +310,7 @@ export function parsedWorksheetToSheet(
    ...(sheet.visibility ? { visibility: sheet.visibility } : {}),
    ...(frozenPane ? { frozenPane } : {}),
    ...(autoFilter ? { autoFilter } : {}),
+    ...(tabColor ? { tabColor } : {}),
    cells: worksheetXmlToCells(worksheetXml, sharedStrings),
    mergedCells: worksheetXmlToMergedCells(worksheetXml),
    hyperlinks: worksheetXmlToHyperlinks(worksheetXml, relationshipsXml),
@@ -429,6 +435,12 @@ export function worksheetXmlToAutoFilter(worksheetXml: unknown) {
  return normalizeCellRange(String(autoFilter.ref ?? ""));
 }

+export function worksheetXmlToTabColor(worksheetXml: unknown, themeColors: string[] = defaultXlsxThemeColors) {
+  const worksheet = childRecord(worksheetXml, "worksheet");
+  const sheetPr = childRecord(worksheet, "sheetPr");
+  return colorRecordToHex(childRecord(sheetPr, "tabColor"), themeColors);
+}
+
 async function worksheetXmlToCharts(
  zip: ZipInstance,
  parser: InstanceType<XmlParserConstructor>,
@@ -601,7 +613,8 @@ export function buildWorksheetXml(
  styleRegistry = createCellStyleRegistry([cellFormats]),
  drawingRelationshipId = "",
  frozenPane?: SheetFrozenPane,
-  autoFilter?: string
+  autoFilter?: string,
+  tabColor?: string
 ) {
  const rows = sortedWorksheetEntries(cells, cellFormats).reduce<Record<number, Array<[string, string]>>>((grouped, entry) => {
    const rowNumber = cellRowNumber(entry[0]);
@@ -623,10 +636,11 @@ export function buildWorksheetXml(
  const autoFilterXml = buildAutoFilterXml(autoFilter);
  const hyperlinksXml = buildHyperlinksXml(hyperlinks);
  const drawingXml = drawingRelationshipId ? `<drawing r:id="${escapeXmlAttribute(drawingRelationshipId)}"/>` : "";
+  const sheetPrXml = buildSheetPrXml(tabColor);
  const sheetViewsXml = buildSheetViewsXml(frozenPane);

  return xmlDeclaration(
-    `<worksheet xmlns="http://schemas.openxmlformats.org/spreadsheetml/2006/main" xmlns:r="http://schemas.openxmlformats.org/officeDocument/2006/relationships">${sheetViewsXml}<sheetData>${rowXml}</sheetData>${autoFilterXml}${mergeCellsXml}${hyperlinksXml}${drawingXml}</worksheet>`
+    `<worksheet xmlns="http://schemas.openxmlformats.org/spreadsheetml/2006/main" xmlns:r="http://schemas.openxmlformats.org/officeDocument/2006/relationships">${sheetPrXml}${sheetViewsXml}<sheetData>${rowXml}</sheetData>${autoFilterXml}${mergeCellsXml}${hyperlinksXml}${drawingXml}</worksheet>`
  );
 }

@@ -702,6 +716,11 @@ export function buildSheetViewsXml(frozenPane?: SheetFrozenPane) {
  return `<sheetViews><sheetView workbookViewId="0"><pane ${attributes}/></sheetView></sheetViews>`;
 }

+export function buildSheetPrXml(tabColor?: string) {
+  const color = normalizeFillColor(tabColor);
+  return color ? `<sheetPr><tabColor rgb="FF${color}"/></sheetPr>` : "";
+}
+
 export function buildAutoFilterXml(autoFilter?: string) {
  const ref = normalizeCellRange(autoFilter ?? "");
  return ref ? `<autoFilter ref="${escapeXmlAttribute(ref)}"/>` : "";
@@ -21,6 +21,7 @@ export interface Sheet {
  visibility?: "hidden" | "veryHidden";
  frozenPane?: SheetFrozenPane;
  autoFilter?: string;
+  tabColor?: string;
  cells: Record<string, string>;
  mergedCells?: MergedCellRange[];
  hyperlinks?: Record<string, string>;