diff --git a/README.md b/README.md index abbff0a..ea6e676 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, внешние и внутренние гиперссылки ячеек, базовые диаграммы листа и базовое форматирование ячеек: полужирный, курсив, подчеркивание, зачеркивание, размер и семейство шрифта, цвет текста, заливку, горизонтальное и вертикальное выравнивание, перенос текста, границы и цвет границ ячеек, числовые форматы XLSX для дат, процентов, денежных и дробных значений. +- QExcell открывает `.xlsx` и сохраняет `.xlsx`; сетка расширяется по фактически заполненным ячейкам, поддерживает несколько листов, формулы за пределами стартового диапазона A-H, shared formulas XLSX с относительными ссылками, базовые merged cells, внешние и внутренние гиперссылки ячеек, базовые диаграммы листа и базовое форматирование ячеек: полужирный, курсив, подчеркивание, зачеркивание, размер и семейство шрифта, прямые RGB/theme/indexed цвета текста, заливку, горизонтальное и вертикальное выравнивание, перенос текста, границы и цвет границ ячеек, числовые форматы 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, базовые стили, цвета текста, размеры и семейства шрифта, зачеркивание ячеек, горизонтальное и вертикальное выравнивание, перенос текста, границы и цвет границ ячеек, числовые форматы и простые 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, размеры и семейства шрифта, зачеркивание ячеек, горизонтальное и вертикальное выравнивание, перенос текста, границы и цвет границ ячеек, числовые форматы и простые 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 d7aaa0c..f9393b2 100644 --- a/src/io/excellOffice.test.ts +++ b/src/io/excellOffice.test.ts @@ -342,6 +342,38 @@ describe("excellOffice OOXML helpers", () => { }); }); + it("читает theme, tint и indexed цвета XLSX из styles.xml", () => { + const styleTable = xlsxStylesXmlToCellFormatTable({ + styleSheet: { + fonts: { + font: [{ color: { theme: "1" } }, { color: { theme: "4", tint: "0.5" } }, { color: { indexed: "22" } }] + }, + fills: { + fill: [{}, {}, { patternFill: { fgColor: { theme: "6" } } }] + }, + borders: { + border: [{}, { left: { style: "thin", color: { indexed: "4" } } }] + }, + cellXfs: { + xf: [ + { fontId: "0", fillId: "0", borderId: "0" }, + { fontId: "1", fillId: "2", borderId: "1" }, + { fontId: "2", fillId: "0", borderId: "0" } + ] + } + } + }); + + expect(styleTable[0]).toBeUndefined(); + expect(styleTable[1]).toEqual({ + textColor: "A7C0DE", + fillColor: "9BBB59", + border: true, + borderColor: "0000FF" + }); + expect(styleTable[2]).toEqual({ textColor: "C0C0C0" }); + }); + it("преобразует XML листа в модель QExcell", () => { const cells = worksheetXmlToCells( { diff --git a/src/io/excellOffice.ts b/src/io/excellOffice.ts index 4ef5a18..e20d718 100644 --- a/src/io/excellOffice.ts +++ b/src/io/excellOffice.ts @@ -105,6 +105,41 @@ const hyperlinkRelationshipType = "http://schemas.openxmlformats.org/officeDocum const drawingRelationshipType = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/drawing"; const chartRelationshipType = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/chart"; const customNumberFormatStartId = 164; +const defaultXlsxThemeColors = [ + "000000", + "FFFFFF", + "1F497D", + "EEECE1", + "4F81BD", + "C0504D", + "9BBB59", + "8064A2", + "4BACC6", + "F79646", + "0000FF", + "800080" +]; +const indexedXlsxColors: Record = { + 0: "000000", + 1: "FFFFFF", + 2: "FF0000", + 3: "00FF00", + 4: "0000FF", + 5: "FFFF00", + 6: "FF00FF", + 7: "00FFFF", + 8: "000000", + 9: "FFFFFF", + 10: "FF0000", + 11: "00FF00", + 12: "0000FF", + 13: "FFFF00", + 14: "FF00FF", + 15: "00FFFF", + 22: "C0C0C0", + 23: "808080", + 64: "" +}; const builtinNumberFormats: Record = { 1: "0", 2: "0.00", @@ -869,7 +904,7 @@ export function createCellStyleRegistry(cellFormatsBySheet: Array { const styleSheet = childRecord(stylesXml, "styleSheet"); const numberFormats = xlsxNumberFormats(styleSheet); - const fonts = toArray(childRecord(styleSheet, "fonts").font).map(fontXmlToCellFormat); + 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); @@ -1034,9 +1069,9 @@ function normalizedCellFormat(format: CellFormat | undefined): CellFormat | null return Object.keys(normalized).length > 0 ? normalized : null; } -function fontXmlToCellFormat(font: unknown): CellFormat { +function fontXmlToCellFormat(font: unknown, index = 0): CellFormat { const record = asRecord(font); - const textColor = normalizeFillColor(String(childRecord(record, "color").rgb || "")); + const textColor = colorRecordToHex(childRecord(record, "color"), { ignoreThemeAndIndexed: index === 0 }); const fontSize = normalizedFontSize(numberAttribute(childRecord(record, "sz").val)); const fontFamily = normalizedFontFamily(String(childRecord(record, "name").val || "")); return ( @@ -1054,7 +1089,7 @@ function fontXmlToCellFormat(font: unknown): CellFormat { function fillXmlToCellFormat(fill: unknown): CellFormat { const patternFill = childRecord(fill, "patternFill"); - const fillColor = normalizeFillColor(String(childRecord(patternFill, "fgColor").rgb || "")); + const fillColor = colorRecordToHex(childRecord(patternFill, "fgColor")); return fillColor ? { fillColor } : {}; } @@ -1066,7 +1101,7 @@ function borderXmlToCellFormat(border: unknown): CellFormat { }); const borderColor = borderedSides - .map((side) => normalizeFillColor(String(childRecord(childRecord(record, side), "color").rgb || ""))) + .map((side) => colorRecordToHex(childRecord(childRecord(record, side), "color"))) .find(Boolean); return normalizedCellFormat({ @@ -1081,7 +1116,7 @@ function baseFontXml() { function formatFontXml(format: CellFormat) { const flags = `${format.bold ? "" : ""}${format.italics ? "" : ""}${format.underline ? "" : ""}${format.strike ? "" : ""}`; - const color = format.textColor ? `` : ''; + const color = format.textColor ? `` : ""; return `${flags}${color}`; } @@ -1107,6 +1142,45 @@ function normalizeFillColor(value?: string) { return /^[0-9A-F]{6}$/.test(raw) ? raw : ""; } +function colorRecordToHex(record: XmlRecord, options: { ignoreThemeAndIndexed?: boolean } = {}) { + const rgbColor = normalizeFillColor(String(record.rgb ?? "")); + if (rgbColor) { + return rgbColor; + } + + if (options.ignoreThemeAndIndexed) { + return ""; + } + + if (record.theme !== undefined) { + const themeColor = themeColorToHex(numberAttribute(record.theme), Number.parseFloat(String(record.tint ?? ""))); + if (themeColor) { + return themeColor; + } + } + + return record.indexed !== undefined ? indexedXlsxColors[numberAttribute(record.indexed)] ?? "" : ""; +} + +function themeColorToHex(themeIndex: number, tint = 0) { + const baseColor = defaultXlsxThemeColors[themeIndex]; + if (!baseColor) { + return ""; + } + + return Number.isFinite(tint) && tint !== 0 ? applyXlsxTint(baseColor, tint) : baseColor; +} + +function applyXlsxTint(hexColor: string, tint: number) { + const channels = [0, 2, 4].map((offset) => Number.parseInt(hexColor.slice(offset, offset + 2), 16)); + const tinted = channels.map((channel) => { + const value = tint < 0 ? channel * (1 + tint) : channel * (1 - tint) + 255 * tint; + return Math.min(255, Math.max(0, Math.round(value))).toString(16).padStart(2, "0").toUpperCase(); + }); + + return tinted.join(""); +} + function normalizedFontSize(value?: number) { if (!Number.isFinite(value) || !value || value <= 0) { return undefined;