Preserve QWord paragraph indentation in DOCX
This commit is contained in:
Курнат Андрей
@@ -31,7 +31,7 @@ npm run build
|
||||
|
||||
## Поддержка форматов
|
||||
|
||||
- QWord открывает `.docx` и сохраняет `.docx`; при импорте базовых DOCX-абзацев читает выравнивание, переносы строк, разрывы страниц, табуляцию, закладки, внешние и внутренние гиперссылки-якоря, простые таблицы, базовые растровые изображения, явные цвета текста, подсветку, размер и семейство шрифта из OOXML, а при экспорте DOCX сохраняются заголовки, абзацы, переносы строк, разрывы страниц, табуляция, выравнивание абзацев, закладки из HTML `id`, списки, простые таблицы, внешние и внутренние гиперссылки-якоря, базовые растровые изображения и базовое inline-форматирование текста: полужирный, курсив, подчеркивание, зачеркивание, цвет текста, подсветка, размер и семейство шрифта.
|
||||
- QWord открывает `.docx` и сохраняет `.docx`; при импорте базовых DOCX-абзацев читает выравнивание, отступы `w:ind`, переносы строк, разрывы страниц, табуляцию, закладки, внешние и внутренние гиперссылки-якоря, простые таблицы, базовые растровые изображения, явные цвета текста, подсветку, размер и семейство шрифта из OOXML, а при экспорте DOCX сохраняются заголовки, абзацы, переносы строк, разрывы страниц, табуляция, выравнивание и отступы абзацев из HTML `margin-left`/`text-indent`, закладки из HTML `id`, списки, простые таблицы, внешние и внутренние гиперссылки-якоря, базовые растровые изображения и базовое inline-форматирование текста: полужирный, курсив, подчеркивание, зачеркивание, цвет текста, подсветка, размер и семейство шрифта.
|
||||
- QExcell открывает `.xlsx` и сохраняет `.xlsx`; сетка расширяется по фактически заполненным ячейкам, поддерживает несколько листов, скрытые и veryHidden листы через `sheet state`, закрепленные области через `sheetViews pane`, скрытие сетки через `sheetView showGridLines`, масштаб листа через `sheetView zoomScale`, автофильтр через `autoFilter ref`, область печати через `_xlnm.Print_Area`, цвет вкладки листа через `sheetPr tabColor`, ширину колонок через `cols/col width`, высоту строк через `row ht/customHeight`, активный лист через `workbookView activeTab`, формулы за пределами стартового диапазона A-H, shared formulas XLSX с относительными ссылками, базовые merged cells, внешние и внутренние гиперссылки ячеек, базовые диаграммы листа и базовое форматирование ячеек: полужирный, курсив, подчеркивание, зачеркивание, размер и семейство шрифта, прямые RGB/theme/indexed цвета текста с учетом `xl/theme/theme1.xml`, заливку, горизонтальное и вертикальное выравнивание, перенос текста, границы и цвет границ ячеек, числовые форматы XLSX для дат, процентов, денежных и дробных значений.
|
||||
- QPowerPoint открывает `.pptx` и сохраняет `.pptx`; импорт учитывает порядок слайдов из `presentation.xml`, переносы абзацев и ручные переносы строк `a:br` внутри текстовых блоков, скрытые слайды через атрибут `show`, а также заметки докладчика через 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`, `Reply-To`, `Message-ID`, `In-Reply-To`, `References`, `Importance`, `X-Priority` и `Priority`. Импорт MSG читает тему, отправителя, получателей `To/Cc/Bcc`, `Reply-To`, `Message-ID`, `In-Reply-To`, `References`, `Importance`, `X-Priority` и `Priority` из транспортных заголовков, текст/HTML body и вложения, если эти поля доступны в MSG-файле. Новые письма можно адресовать через `To/Cc/Bcc`, задавать `Reply-To` и сохранять в EML вместе с добавленными файлами. `.pst` и экспорт в `.msg` пока не реализованы.
|
||||
@@ -46,7 +46,7 @@ Desktop-меню поддерживает системные команды дл
|
||||
- `Ctrl/Cmd+Shift+E`: экспортировать текущую рабочую область в PDF.
|
||||
- `Ctrl/Cmd+P`: печать текущей рабочей области.
|
||||
|
||||
Импорт и экспорт реализуют базовую совместимость с Office Open XML, EML и чтением MSG: текст, базовое inline-форматирование, явные `w:br`, `w:br w:type="page"`, `w:tab`, `w:color`, `w:shd`, `w:highlight`, `w:sz`, `w:rFonts` и `w:strike` для переносов строк/разрывов страниц/табуляции/цвета/подсветки/размера/семейства/зачеркивания текста DOCX, выравнивание абзацев DOCX, закладки DOCX через `w:bookmarkStart`/`w:bookmarkEnd`, внешние `w:hyperlink r:id` и внутренние `w:hyperlink w:anchor` гиперссылки DOCX, внешние и внутренние гиперссылки XLSX, базовые растровые изображения DOCX/PPTX, простые таблицы, несколько листов, скрытые/veryHidden листы через `sheet state`, закрепленные области через `sheetViews pane`, скрытие сетки через `sheetView showGridLines`, масштаб листа через `sheetView zoomScale`, автофильтр через `autoFilter ref`, область печати XLSX через `_xlnm.Print_Area`, цвет вкладки листа через `sheetPr tabColor`, ширину колонок через `cols/col width`, высоту строк через `row ht/customHeight` и активный лист XLSX через `workbookView activeTab`, ячейки, формулы, shared formulas XLSX с относительными ссылками, базовые merged cells, базовые стили, RGB/theme/indexed цвета XLSX с учетом `xl/theme/theme1.xml`, размеры и семейства шрифта, зачеркивание ячеек, горизонтальное и вертикальное выравнивание, перенос текста, границы и цвет границ ячеек, числовые форматы и простые bar/line/pie диаграммы ячеек XLSX, текстовые слайды PPTX с переносами абзацев и ручными переносами строк `a:br` при импорте, скрытые слайды PPTX через атрибут `show`, пользовательский фон слайдов PPTX, цвет, размер и семейство шрифта текста заголовка/подзаголовка PPTX, импорт и экспорт заметок докладчика, адресацию `To/Cc/Bcc/Reply-To`, заголовки цепочки писем `Message-ID`/`In-Reply-To`/`References`, заголовки приоритета `Importance`/`X-Priority`/`Priority`, 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:br`, `w:br w:type="page"`, `w:tab`, `w:color`, `w:shd`, `w:highlight`, `w:sz`, `w:rFonts` и `w:strike` для переносов строк/разрывов страниц/табуляции/цвета/подсветки/размера/семейства/зачеркивания текста DOCX, выравнивание и отступы абзацев DOCX через `w:jc`/`w:ind`, закладки DOCX через `w:bookmarkStart`/`w:bookmarkEnd`, внешние `w:hyperlink r:id` и внутренние `w:hyperlink w:anchor` гиперссылки DOCX, внешние и внутренние гиперссылки XLSX, базовые растровые изображения DOCX/PPTX, простые таблицы, несколько листов, скрытые/veryHidden листы через `sheet state`, закрепленные области через `sheetViews pane`, скрытие сетки через `sheetView showGridLines`, масштаб листа через `sheetView zoomScale`, автофильтр через `autoFilter ref`, область печати XLSX через `_xlnm.Print_Area`, цвет вкладки листа через `sheetPr tabColor`, ширину колонок через `cols/col width`, высоту строк через `row ht/customHeight` и активный лист XLSX через `workbookView activeTab`, ячейки, формулы, shared formulas XLSX с относительными ссылками, базовые merged cells, базовые стили, RGB/theme/indexed цвета XLSX с учетом `xl/theme/theme1.xml`, размеры и семейства шрифта, зачеркивание ячеек, горизонтальное и вертикальное выравнивание, перенос текста, границы и цвет границ ячеек, числовые форматы и простые bar/line/pie диаграммы ячеек XLSX, текстовые слайды PPTX с переносами абзацев и ручными переносами строк `a:br` при импорте, скрытые слайды PPTX через атрибут `show`, пользовательский фон слайдов PPTX, цвет, размер и семейство шрифта текста заголовка/подзаголовка PPTX, импорт и экспорт заметок докладчика, адресацию `To/Cc/Bcc/Reply-To`, заголовки цепочки писем `Message-ID`/`In-Reply-To`/`References`, заголовки приоритета `Importance`/`X-Priority`/`Priority`, MIME encoded-word заголовки UTF-8/windows-1251, MIME-вложения EML, inline-вложения EML с `Content-ID` и базовые поля одиночных MSG-писем. Сложные стили, макросы, сложные диаграммы, сложное позиционирование и обтекание изображений, PST, экспорт MSG и полная fidelity документов Microsoft Office в текущем инкременте не заявлены.
|
||||
|
||||
## Сборка пакета
|
||||
|
||||
|
||||
@@ -371,6 +371,30 @@ describe("wordOffice helpers", () => {
|
||||
expect(documentXml).toContain("<w:strike/>");
|
||||
});
|
||||
|
||||
it("сохраняет HTML-отступы абзацев и заголовков для DOCX", () => {
|
||||
const blocks = htmlToWordBlocks(`
|
||||
<h1 style="margin-left: 36pt; text-indent: 18pt;">Title</h1>
|
||||
<p style="margin-left: 48px; text-indent: -12pt;">Indented paragraph</p>
|
||||
`);
|
||||
|
||||
expect(blocks).toEqual([
|
||||
{ type: "heading", level: 1, text: "Title", runs: [{ text: "Title" }], indent: { left: 720, firstLine: 360 } },
|
||||
{ type: "paragraph", text: "Indented paragraph", runs: [{ text: "Indented paragraph" }], indent: { left: 720, hanging: 240 } }
|
||||
]);
|
||||
});
|
||||
|
||||
it("записывает отступы абзацев в w:ind экспортированного DOCX", async () => {
|
||||
const blob = await exportDocxBlob(
|
||||
"Indent.docx",
|
||||
'<p style="margin-left: 36pt; text-indent: 18pt;">Indented</p><p style="margin-left: 48px; text-indent: -12pt;">Hanging</p>'
|
||||
);
|
||||
const zip = await JSZip.loadAsync(await blob.arrayBuffer());
|
||||
const documentXml = await zip.file("word/document.xml")?.async("string");
|
||||
|
||||
expect(documentXml).toMatch(/<w:ind\b(?=[^>]*w:left="720")(?=[^>]*w:firstLine="360")[^>]*\/>/);
|
||||
expect(documentXml).toMatch(/<w:ind\b(?=[^>]*w:left="720")(?=[^>]*w:hanging="240")[^>]*\/>/);
|
||||
});
|
||||
|
||||
it("нормализует HTML после импорта DOCX", () => {
|
||||
expect(normalizeImportedDocxHtml(" <p>Готово</p>\n")).toBe("<p>Готово</p>");
|
||||
});
|
||||
|
||||
+113
-3
@@ -33,9 +33,15 @@ export interface WordImageBlock {
|
||||
|
||||
export type WordParagraphAlignment = "left" | "center" | "right" | "both";
|
||||
|
||||
export interface WordParagraphIndent {
|
||||
left?: number;
|
||||
firstLine?: number;
|
||||
hanging?: number;
|
||||
}
|
||||
|
||||
export type WordBlock =
|
||||
| { type: "heading"; level: 1 | 2; text: string; runs: WordInlineRun[]; alignment?: WordParagraphAlignment; bookmark?: string }
|
||||
| { type: "paragraph"; text: string; runs: WordInlineRun[]; alignment?: WordParagraphAlignment; bookmark?: string }
|
||||
| { type: "heading"; level: 1 | 2; text: string; runs: WordInlineRun[]; alignment?: WordParagraphAlignment; indent?: WordParagraphIndent; bookmark?: string }
|
||||
| { type: "paragraph"; text: string; runs: WordInlineRun[]; alignment?: WordParagraphAlignment; indent?: WordParagraphIndent; bookmark?: string }
|
||||
| { type: "list"; ordered: boolean; items: WordListItem[] }
|
||||
| { type: "table"; rows: string[][] }
|
||||
| WordImageBlock;
|
||||
@@ -234,6 +240,7 @@ export function htmlToWordBlocks(html: string): WordBlock[] {
|
||||
const runs = elementInlineRuns(node);
|
||||
const text = inlineRunsText(runs);
|
||||
const alignment = paragraphAlignmentFromElement(node);
|
||||
const indent = paragraphIndentFromElement(node);
|
||||
const bookmark = bookmarkFromElement(node);
|
||||
if (text) {
|
||||
blocks.push({
|
||||
@@ -242,6 +249,7 @@ export function htmlToWordBlocks(html: string): WordBlock[] {
|
||||
text,
|
||||
runs,
|
||||
...(alignment ? { alignment } : {}),
|
||||
...(indent ? { indent } : {}),
|
||||
...(bookmark ? { bookmark } : {})
|
||||
});
|
||||
}
|
||||
@@ -292,6 +300,7 @@ function wordBlockToDocxChildren(block: WordBlock, docx: DocxModule) {
|
||||
heading: block.level === 1 ? docx.HeadingLevel.HEADING_1 : docx.HeadingLevel.HEADING_2,
|
||||
spacing: { after: 160 },
|
||||
...docxAlignmentOption(block.alignment, docx),
|
||||
...docxIndentOption(block.indent),
|
||||
children: bookmarkDocxChildren(block.bookmark, children, docx)
|
||||
})
|
||||
];
|
||||
@@ -303,6 +312,7 @@ function wordBlockToDocxChildren(block: WordBlock, docx: DocxModule) {
|
||||
new docx.Paragraph({
|
||||
spacing: { after: 160 },
|
||||
...docxAlignmentOption(block.alignment, docx),
|
||||
...docxIndentOption(block.indent),
|
||||
children: bookmarkDocxChildren(block.bookmark, children, docx)
|
||||
})
|
||||
];
|
||||
@@ -481,6 +491,22 @@ function docxAlignmentOption(alignment: WordParagraphAlignment | undefined, docx
|
||||
return value ? { alignment: value } : {};
|
||||
}
|
||||
|
||||
function docxIndentOption(indent: WordParagraphIndent | undefined) {
|
||||
const normalized = normalizedParagraphIndent(indent);
|
||||
return Object.keys(normalized).length > 0 ? { indent: normalized } : {};
|
||||
}
|
||||
|
||||
function normalizedParagraphIndent(indent: WordParagraphIndent | undefined) {
|
||||
const left = normalizedTwips(indent?.left);
|
||||
const firstLine = normalizedTwips(indent?.firstLine);
|
||||
const hanging = normalizedTwips(indent?.hanging);
|
||||
return {
|
||||
...(left ? { left } : {}),
|
||||
...(firstLine ? { firstLine } : {}),
|
||||
...(!firstLine && hanging ? { hanging } : {})
|
||||
};
|
||||
}
|
||||
|
||||
function docxAlignmentValue(alignment: WordParagraphAlignment | undefined, docx: DocxModule) {
|
||||
if (!alignment) {
|
||||
return "";
|
||||
@@ -546,6 +572,7 @@ function tableRows(table: Element) {
|
||||
function paragraphElementToBlocks(element: Element): WordBlock[] {
|
||||
const segments = collectInlineSegments(Array.from(element.childNodes), {});
|
||||
const alignment = paragraphAlignmentFromElement(element);
|
||||
const indent = paragraphIndentFromElement(element);
|
||||
const bookmark = bookmarkFromElement(element);
|
||||
const blocks: WordBlock[] = [];
|
||||
let pendingRuns: WordInlineRun[] = [];
|
||||
@@ -561,6 +588,7 @@ function paragraphElementToBlocks(element: Element): WordBlock[] {
|
||||
text,
|
||||
runs,
|
||||
...(alignment ? { alignment } : {}),
|
||||
...(indent ? { indent } : {}),
|
||||
...(bookmark && !bookmarkApplied ? { bookmark } : {})
|
||||
});
|
||||
bookmarkApplied = true;
|
||||
@@ -596,6 +624,18 @@ function paragraphAlignmentFromElement(element: Element): WordParagraphAlignment
|
||||
return normalized === "justify" ? "both" : undefined;
|
||||
}
|
||||
|
||||
function paragraphIndentFromElement(element: Element): WordParagraphIndent | undefined {
|
||||
const style = element.getAttribute("style") ?? "";
|
||||
const left = cssTwipsValue(style, "margin-left");
|
||||
const textIndent = cssTwipsValue(style, "text-indent");
|
||||
const indent = {
|
||||
...(left && left > 0 ? { left } : {}),
|
||||
...(textIndent && textIndent > 0 ? { firstLine: textIndent } : {}),
|
||||
...(textIndent && textIndent < 0 ? { hanging: Math.abs(textIndent) } : {})
|
||||
};
|
||||
return Object.keys(indent).length > 0 ? indent : undefined;
|
||||
}
|
||||
|
||||
function bookmarkFromElement(element: Element) {
|
||||
return normalizedDocxAnchor(element.getAttribute("id") || element.getAttribute("name"));
|
||||
}
|
||||
@@ -604,6 +644,40 @@ function cssTextAlignValue(style: string) {
|
||||
return /(?:^|;)\s*text-align\s*:\s*([^;]+)/i.exec(style)?.[1] ?? "";
|
||||
}
|
||||
|
||||
function cssTwipsValue(style: string, property: "margin-left" | "text-indent") {
|
||||
const raw = new RegExp(`(?:^|;)\\s*${property}\\s*:\\s*([^;]+)`, "i").exec(style)?.[1]?.trim().toLowerCase() ?? "";
|
||||
return cssLengthToTwips(raw);
|
||||
}
|
||||
|
||||
function cssLengthToTwips(raw: string) {
|
||||
if (!raw || ["inherit", "initial", "unset", "revert", "auto"].includes(raw)) {
|
||||
return undefined;
|
||||
}
|
||||
|
||||
const match = /^(-?[0-9]+(?:\.[0-9]+)?)(pt|px|in|cm|mm)$/i.exec(raw);
|
||||
if (!match) {
|
||||
return undefined;
|
||||
}
|
||||
|
||||
const value = Number.parseFloat(match[1]);
|
||||
if (!Number.isFinite(value) || value === 0) {
|
||||
return undefined;
|
||||
}
|
||||
|
||||
const unit = match[2].toLowerCase();
|
||||
const twips =
|
||||
unit === "pt"
|
||||
? value * 20
|
||||
: unit === "px"
|
||||
? value * 15
|
||||
: unit === "in"
|
||||
? value * 1440
|
||||
: unit === "cm"
|
||||
? (value * 1440) / 2.54
|
||||
: (value * 1440) / 25.4;
|
||||
return Math.round(twips);
|
||||
}
|
||||
|
||||
function cssColorValue(style: string, property: "color" | "background" | "background-color") {
|
||||
const value = new RegExp(`(?:^|;)\\s*${property}\\s*:\\s*([^;]+)`, "i").exec(style)?.[1] ?? "";
|
||||
return normalizedCssColor(value);
|
||||
@@ -877,7 +951,23 @@ function docxParagraphTagName(properties: XmlRecord) {
|
||||
function docxParagraphStyleAttribute(properties: XmlRecord) {
|
||||
const alignment = docxAttribute(childRecord(properties, "w:jc"), "w:val");
|
||||
const htmlAlignment = alignment === "both" ? "justify" : alignment;
|
||||
return ["left", "center", "right", "justify"].includes(htmlAlignment) ? `text-align: ${htmlAlignment};` : "";
|
||||
const styles = [
|
||||
["left", "center", "right", "justify"].includes(htmlAlignment) ? `text-align: ${htmlAlignment};` : "",
|
||||
...docxParagraphIndentStyles(properties)
|
||||
].filter(Boolean);
|
||||
return styles.join(" ");
|
||||
}
|
||||
|
||||
function docxParagraphIndentStyles(properties: XmlRecord) {
|
||||
const indent = childRecord(properties, "w:ind");
|
||||
const left = docxTwipsAttribute(indent, ["w:left", "w:start"]);
|
||||
const firstLine = docxTwipsAttribute(indent, ["w:firstLine"]);
|
||||
const hanging = docxTwipsAttribute(indent, ["w:hanging"]);
|
||||
return [
|
||||
left ? `margin-left: ${formatPointSize(left / 20)}pt;` : "",
|
||||
firstLine ? `text-indent: ${formatPointSize(firstLine / 20)}pt;` : "",
|
||||
!firstLine && hanging ? `text-indent: -${formatPointSize(hanging / 20)}pt;` : ""
|
||||
].filter(Boolean);
|
||||
}
|
||||
|
||||
function orderedDocxParagraphBookmark(paragraph: unknown) {
|
||||
@@ -1321,6 +1411,17 @@ function docxAttribute(record: XmlRecord, name: string) {
|
||||
return typeof value === "string" || typeof value === "number" ? String(value) : "";
|
||||
}
|
||||
|
||||
function docxTwipsAttribute(record: XmlRecord, names: string[]) {
|
||||
for (const name of names) {
|
||||
const value = normalizedTwips(docxAttribute(record, name));
|
||||
if (value) {
|
||||
return value;
|
||||
}
|
||||
}
|
||||
|
||||
return undefined;
|
||||
}
|
||||
|
||||
function xmlNodeText(value: unknown): string {
|
||||
if (typeof value === "string" || typeof value === "number") {
|
||||
return String(value);
|
||||
@@ -1467,6 +1568,15 @@ function normalizedPointSize(value: unknown) {
|
||||
return Math.round(numeric * 2) / 2;
|
||||
}
|
||||
|
||||
function normalizedTwips(value: unknown) {
|
||||
const numeric = typeof value === "number" ? value : Number.parseFloat(String(value ?? ""));
|
||||
if (!Number.isFinite(numeric) || numeric <= 0) {
|
||||
return undefined;
|
||||
}
|
||||
|
||||
return Math.min(31680, Math.round(numeric));
|
||||
}
|
||||
|
||||
function formatPointSize(value: number) {
|
||||
return Number.isInteger(value) ? String(value) : value.toFixed(1);
|
||||
}
|
||||
|
||||
@@ -256,4 +256,22 @@ describe("wordOffice DOCX import", () => {
|
||||
rows: [["Stage", "Done"]]
|
||||
});
|
||||
});
|
||||
|
||||
it("imports DOCX paragraph indentation from OOXML", async () => {
|
||||
const blob = await exportDocxBlob(
|
||||
"Indent.docx",
|
||||
'<p style="margin-left: 36pt; text-indent: 18pt;">Indented</p><p style="margin-left: 48px; text-indent: -12pt;">Hanging</p>'
|
||||
);
|
||||
const file = new File([blob], "Indent.docx", {
|
||||
type: "application/vnd.openxmlformats-officedocument.wordprocessingml.document"
|
||||
});
|
||||
const imported = await importDocxFile(file);
|
||||
|
||||
expect(imported.html).toContain("margin-left: 36pt; text-indent: 18pt;");
|
||||
expect(imported.html).toContain("margin-left: 36pt; text-indent: -12pt;");
|
||||
expect(htmlToWordBlocks(imported.html)).toEqual([
|
||||
{ type: "paragraph", text: "Indented", runs: [{ text: "Indented" }], indent: { left: 720, firstLine: 360 } },
|
||||
{ type: "paragraph", text: "Hanging", runs: [{ text: "Hanging" }], indent: { left: 720, hanging: 240 } }
|
||||
]);
|
||||
});
|
||||
});
|
||||
|
||||
Reference in New Issue
Block a user