Preserve QWord DOCX font families
This commit is contained in:
Курнат Андрей
@@ -31,7 +31,7 @@ npm run build
|
||||
|
||||
## Поддержка форматов
|
||||
|
||||
- QWord открывает `.docx` и сохраняет `.docx`; при импорте базовых DOCX-абзацев читает выравнивание, явные цвета текста, подсветку и размер шрифта из OOXML, а при экспорте DOCX сохраняются заголовки, абзацы, выравнивание абзацев, списки, простые таблицы, внешние гиперссылки, базовые растровые изображения и базовое inline-форматирование текста: полужирный, курсив, подчеркивание, цвет текста, подсветка и размер шрифта.
|
||||
- QWord открывает `.docx` и сохраняет `.docx`; при импорте базовых DOCX-абзацев читает выравнивание, явные цвета текста, подсветку, размер и семейство шрифта из OOXML, а при экспорте DOCX сохраняются заголовки, абзацы, выравнивание абзацев, списки, простые таблицы, внешние гиперссылки, базовые растровые изображения и базовое inline-форматирование текста: полужирный, курсив, подчеркивание, цвет текста, подсветка, размер и семейство шрифта.
|
||||
- QExcell открывает `.xlsx` и сохраняет `.xlsx`; сетка расширяется по фактически заполненным ячейкам, поддерживает несколько листов, формулы за пределами стартового диапазона A-H, базовые merged cells, внешние гиперссылки ячеек, базовые диаграммы листа и базовое форматирование ячеек: полужирный, курсив, подчеркивание, размер шрифта, цвет текста, заливку, горизонтальное выравнивание и числовые форматы XLSX для дат, процентов, денежных и дробных значений.
|
||||
- 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-вложения, `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` для цвета/подсветки/размера текста DOCX, выравнивание абзацев DOCX, внешние гиперссылки DOCX/XLSX, базовые растровые изображения DOCX/PPTX, простые таблицы, несколько листов XLSX, ячейки, формулы, базовые merged cells, базовые стили, цвета текста и размеры шрифта ячеек, горизонтальное выравнивание ячеек, числовые форматы и простые bar/line/pie диаграммы ячеек XLSX, текстовые слайды PPTX, пользовательский фон слайдов PPTX, заметки докладчика, адресацию `To/Cc/Bcc`, MIME-вложения EML и базовые поля одиночных MSG-писем. Сложные стили, макросы, сложные диаграммы, сложное позиционирование и обтекание изображений, PST, экспорт MSG и полная fidelity документов Microsoft Office в текущем инкременте не заявлены.
|
||||
Импорт и экспорт реализуют базовую совместимость с Office Open XML, EML и чтением MSG: текст, базовое inline-форматирование, явные `w:color`, `w:shd`, `w:highlight`, `w:sz` и `w:rFonts` для цвета/подсветки/размера/семейства текста DOCX, выравнивание абзацев DOCX, внешние гиперссылки DOCX/XLSX, базовые растровые изображения DOCX/PPTX, простые таблицы, несколько листов XLSX, ячейки, формулы, базовые merged cells, базовые стили, цвета текста и размеры шрифта ячеек, горизонтальное выравнивание ячеек, числовые форматы и простые bar/line/pie диаграммы ячеек XLSX, текстовые слайды PPTX, пользовательский фон слайдов PPTX, заметки докладчика, адресацию `To/Cc/Bcc`, MIME-вложения EML и базовые поля одиночных MSG-писем. Сложные стили, макросы, сложные диаграммы, сложное позиционирование и обтекание изображений, PST, экспорт MSG и полная fidelity документов Microsoft Office в текущем инкременте не заявлены.
|
||||
|
||||
## Сборка пакета
|
||||
|
||||
|
||||
@@ -216,6 +216,10 @@ describe("wordOffice helpers", () => {
|
||||
expect(wordInlineRunsToTextRunOptions([{ text: "Размер", fontSize: 18 }])).toEqual([{ text: "Размер", size: 36 }]);
|
||||
});
|
||||
|
||||
it("преобразует семейство шрифта inline runs в параметр docx font", () => {
|
||||
expect(wordInlineRunsToTextRunOptions([{ text: "Arial", fontFamily: "Arial" }])).toEqual([{ text: "Arial", font: "Arial" }]);
|
||||
});
|
||||
|
||||
it("записывает размер шрифта в XML экспортированного DOCX", async () => {
|
||||
const blob = await exportDocxBlob("Размер.docx", '<p><span style="font-size: 18pt;">Крупный текст</span></p>');
|
||||
const zip = await JSZip.loadAsync(await blob.arrayBuffer());
|
||||
@@ -224,6 +228,26 @@ describe("wordOffice helpers", () => {
|
||||
expect(documentXml).toContain('w:sz w:val="36"');
|
||||
});
|
||||
|
||||
it("сохраняет семейство шрифта из HTML inline-стилей для DOCX", () => {
|
||||
const blocks = htmlToWordBlocks('<p><span style="font-family: Arial, sans-serif;">Arial text</span></p>');
|
||||
|
||||
expect(blocks).toEqual([
|
||||
{
|
||||
type: "paragraph",
|
||||
text: "Arial text",
|
||||
runs: [{ text: "Arial text", fontFamily: "Arial" }]
|
||||
}
|
||||
]);
|
||||
});
|
||||
|
||||
it("записывает семейство шрифта в XML экспортированного DOCX", async () => {
|
||||
const blob = await exportDocxBlob("Шрифт.docx", '<p><span style="font-family: Arial;">Текст Arial</span></p>');
|
||||
const zip = await JSZip.loadAsync(await blob.arrayBuffer());
|
||||
const documentXml = await zip.file("word/document.xml")?.async("string");
|
||||
|
||||
expect(documentXml).toContain('w:ascii="Arial"');
|
||||
});
|
||||
|
||||
it("нормализует HTML после импорта DOCX", () => {
|
||||
expect(normalizeImportedDocxHtml(" <p>Готово</p>\n")).toBe("<p>Готово</p>");
|
||||
});
|
||||
|
||||
+44
-5
@@ -14,6 +14,7 @@ export interface WordInlineRun {
|
||||
color?: string;
|
||||
highlightColor?: string;
|
||||
fontSize?: number;
|
||||
fontFamily?: string;
|
||||
}
|
||||
|
||||
export interface WordListItem {
|
||||
@@ -362,6 +363,9 @@ function wordInlineRunToTextRunOption(run: WordInlineRun) {
|
||||
if (fontSize) {
|
||||
options.size = Math.round(fontSize * 2);
|
||||
}
|
||||
if (run.fontFamily) {
|
||||
options.font = run.fontFamily;
|
||||
}
|
||||
|
||||
return options;
|
||||
}
|
||||
@@ -520,6 +524,15 @@ function cssFontSizeValue(style: string) {
|
||||
return normalizedPointSize(match[2].toLowerCase() === "px" ? value * 0.75 : value);
|
||||
}
|
||||
|
||||
function cssFontFamilyStyleValue(style: string) {
|
||||
const raw = /(?:^|;)\s*font-family\s*:\s*([^;]+)/i.exec(style)?.[1] ?? "";
|
||||
const firstFamily = raw
|
||||
.split(",")
|
||||
.map((value) => value.trim().replace(/^["']|["']$/g, ""))
|
||||
.find(Boolean);
|
||||
return normalizedFontFamily(firstFamily);
|
||||
}
|
||||
|
||||
function normalizedCssColor(value: string) {
|
||||
const raw = value.trim().toLowerCase();
|
||||
if (!raw || ["transparent", "inherit", "initial", "currentcolor", "auto"].includes(raw)) {
|
||||
@@ -667,7 +680,8 @@ function docxRunToHtml(run: unknown) {
|
||||
const color = docxRunColor(properties);
|
||||
const highlightColor = docxRunHighlightColor(properties);
|
||||
const fontSize = docxRunFontSize(properties);
|
||||
const hasInlineColorOrHighlight = Boolean(color || highlightColor || fontSize);
|
||||
const fontFamily = docxRunFontFamily(properties);
|
||||
const hasInlineColorOrHighlight = Boolean(color || highlightColor || fontSize || fontFamily);
|
||||
let html = escapeHtml(text);
|
||||
|
||||
if (!text) {
|
||||
@@ -687,7 +701,8 @@ function docxRunToHtml(run: unknown) {
|
||||
const styles = [
|
||||
color ? `color: #${color};` : "",
|
||||
highlightColor ? `background-color: #${highlightColor};` : "",
|
||||
fontSize ? `font-size: ${formatPointSize(fontSize)}pt;` : ""
|
||||
fontSize ? `font-size: ${formatPointSize(fontSize)}pt;` : "",
|
||||
fontFamily ? `font-family: ${cssFontFamilyValue(fontFamily)};` : ""
|
||||
].filter(Boolean);
|
||||
|
||||
if (styles.length > 0) {
|
||||
@@ -747,6 +762,13 @@ function docxRunFontSize(properties: XmlRecord) {
|
||||
return normalizedPointSize(value / 2);
|
||||
}
|
||||
|
||||
function docxRunFontFamily(properties: XmlRecord) {
|
||||
const fonts = childRecord(properties, "w:rFonts");
|
||||
return normalizedFontFamily(
|
||||
docxAttribute(fonts, "w:ascii") || docxAttribute(fonts, "w:hAnsi") || docxAttribute(fonts, "w:eastAsia") || docxAttribute(fonts, "w:cs")
|
||||
);
|
||||
}
|
||||
|
||||
function normalizedDocxHexColor(value: string) {
|
||||
const normalized = value.trim().toUpperCase();
|
||||
if (!normalized || normalized === "AUTO" || normalized === "NONE") {
|
||||
@@ -842,6 +864,7 @@ function formatForElement(element: Element, inherited: InlineFormat): InlineForm
|
||||
const highlightColor =
|
||||
cssColorValue(style, "background-color") || cssColorValue(style, "background") || inherited.highlightColor;
|
||||
const fontSize = cssFontSizeValue(style) ?? inherited.fontSize;
|
||||
const fontFamily = cssFontFamilyStyleValue(style) || inherited.fontFamily;
|
||||
|
||||
return cleanInlineFormat({
|
||||
bold: inherited.bold || tagName === "b" || tagName === "strong" || /font-weight\s*:\s*(bold|[6-9]00)\b/i.test(style),
|
||||
@@ -850,7 +873,8 @@ function formatForElement(element: Element, inherited: InlineFormat): InlineForm
|
||||
...(href ? { href } : {}),
|
||||
...(color ? { color } : {}),
|
||||
...(highlightColor ? { highlightColor } : {}),
|
||||
...(fontSize ? { fontSize } : {})
|
||||
...(fontSize ? { fontSize } : {}),
|
||||
...(fontFamily ? { fontFamily } : {})
|
||||
});
|
||||
}
|
||||
|
||||
@@ -889,7 +913,8 @@ function sameInlineFormat(first: InlineFormat, second: InlineFormat) {
|
||||
(first.href ?? "") === (second.href ?? "") &&
|
||||
(first.color ?? "") === (second.color ?? "") &&
|
||||
(first.highlightColor ?? "") === (second.highlightColor ?? "") &&
|
||||
(first.fontSize ?? 0) === (second.fontSize ?? 0)
|
||||
(first.fontSize ?? 0) === (second.fontSize ?? 0) &&
|
||||
(first.fontFamily ?? "") === (second.fontFamily ?? "")
|
||||
);
|
||||
}
|
||||
|
||||
@@ -901,7 +926,8 @@ function cleanInlineFormat(format: InlineFormat): InlineFormat {
|
||||
...(format.href ? { href: format.href } : {}),
|
||||
...(format.color ? { color: format.color } : {}),
|
||||
...(format.highlightColor ? { highlightColor: format.highlightColor } : {}),
|
||||
...(format.fontSize ? { fontSize: format.fontSize } : {})
|
||||
...(format.fontSize ? { fontSize: format.fontSize } : {}),
|
||||
...(format.fontFamily ? { fontFamily: format.fontFamily } : {})
|
||||
};
|
||||
}
|
||||
|
||||
@@ -918,6 +944,19 @@ function formatPointSize(value: number) {
|
||||
return Number.isInteger(value) ? String(value) : value.toFixed(1);
|
||||
}
|
||||
|
||||
function normalizedFontFamily(value?: string) {
|
||||
const normalized = value?.trim().replace(/^["']|["']$/g, "") ?? "";
|
||||
if (!normalized || normalized.length > 80 || /[<>;]/.test(normalized)) {
|
||||
return "";
|
||||
}
|
||||
|
||||
return normalized;
|
||||
}
|
||||
|
||||
function cssFontFamilyValue(value: string) {
|
||||
return `'${value.replace(/\\/g, "\\\\").replace(/'/g, "\\'")}'`;
|
||||
}
|
||||
|
||||
function normalizedHyperlinkTarget(value?: string | null) {
|
||||
const raw = value?.trim();
|
||||
if (!raw) {
|
||||
|
||||
@@ -57,4 +57,21 @@ describe("wordOffice DOCX import", () => {
|
||||
}
|
||||
]);
|
||||
});
|
||||
|
||||
it("imports DOCX font family from OOXML", async () => {
|
||||
const blob = await exportDocxBlob("FontFamily.docx", '<p><span style="font-family: Arial;">Arial text</span></p>');
|
||||
const file = new File([blob], "FontFamily.docx", {
|
||||
type: "application/vnd.openxmlformats-officedocument.wordprocessingml.document"
|
||||
});
|
||||
const imported = await importDocxFile(file);
|
||||
|
||||
expect(imported.html).toContain("font-family: 'Arial';");
|
||||
expect(htmlToWordBlocks(imported.html)).toEqual([
|
||||
{
|
||||
type: "paragraph",
|
||||
text: "Arial text",
|
||||
runs: [{ text: "Arial text", fontFamily: "Arial" }]
|
||||
}
|
||||
]);
|
||||
});
|
||||
});
|
||||
|
||||
Reference in New Issue
Block a user