Read QExcell workbook theme colors
This commit is contained in:
Курнат Андрей
@@ -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 в текущем инкременте не заявлены.
|
||||
|
||||
## Сборка пакета
|
||||
|
||||
|
||||
@@ -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 = `<a:theme xmlns:a="http://schemas.openxmlformats.org/drawingml/2006/main"><a:themeElements><a:clrScheme name="Custom"><a:dk1><a:srgbClr val="000000"/></a:dk1><a:lt1><a:srgbClr val="FFFFFF"/></a:lt1><a:dk2><a:srgbClr val="222222"/></a:dk2><a:lt2><a:srgbClr val="EEEEEE"/></a:lt2><a:accent1><a:srgbClr val="123456"/></a:accent1></a:clrScheme></a:themeElements></a:theme>`;
|
||||
const zip = new JSZip();
|
||||
zip.file("xl/workbook.xml", `<workbook><sheets><sheet name="Theme" sheetId="1" r:id="rId1"/></sheets></workbook>`);
|
||||
zip.file(
|
||||
"xl/_rels/workbook.xml.rels",
|
||||
`<Relationships><Relationship Id="rId1" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/worksheet" Target="worksheets/sheet1.xml"/><Relationship Id="rId2" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/styles" Target="styles.xml"/><Relationship Id="rId3" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/theme" Target="theme/theme1.xml"/></Relationships>`
|
||||
);
|
||||
zip.file("xl/theme/theme1.xml", themeXml);
|
||||
zip.file(
|
||||
"xl/styles.xml",
|
||||
`<styleSheet><fonts count="2"><font/><font><color theme="4"/><name val="Calibri"/></font></fonts><fills count="1"><fill><patternFill patternType="none"/></fill></fills><borders count="1"><border><left/><right/><top/><bottom/><diagonal/></border></borders><cellXfs count="2"><xf numFmtId="0" fontId="0" fillId="0" borderId="0"/><xf numFmtId="0" fontId="1" fillId="0" borderId="0"/></cellXfs></styleSheet>`
|
||||
);
|
||||
zip.file(
|
||||
"xl/worksheets/sheet1.xml",
|
||||
`<worksheet><sheetData><row r="1"><c r="A1" s="1" t="inlineStr"><is><t>Themed</t></is></c></row></sheetData></worksheet>`
|
||||
);
|
||||
|
||||
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(
|
||||
{
|
||||
|
||||
+51
-15
@@ -182,7 +182,8 @@ export async function importXlsxFile(file: File): Promise<ImportedExcellWorkbook
|
||||
const workbookXml = parser.parse(await readZipText(zip, "xl/workbook.xml"));
|
||||
const relationshipsXml = parser.parse(await readZipText(zip, "xl/_rels/workbook.xml.rels"));
|
||||
const sharedStrings = await readSharedStrings(zip, parser);
|
||||
const styleTable = xlsxStylesXmlToCellFormatTable(await readOptionalWorkbookStyles(zip, parser));
|
||||
const themeColors = await readOptionalWorkbookThemeColors(zip, parser);
|
||||
const styleTable = xlsxStylesXmlToCellFormatTable(await readOptionalWorkbookStyles(zip, parser), themeColors);
|
||||
const sheetRefs = workbookSheetRefs(workbookXml);
|
||||
const relationshipTargets = workbookRelationshipTargets(relationshipsXml);
|
||||
const sheets = await Promise.all(
|
||||
@@ -901,12 +902,15 @@ export function createCellStyleRegistry(cellFormatsBySheet: Array<Record<string,
|
||||
return { formats, idsByKey };
|
||||
}
|
||||
|
||||
export function xlsxStylesXmlToCellFormatTable(stylesXml?: unknown): Array<CellFormat | undefined> {
|
||||
export function xlsxStylesXmlToCellFormatTable(
|
||||
stylesXml?: unknown,
|
||||
themeColors: string[] = defaultXlsxThemeColors
|
||||
): Array<CellFormat | undefined> {
|
||||
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<XmlParserConstructor>) {
|
||||
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<XmlParserConstructor>, sheetPath: string) {
|
||||
const relationshipsPath = sheetRelationshipsPath(sheetPath);
|
||||
const file = zip.file(relationshipsPath);
|
||||
|
||||
Reference in New Issue
Block a user