diff --git a/README.md b/README.md index ea6e676..d7d6ca2 100644 --- a/README.md +++ b/README.md @@ -32,7 +32,7 @@ npm run build ## Поддержка форматов - QWord открывает `.docx` и сохраняет `.docx`; при импорте базовых DOCX-абзацев читает выравнивание, внешние гиперссылки, простые таблицы, базовые растровые изображения, явные цвета текста, подсветку, размер и семейство шрифта из OOXML, а при экспорте DOCX сохраняются заголовки, абзацы, выравнивание абзацев, списки, простые таблицы, внешние гиперссылки, базовые растровые изображения и базовое inline-форматирование текста: полужирный, курсив, подчеркивание, зачеркивание, цвет текста, подсветка, размер и семейство шрифта. -- QExcell открывает `.xlsx` и сохраняет `.xlsx`; сетка расширяется по фактически заполненным ячейкам, поддерживает несколько листов, формулы за пределами стартового диапазона A-H, shared formulas XLSX с относительными ссылками, базовые merged cells, внешние и внутренние гиперссылки ячеек, базовые диаграммы листа и базовое форматирование ячеек: полужирный, курсив, подчеркивание, зачеркивание, размер и семейство шрифта, прямые RGB/theme/indexed цвета текста, заливку, горизонтальное и вертикальное выравнивание, перенос текста, границы и цвет границ ячеек, числовые форматы XLSX для дат, процентов, денежных и дробных значений. +- QExcell открывает `.xlsx` и сохраняет `.xlsx`; сетка расширяется по фактически заполненным ячейкам, поддерживает несколько листов, формулы за пределами стартового диапазона A-H, shared formulas XLSX с относительными ссылками, базовые merged cells, внешние и внутренние гиперссылки ячеек, базовые диаграммы листа и базовое форматирование ячеек: полужирный, курсив, подчеркивание, зачеркивание, размер и семейство шрифта, прямые RGB/theme/indexed цвета текста с учетом `xl/theme/theme1.xml`, заливку, горизонтальное и вертикальное выравнивание, перенос текста, границы и цвет границ ячеек, числовые форматы XLSX для дат, процентов, денежных и дробных значений. - QPowerPoint открывает `.pptx` и сохраняет `.pptx`; импорт учитывает порядок слайдов из `presentation.xml`, переносы абзацев внутри текстовых блоков и заметки докладчика через 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:color`, `w:shd`, `w:highlight`, `w:sz`, `w:rFonts` и `w:strike` для цвета/подсветки/размера/семейства/зачеркивания текста DOCX, выравнивание абзацев DOCX, внешние гиперссылки DOCX, внешние и внутренние гиперссылки XLSX, базовые растровые изображения DOCX/PPTX, простые таблицы, несколько листов XLSX, ячейки, формулы, shared formulas XLSX с относительными ссылками, базовые merged cells, базовые стили, RGB/theme/indexed цвета XLSX, размеры и семейства шрифта, зачеркивание ячеек, горизонтальное и вертикальное выравнивание, перенос текста, границы и цвет границ ячеек, числовые форматы и простые bar/line/pie диаграммы ячеек XLSX, текстовые слайды PPTX с переносами абзацев при импорте, пользовательский фон слайдов 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:color`, `w:shd`, `w:highlight`, `w:sz`, `w:rFonts` и `w:strike` для цвета/подсветки/размера/семейства/зачеркивания текста DOCX, выравнивание абзацев DOCX, внешние гиперссылки DOCX, внешние и внутренние гиперссылки XLSX, базовые растровые изображения DOCX/PPTX, простые таблицы, несколько листов XLSX, ячейки, формулы, shared formulas XLSX с относительными ссылками, базовые merged cells, базовые стили, RGB/theme/indexed цвета XLSX с учетом `xl/theme/theme1.xml`, размеры и семейства шрифта, зачеркивание ячеек, горизонтальное и вертикальное выравнивание, перенос текста, границы и цвет границ ячеек, числовые форматы и простые bar/line/pie диаграммы ячеек XLSX, текстовые слайды PPTX с переносами абзацев при импорте, пользовательский фон слайдов 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 f9393b2..74b8967 100644 --- a/src/io/excellOffice.test.ts +++ b/src/io/excellOffice.test.ts @@ -19,6 +19,7 @@ import { worksheetXmlToHyperlinks, worksheetXmlToMergedCells, xlsxStylesXmlToCellFormatTable, + xlsxThemeXmlToColors, xlsxCellToText } from "./excellOffice"; @@ -374,6 +375,39 @@ describe("excellOffice OOXML helpers", () => { expect(styleTable[2]).toEqual({ textColor: "C0C0C0" }); }); + it("использует цвета из xl/theme/theme1.xml при импорте XLSX", async () => { + const themeXml = ``; + const zip = new JSZip(); + zip.file("xl/workbook.xml", ``); + zip.file( + "xl/_rels/workbook.xml.rels", + `` + ); + zip.file("xl/theme/theme1.xml", themeXml); + zip.file( + "xl/styles.xml", + `` + ); + zip.file( + "xl/worksheets/sheet1.xml", + `Themed` + ); + + expect(xlsxThemeXmlToColors({ "a:theme": { "a:themeElements": { "a:clrScheme": { "a:accent1": { "a:srgbClr": { val: "123456" } } } } } })[4]).toBe( + "123456" + ); + + const blob = await zip.generateAsync({ + type: "blob", + mimeType: "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet" + }); + const imported = await importXlsxFile(new File([blob], "Theme.xlsx", { type: blob.type })); + + expect(imported.sheets[0].cellFormats).toEqual({ + A1: { textColor: "123456" } + }); + }); + it("преобразует XML листа в модель QExcell", () => { const cells = worksheetXmlToCells( { diff --git a/src/io/excellOffice.ts b/src/io/excellOffice.ts index e20d718..ed17586 100644 --- a/src/io/excellOffice.ts +++ b/src/io/excellOffice.ts @@ -182,7 +182,8 @@ export async function importXlsxFile(file: File): Promise { +export function xlsxStylesXmlToCellFormatTable( + stylesXml?: unknown, + themeColors: string[] = defaultXlsxThemeColors +): Array { const styleSheet = childRecord(stylesXml, "styleSheet"); const numberFormats = xlsxNumberFormats(styleSheet); - const fonts = toArray(childRecord(styleSheet, "fonts").font).map((font, index) => fontXmlToCellFormat(font, index)); - const fills = toArray(childRecord(styleSheet, "fills").fill).map(fillXmlToCellFormat); - const borders = toArray(childRecord(styleSheet, "borders").border).map(borderXmlToCellFormat); + const fonts = toArray(childRecord(styleSheet, "fonts").font).map((font, index) => fontXmlToCellFormat(font, index, themeColors)); + const fills = toArray(childRecord(styleSheet, "fills").fill).map((fill) => fillXmlToCellFormat(fill, themeColors)); + const borders = toArray(childRecord(styleSheet, "borders").border).map((border) => borderXmlToCellFormat(border, themeColors)); return toArray(childRecord(styleSheet, "cellXfs").xf).map((xf) => { const record = asRecord(xf); @@ -1069,9 +1073,9 @@ function normalizedCellFormat(format: CellFormat | undefined): CellFormat | null return Object.keys(normalized).length > 0 ? normalized : null; } -function fontXmlToCellFormat(font: unknown, index = 0): CellFormat { +function fontXmlToCellFormat(font: unknown, index = 0, themeColors: string[] = defaultXlsxThemeColors): CellFormat { const record = asRecord(font); - const textColor = colorRecordToHex(childRecord(record, "color"), { ignoreThemeAndIndexed: index === 0 }); + const textColor = colorRecordToHex(childRecord(record, "color"), themeColors, { ignoreThemeAndIndexed: index === 0 }); const fontSize = normalizedFontSize(numberAttribute(childRecord(record, "sz").val)); const fontFamily = normalizedFontFamily(String(childRecord(record, "name").val || "")); return ( @@ -1087,13 +1091,13 @@ function fontXmlToCellFormat(font: unknown, index = 0): CellFormat { ); } -function fillXmlToCellFormat(fill: unknown): CellFormat { +function fillXmlToCellFormat(fill: unknown, themeColors: string[] = defaultXlsxThemeColors): CellFormat { const patternFill = childRecord(fill, "patternFill"); - const fillColor = colorRecordToHex(childRecord(patternFill, "fgColor")); + const fillColor = colorRecordToHex(childRecord(patternFill, "fgColor"), themeColors); return fillColor ? { fillColor } : {}; } -function borderXmlToCellFormat(border: unknown): CellFormat { +function borderXmlToCellFormat(border: unknown, themeColors: string[] = defaultXlsxThemeColors): CellFormat { const record = asRecord(border); const borderedSides = ["left", "right", "top", "bottom"].filter((side) => { const style = String(childRecord(record, side).style || childRecord(record, side)["@_style"] || "").trim().toLowerCase(); @@ -1101,7 +1105,7 @@ function borderXmlToCellFormat(border: unknown): CellFormat { }); const borderColor = borderedSides - .map((side) => colorRecordToHex(childRecord(childRecord(record, side), "color"))) + .map((side) => colorRecordToHex(childRecord(childRecord(record, side), "color"), themeColors)) .find(Boolean); return normalizedCellFormat({ @@ -1142,7 +1146,11 @@ function normalizeFillColor(value?: string) { return /^[0-9A-F]{6}$/.test(raw) ? raw : ""; } -function colorRecordToHex(record: XmlRecord, options: { ignoreThemeAndIndexed?: boolean } = {}) { +function colorRecordToHex( + record: XmlRecord, + themeColors: string[] = defaultXlsxThemeColors, + options: { ignoreThemeAndIndexed?: boolean } = {} +) { const rgbColor = normalizeFillColor(String(record.rgb ?? "")); if (rgbColor) { return rgbColor; @@ -1153,7 +1161,7 @@ function colorRecordToHex(record: XmlRecord, options: { ignoreThemeAndIndexed?: } if (record.theme !== undefined) { - const themeColor = themeColorToHex(numberAttribute(record.theme), Number.parseFloat(String(record.tint ?? ""))); + const themeColor = themeColorToHex(numberAttribute(record.theme), Number.parseFloat(String(record.tint ?? "")), themeColors); if (themeColor) { return themeColor; } @@ -1162,8 +1170,8 @@ function colorRecordToHex(record: XmlRecord, options: { ignoreThemeAndIndexed?: return record.indexed !== undefined ? indexedXlsxColors[numberAttribute(record.indexed)] ?? "" : ""; } -function themeColorToHex(themeIndex: number, tint = 0) { - const baseColor = defaultXlsxThemeColors[themeIndex]; +function themeColorToHex(themeIndex: number, tint = 0, themeColors: string[] = defaultXlsxThemeColors) { + const baseColor = themeColors[themeIndex] || defaultXlsxThemeColors[themeIndex]; if (!baseColor) { return ""; } @@ -1267,6 +1275,34 @@ async function readOptionalWorkbookStyles(zip: ZipInstance, parser: InstanceType return stylesFile ? parser.parse(await stylesFile.async("string")) : undefined; } +async function readOptionalWorkbookThemeColors(zip: ZipInstance, parser: InstanceType) { + const themeFile = zip.file("xl/theme/theme1.xml"); + if (!themeFile) { + return defaultXlsxThemeColors; + } + + return xlsxThemeXmlToColors(parser.parse(await themeFile.async("string"))); +} + +export function xlsxThemeXmlToColors(themeXml?: unknown) { + const colorScheme = firstRecordByLocalName(themeXml, "clrScheme"); + const slots = ["dk1", "lt1", "dk2", "lt2", "accent1", "accent2", "accent3", "accent4", "accent5", "accent6", "hlink", "folHlink"]; + const colors = slots.map((slot, index) => themeSlotColor(directChildByLocalName(colorScheme, slot)) || defaultXlsxThemeColors[index]); + + return colors.some(Boolean) ? colors : defaultXlsxThemeColors; +} + +function themeSlotColor(slot: XmlRecord) { + const srgbColor = firstRecordByLocalName(slot, "srgbClr"); + const systemColor = firstRecordByLocalName(slot, "sysClr"); + return normalizeFillColor(String(srgbColor.val || systemColor.lastClr || "")); +} + +function directChildByLocalName(record: XmlRecord, localName: string) { + const entry = Object.entries(record).find(([key]) => key.split(":").pop() === localName); + return entry ? asRecord(toArray(entry[1])[0]) : {}; +} + async function readOptionalSheetRelationships(zip: ZipInstance, parser: InstanceType, sheetPath: string) { const relationshipsPath = sheetRelationshipsPath(sheetPath); const file = zip.file(relationshipsPath);