Preserve QPowerPoint slide backgrounds

This commit is contained in:
Курнат Андрей
2026-06-01 06:43:17 +03:00
parent 24206eb8bb
commit 4377e5279e
8 changed files with 119 additions and 5 deletions
+2 -2
View File
@@ -33,7 +33,7 @@ npm run build
- QWord открывает `.docx` и сохраняет `.docx`; при импорте базовых DOCX-абзацев читает выравнивание, явные цвета текста и подсветку из OOXML, а при экспорте DOCX сохраняются заголовки, абзацы, выравнивание абзацев, списки, простые таблицы, внешние гиперссылки, базовые растровые изображения и базовое inline-форматирование текста: полужирный, курсив, подчеркивание, цвет текста и подсветка.
- QExcell открывает `.xlsx` и сохраняет `.xlsx`; сетка расширяется по фактически заполненным ячейкам, поддерживает несколько листов, формулы за пределами стартового диапазона A-H, базовые merged cells, внешние гиперссылки ячеек, базовые диаграммы листа и базовое форматирование ячеек: полужирный, курсив, подчеркивание, цвет текста, заливку, горизонтальное выравнивание и числовые форматы XLSX для дат, процентов, денежных и дробных значений.
- QPowerPoint открывает `.pptx` и сохраняет `.pptx`; импорт учитывает порядок слайдов из `presentation.xml`, читает заметки докладчика через relationships слайда и сохраняет базовые растровые изображения слайдов.
- QPowerPoint открывает `.pptx` и сохраняет `.pptx`; импорт учитывает порядок слайдов из `presentation.xml`, читает заметки докладчика через relationships слайда, сохраняет базовые растровые изображения слайдов и пользовательский цвет фона слайда.
- QOutlook открывает `.eml` и одиночные сообщения Outlook `.msg`, сохраняет письма в `.eml`; импорт EML поддерживает простые текстовые письма, `multipart/alternative`, `multipart/mixed`, `text/plain`, fallback из `text/html` в читаемый текст, base64, quoted-printable и MIME-вложения. Импорт MSG читает тему, отправителя, получателей, текст/HTML body и вложения, если эти поля доступны в MSG-файле. Новые письма можно сохранять в EML вместе с добавленными файлами. `.pst` и экспорт в `.msg` пока не реализованы.
В desktop-режиме Electron используются системные диалоги открытия и сохранения файлов. В web-режиме остаются браузерный выбор файла и скачивание результата.
@@ -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` для цвета/подсветки текста DOCX, выравнивание абзацев DOCX, внешние гиперссылки DOCX/XLSX, базовые растровые изображения DOCX/PPTX, простые таблицы, несколько листов XLSX, ячейки, формулы, базовые merged cells, базовые стили, цвета текста ячеек, горизонтальное выравнивание ячеек, числовые форматы и простые bar/line/pie диаграммы ячеек XLSX, текстовые слайды PPTX, заметки докладчика, MIME-вложения EML и базовые поля одиночных MSG-писем. Сложные стили, макросы, сложные диаграммы, сложное позиционирование и обтекание изображений, PST, экспорт MSG и полная fidelity документов Microsoft Office в текущем инкременте не заявлены.
Импорт и экспорт реализуют базовую совместимость с Office Open XML, EML и чтением MSG: текст, базовое inline-форматирование, явные `w:color`, `w:shd` и `w:highlight` для цвета/подсветки текста DOCX, выравнивание абзацев DOCX, внешние гиперссылки DOCX/XLSX, базовые растровые изображения DOCX/PPTX, простые таблицы, несколько листов XLSX, ячейки, формулы, базовые merged cells, базовые стили, цвета текста ячеек, горизонтальное выравнивание ячеек, числовые форматы и простые bar/line/pie диаграммы ячеек XLSX, текстовые слайды PPTX, пользовательский фон слайдов PPTX, заметки докладчика, MIME-вложения EML и базовые поля одиночных MSG-писем. Сложные стили, макросы, сложные диаграммы, сложное позиционирование и обтекание изображений, PST, экспорт MSG и полная fidelity документов Microsoft Office в текущем инкременте не заявлены.
## Сборка пакета
+15
View File
@@ -13,6 +13,7 @@ const STORAGE_KEY = "qoffice-state-v1";
function migrateQOfficeState(state: QOfficeState): QOfficeState {
const launchChecklistAttachments = initialState.mail.messages.find((message) => message.id === "mail-1")?.attachments;
const sampleSheet = initialState.workbook.sheets.find((sheet) => sheet.id === "sheet-1");
const sampleSlidesById = Object.fromEntries(initialState.deck.slides.map((slide) => [slide.id, slide]));
const sampleWordHtml = initialState.word.html;
const needsSampleWordColor =
state.word.id === initialState.word.id &&
@@ -64,11 +65,25 @@ function migrateQOfficeState(state: QOfficeState): QOfficeState {
})
: state.workbook.sheets;
const slides =
state.deck.id === initialState.deck.id
? state.deck.slides.map((slide) => {
const sampleSlide = sampleSlidesById[slide.id];
if (!sampleSlide?.backgroundColor || slide.backgroundColor) {
return slide;
}
changed = true;
return { ...slide, backgroundColor: sampleSlide.backgroundColor };
})
: state.deck.slides;
return changed
? {
...state,
word: needsSampleWordColor ? { ...state.word, html: sampleWordHtml } : state.word,
workbook: { ...state.workbook, sheets },
deck: { ...state.deck, slides },
mail: { ...state.mail, messages }
}
: state;
+2 -1
View File
@@ -111,7 +111,8 @@ export const initialState: QOfficeState = {
title: "Дорожная карта QOffice",
subtitle: "Единая рабочая среда для документов, данных, презентаций и коммуникации.",
notes: "Начать с цели продукта и текущего этапа.",
theme: "classic"
theme: "classic",
backgroundColor: "EAF6FF"
},
{
id: "slide-2",
+34 -1
View File
@@ -19,6 +19,16 @@ const themeLabels: Record<Slide["theme"], string> = {
graphite: "Графит"
};
const backgroundColorSwatches = [
{ color: "", label: "Фон темы" },
{ color: "FFFFFF", label: "Белый фон" },
{ color: "EAF6FF", label: "Светло-синий фон" },
{ color: "D9EAD3", label: "Светло-зеленый фон" },
{ color: "FFF2CC", label: "Светло-желтый фон" },
{ color: "FCE4D6", label: "Коралловый фон" },
{ color: "1F2937", label: "Темный фон" }
];
const slideWidthInches = 13.333;
const slideHeightInches = 7.5;
@@ -69,6 +79,16 @@ function slideImageStyle(image: SlideImage) {
};
}
function slideCanvasStyle(slide: Slide) {
const backgroundColor = normalizedHexColor(slide.backgroundColor);
return backgroundColor ? { background: `#${backgroundColor}` } : undefined;
}
function normalizedHexColor(value?: string) {
const raw = value?.trim().replace(/^#/, "").toUpperCase() ?? "";
return /^[0-9A-F]{6}$/.test(raw) ? raw : "";
}
function clonedSlideImages(images?: SlideImage[]) {
const suffix = Date.now();
return images?.map((image, index) => ({ ...image, id: `${image.id}-copy-${suffix}-${index}` }));
@@ -324,7 +344,7 @@ export function QPowerPoint({ deck, onChange }: QPowerPointProps) {
</button>
</div>
<div className={`slide-canvas theme-${activeSlide.theme}`}>
<div className={`slide-canvas theme-${activeSlide.theme}`} style={slideCanvasStyle(activeSlide)}>
{activeImages.map((image) => (
<button
key={image.id}
@@ -370,6 +390,19 @@ export function QPowerPoint({ deck, onChange }: QPowerPointProps) {
))}
</select>
</label>
<div className="slide-background-swatches" aria-label="Фон слайда">
{backgroundColorSwatches.map((swatch) => (
<button
key={swatch.label}
className={`fill-swatch ${swatch.color ? "" : "is-empty"} ${normalizedHexColor(activeSlide.backgroundColor) === swatch.color || (!activeSlide.backgroundColor && !swatch.color) ? "is-active" : ""}`.trim()}
type="button"
onClick={() => updateSlide({ ...activeSlide, backgroundColor: swatch.color || undefined })}
title={swatch.label}
aria-label={swatch.label}
style={swatch.color ? { backgroundColor: `#${swatch.color}` } : undefined}
/>
))}
</div>
</section>
<section>
<h3>Изображения</h3>
+43
View File
@@ -201,6 +201,45 @@ describe("powerPointOffice helpers", () => {
expect(mediaFiles.length).toBeGreaterThan(0);
});
it("импортирует и экспортирует пользовательский цвет фона слайда", async () => {
const zip = new JSZip();
zip.file(
"ppt/presentation.xml",
`<p:presentation xmlns:p="http://schemas.openxmlformats.org/presentationml/2006/main" xmlns:r="http://schemas.openxmlformats.org/officeDocument/2006/relationships"><p:sldIdLst><p:sldId id="256" r:id="rId1"/></p:sldIdLst></p:presentation>`
);
zip.file(
"ppt/_rels/presentation.xml.rels",
`<Relationships xmlns="http://schemas.openxmlformats.org/package/2006/relationships"><Relationship Id="rId1" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/slide" Target="slides/slide1.xml"/></Relationships>`
);
zip.file("ppt/slides/slide1.xml", slideXmlWithBackground("Фон слайда", "FCE4D6"));
const importedBlob = await zip.generateAsync({
type: "blob",
mimeType: "application/vnd.openxmlformats-officedocument.presentationml.presentation"
});
const imported = await importPptxFile(new File([importedBlob], "Фон.pptx", { type: importedBlob.type }));
expect(imported.slides[0].backgroundColor).toBe("FCE4D6");
const exportedBlob = await exportPptxBlob({
title: "Фон.pptx",
slides: [
{
id: "slide-1",
title: "Фон слайда",
subtitle: "",
notes: "",
theme: "classic",
backgroundColor: "FCE4D6"
}
]
});
const exportedZip = await JSZip.loadAsync(await exportedBlob.arrayBuffer());
const exportedSlideXml = await exportedZip.file("ppt/slides/slide1.xml")?.async("string");
expect(exportedSlideXml).toContain("FCE4D6");
});
it("нормализует пробелы в импортированном тексте", () => {
expect(normalizeWhitespace(" Строка\tс \n пробелами ")).toBe("Строка с пробелами");
});
@@ -212,6 +251,10 @@ function slideXml(...texts: string[]) {
.join("")}</p:spTree></p:cSld></p:sld>`;
}
function slideXmlWithBackground(title: string, color: string) {
return `<p:sld xmlns:p="http://schemas.openxmlformats.org/presentationml/2006/main" xmlns:a="http://schemas.openxmlformats.org/drawingml/2006/main"><p:cSld><p:bg><p:bgPr><a:solidFill><a:srgbClr val="${color}"/></a:solidFill></p:bgPr></p:bg><p:spTree><p:sp><p:txBody><a:p><a:r><a:t>${title}</a:t></a:r></a:p></p:txBody></p:sp></p:spTree></p:cSld></p:sld>`;
}
function slideXmlWithPicture(title: string) {
return `<p:sld xmlns:p="http://schemas.openxmlformats.org/presentationml/2006/main" xmlns:a="http://schemas.openxmlformats.org/drawingml/2006/main" xmlns:r="http://schemas.openxmlformats.org/officeDocument/2006/relationships"><p:cSld><p:spTree><p:sp><p:txBody><a:p><a:r><a:t>${title}</a:t></a:r></a:p></p:txBody></p:sp><p:pic><p:nvPicPr><p:cNvPr id="4" name="Picture 1" descr="Логотип"/></p:nvPicPr><p:blipFill><a:blip r:embed="rIdImage"/></p:blipFill><p:spPr><a:xfrm><a:off x="914400" y="1828800"/><a:ext cx="2743200" cy="1371600"/></a:xfrm></p:spPr></p:pic></p:spTree></p:cSld></p:sld>`;
}
+16 -1
View File
@@ -54,6 +54,7 @@ export async function importPptxFile(file: File): Promise<ImportedPowerPointDeck
const notesPath = await slideNotesPath(zip, parser, path);
const notesXml = notesPath ? await readOptionalZipText(zip, notesPath) : await readOptionalZipText(zip, `ppt/notesSlides/notesSlide${index}.xml`);
const notes = notesXml ? extractTextBlocks(parser.parse(notesXml)).join("\n") : "";
const backgroundColor = slideBackgroundColor(parsedSlide);
return {
id: `pptx-slide-${index}`,
@@ -61,6 +62,7 @@ export async function importPptxFile(file: File): Promise<ImportedPowerPointDeck
subtitle: slideTextBlocks.slice(1).join("\n"),
notes,
theme: "classic" as const,
...(backgroundColor ? { backgroundColor } : {}),
images
};
})
@@ -97,7 +99,7 @@ export async function exportPptxBlob(deck: ExportablePowerPointDeck): Promise<Bl
for (const sourceSlide of deck.slides) {
const colors = themeColors[sourceSlide.theme] ?? themeColors.classic;
const slide = pptx.addSlide();
slide.background = { color: colors.background };
slide.background = { color: normalizeHexColor(sourceSlide.backgroundColor) || colors.background };
sourceSlide.images?.forEach((image, index) => {
const data = normalizedImageData(image.src);
if (!data || !slide.addImage) {
@@ -335,6 +337,19 @@ function normalizedImageData(src: string) {
return /^data:image\/(?:png|jpe?g|gif|bmp|svg\+xml);base64,/i.test(value) ? value : "";
}
function slideBackgroundColor(slideXml: unknown) {
const background = firstRecordByKey(slideXml, "bg");
const backgroundProperties = childRecord(background, "bgPr");
const solidFill = childRecord(backgroundProperties, "solidFill");
const srgbColor = childRecord(solidFill, "srgbClr");
return normalizeHexColor(stringValue(srgbColor.val ?? srgbColor["@_val"]));
}
function normalizeHexColor(value?: string) {
const raw = value?.trim().replace(/^#/, "").toUpperCase() ?? "";
return /^[0-9A-F]{6}$/.test(raw) ? raw : "";
}
function numberAttribute(record: Record<string, unknown>, name: string) {
const value = Number.parseFloat(stringValue(record[name] ?? record[`@_${name}`]));
return Number.isFinite(value) ? value : undefined;
+6
View File
@@ -422,6 +422,12 @@ button {
padding-left: 2px;
}
.slide-background-swatches {
display: flex;
flex-wrap: wrap;
gap: 6px;
}
.fill-swatch {
position: relative;
width: 24px;
+1
View File
@@ -64,6 +64,7 @@ export interface Slide {
subtitle: string;
notes: string;
theme: "classic" | "ocean" | "graphite";
backgroundColor?: string;
images?: SlideImage[];
}