diff --git a/README.md b/README.md index 2b74054..419799d 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`, автофильтр через `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 в текущем инкременте не заявлены. ## Сборка пакета diff --git a/src/io/excellOffice.test.ts b/src/io/excellOffice.test.ts index 56597b9..5d7846f 100644 --- a/src/io/excellOffice.test.ts +++ b/src/io/excellOffice.test.ts @@ -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(''); + 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(''); + expect(sheetXml.indexOf("")).toBeLessThan(sheetXml.indexOf("")); + expect(imported.sheets[0].tabColor).toBe("0F766E"); + }); + it("создает OOXML chart part для диаграммы XLSX", () => { const xml = buildChartXml( { diff --git a/src/io/excellOffice.ts b/src/io/excellOffice.ts index 3f6e4b4..b1c6a74 100644 --- a/src/io/excellOffice.ts +++ b/src/io/excellOffice.ts @@ -11,6 +11,7 @@ export interface ImportedExcellWorkbook { visibility?: "hidden" | "veryHidden"; frozenPane?: SheetFrozenPane; autoFilter?: string; + tabColor?: string; cells: Record; mergedCells?: MergedCellRange[]; hyperlinks?: Record; @@ -60,6 +61,7 @@ interface ParsedSheet { visibility?: "hidden" | "veryHidden"; frozenPane?: SheetFrozenPane; autoFilter?: string; + tabColor?: string; cells: Record; mergedCells?: MergedCellRange[]; hyperlinks?: Record; @@ -211,7 +213,7 @@ export async function importXlsxFile(file: File): Promise { 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 = [] + styleTable: Array = [], + 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, @@ -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>>((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 ? `` : ""; + const sheetPrXml = buildSheetPrXml(tabColor); const sheetViewsXml = buildSheetViewsXml(frozenPane); return xmlDeclaration( - `${sheetViewsXml}${rowXml}${autoFilterXml}${mergeCellsXml}${hyperlinksXml}${drawingXml}` + `${sheetPrXml}${sheetViewsXml}${rowXml}${autoFilterXml}${mergeCellsXml}${hyperlinksXml}${drawingXml}` ); } @@ -702,6 +716,11 @@ export function buildSheetViewsXml(frozenPane?: SheetFrozenPane) { return ``; } +export function buildSheetPrXml(tabColor?: string) { + const color = normalizeFillColor(tabColor); + return color ? `` : ""; +} + export function buildAutoFilterXml(autoFilter?: string) { const ref = normalizeCellRange(autoFilter ?? ""); return ref ? `` : ""; diff --git a/src/types.ts b/src/types.ts index 6df9dce..e16a825 100644 --- a/src/types.ts +++ b/src/types.ts @@ -21,6 +21,7 @@ export interface Sheet { visibility?: "hidden" | "veryHidden"; frozenPane?: SheetFrozenPane; autoFilter?: string; + tabColor?: string; cells: Record; mergedCells?: MergedCellRange[]; hyperlinks?: Record;