Preserve QWord quote style in DOCX
This commit is contained in:
Курнат Андрей
@@ -44,7 +44,7 @@ npm run build
|
||||
|
||||
## Поддержка форматов
|
||||
|
||||
- QWord открывает `.docx` и сохраняет `.docx`; при импорте базовых DOCX-абзацев читает заголовки Word `Heading 1`–`Heading 6`, выравнивание, отступы `w:ind`, переносы строк, разрывы страниц, табуляцию, закладки, внешние и внутренние гиперссылки-якоря, маркированные и нумерованные списки через `w:numPr`/`numbering.xml`, простые таблицы, базовые растровые изображения, явные цвета текста, подсветку, размер и семейство шрифта из OOXML, а при экспорте DOCX сохраняются заголовки HTML `h1`–`h6`, абзацы, переносы строк, разрывы страниц, табуляция, выравнивание и отступы абзацев из HTML `margin-left`/`text-indent`, закладки из HTML `id`, списки, простые таблицы, внешние и внутренние гиперссылки-якоря, базовые растровые изображения и базовое inline-форматирование текста: полужирный, курсив, подчеркивание, зачеркивание, цвет текста, подсветка, размер и семейство шрифта.
|
||||
- QWord открывает `.docx` и сохраняет `.docx`; при импорте базовых DOCX-абзацев читает заголовки Word `Heading 1`–`Heading 6`, стиль Word `Quote` как HTML `blockquote`, выравнивание, отступы `w:ind`, переносы строк, разрывы страниц, табуляцию, закладки, внешние и внутренние гиперссылки-якоря, маркированные и нумерованные списки через `w:numPr`/`numbering.xml`, простые таблицы, базовые растровые изображения, явные цвета текста, подсветку, размер и семейство шрифта из OOXML, а при экспорте DOCX сохраняются заголовки HTML `h1`–`h6`, цитаты HTML `blockquote` как стиль Word `Quote`, абзацы, переносы строк, разрывы страниц, табуляция, выравнивание и отступы абзацев из 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` и `col hidden`, высоту и скрытие строк через `row ht/customHeight` и `row hidden`, управление скрытием выбранной строки и столбца в интерфейсе, активный лист через `workbookView activeTab`, формулы за пределами стартового диапазона A-H, shared formulas XLSX с относительными ссылками, базовые merged cells, внешние и внутренние гиперссылки ячеек, legacy-заметки ячеек через `comments.xml` и VML `legacyDrawing`, базовые диаграммы листа и базовое форматирование ячеек: полужирный, курсив, подчеркивание, зачеркивание, размер и семейство шрифта, прямые RGB/theme/indexed цвета текста с учетом `xl/theme/theme1.xml`, заливку, горизонтальное и вертикальное выравнивание, перенос текста, границы и цвет границ ячеек, числовые форматы XLSX для дат, процентов, денежных и дробных значений.
|
||||
- QPowerPoint открывает `.pptx` и сохраняет `.pptx`; импорт учитывает порядок слайдов из `presentation.xml`, переносы абзацев и ручные переносы строк `a:br` внутри текстовых блоков, маркированные и нумерованные списки подзаголовка через `a:buChar`/`a:buAutoNum`, внешние ссылки текста заголовка/подзаголовка и изображений через `a:hlinkClick` и hyperlink relationships, скрытые слайды через атрибут `show`, переходы `p:transition` для `fade`/`push`/`wipe`, а также заметки докладчика через 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,6 +46,20 @@ describe("wordOffice helpers", () => {
|
||||
]);
|
||||
});
|
||||
|
||||
it("разбирает HTML blockquote как цитату QWord", () => {
|
||||
const blocks = htmlToWordBlocks('<blockquote id="Quote1">Цитата <strong>важная</strong></blockquote>');
|
||||
|
||||
expect(blocks).toEqual([
|
||||
{
|
||||
type: "paragraph",
|
||||
text: "Цитата важная",
|
||||
runs: [{ text: "Цитата " }, { text: "важная", bold: true }],
|
||||
bookmark: "Quote1",
|
||||
quote: true
|
||||
}
|
||||
]);
|
||||
});
|
||||
|
||||
it("сохраняет базовое inline-форматирование текста для DOCX", () => {
|
||||
const blocks = htmlToWordBlocks(`
|
||||
<p>Обычный <strong>полужирный</strong> <em>курсив</em> <u>подчеркнутый</u> <span style="font-weight: 700; font-style: italic; text-decoration-line: underline; color: #0f5fae; background-color: rgb(255, 242, 204);">все стили</span></p>
|
||||
@@ -198,6 +212,15 @@ describe("wordOffice helpers", () => {
|
||||
expect(documentXml).toMatch(/<w:pStyle\b[^>]*w:val="Heading6"[^>]*\/>/);
|
||||
});
|
||||
|
||||
it("записывает blockquote как стиль Quote в XML экспортированного DOCX", async () => {
|
||||
const blob = await exportDocxBlob("Цитата.docx", "<blockquote>Важная цитата</blockquote>");
|
||||
const zip = await JSZip.loadAsync(await blob.arrayBuffer());
|
||||
const documentXml = await zip.file("word/document.xml")?.async("string");
|
||||
|
||||
expect(documentXml).toMatch(/<w:pStyle\b[^>]*w:val="Quote"[^>]*\/>/);
|
||||
expect(documentXml).toContain("Важная цитата");
|
||||
});
|
||||
|
||||
it("записывает HTML-разрывы страниц как w:br w:type page в XML экспортированного DOCX", async () => {
|
||||
const blob = await exportDocxBlob("Разрыв.docx", '<p>Before<span data-qoffice-page-break="true"></span>After</p>');
|
||||
const zip = await JSZip.loadAsync(await blob.arrayBuffer());
|
||||
|
||||
+20
-8
@@ -43,7 +43,7 @@ export type WordHeadingLevel = 1 | 2 | 3 | 4 | 5 | 6;
|
||||
|
||||
export type WordBlock =
|
||||
| { type: "heading"; level: WordHeadingLevel; text: string; runs: WordInlineRun[]; alignment?: WordParagraphAlignment; indent?: WordParagraphIndent; bookmark?: string }
|
||||
| { type: "paragraph"; text: string; runs: WordInlineRun[]; alignment?: WordParagraphAlignment; indent?: WordParagraphIndent; bookmark?: string }
|
||||
| { type: "paragraph"; text: string; runs: WordInlineRun[]; alignment?: WordParagraphAlignment; indent?: WordParagraphIndent; bookmark?: string; quote?: boolean }
|
||||
| { type: "list"; ordered: boolean; items: WordListItem[] }
|
||||
| { type: "table"; rows: string[][] }
|
||||
| WordImageBlock;
|
||||
@@ -264,8 +264,8 @@ export function htmlToWordBlocks(html: string): WordBlock[] {
|
||||
return;
|
||||
}
|
||||
|
||||
if (tagName === "p" || tagName === "div") {
|
||||
blocks.push(...paragraphElementToBlocks(node));
|
||||
if (tagName === "p" || tagName === "div" || tagName === "blockquote") {
|
||||
blocks.push(...paragraphElementToBlocks(node, { quote: tagName === "blockquote" }));
|
||||
return;
|
||||
}
|
||||
|
||||
@@ -318,6 +318,7 @@ function wordBlockToDocxChildren(block: WordBlock, docx: DocxModule) {
|
||||
const children = wordInlineRunsToTextRuns(block.runs, docx);
|
||||
return [
|
||||
new docx.Paragraph({
|
||||
...(block.quote ? { style: "Quote" } : {}),
|
||||
spacing: { after: 160 },
|
||||
...docxAlignmentOption(block.alignment, docx),
|
||||
...docxIndentOption(block.indent),
|
||||
@@ -590,7 +591,7 @@ function tableRows(table: Element) {
|
||||
.filter((row) => row.length > 0);
|
||||
}
|
||||
|
||||
function paragraphElementToBlocks(element: Element): WordBlock[] {
|
||||
function paragraphElementToBlocks(element: Element, options: { quote?: boolean } = {}): WordBlock[] {
|
||||
const segments = collectInlineSegments(Array.from(element.childNodes), {});
|
||||
const alignment = paragraphAlignmentFromElement(element);
|
||||
const indent = paragraphIndentFromElement(element);
|
||||
@@ -610,7 +611,8 @@ function paragraphElementToBlocks(element: Element): WordBlock[] {
|
||||
runs,
|
||||
...(alignment ? { alignment } : {}),
|
||||
...(indent ? { indent } : {}),
|
||||
...(bookmark && !bookmarkApplied ? { bookmark } : {})
|
||||
...(bookmark && !bookmarkApplied ? { bookmark } : {}),
|
||||
...(options.quote ? { quote: true } : {})
|
||||
});
|
||||
bookmarkApplied = true;
|
||||
}
|
||||
@@ -805,7 +807,8 @@ async function styledDocxHtmlFromArrayBuffer(arrayBuffer: ArrayBuffer) {
|
||||
result.hasLineBreak ||
|
||||
result.hasPageBreak ||
|
||||
result.hasTab ||
|
||||
result.hasList
|
||||
result.hasList ||
|
||||
result.hasQuote
|
||||
? result.html
|
||||
: "";
|
||||
} catch {
|
||||
@@ -834,6 +837,7 @@ function orderedDocxDocumentToHtml(
|
||||
let hasPageBreak = false;
|
||||
let hasTab = false;
|
||||
let hasList = false;
|
||||
let hasQuote = false;
|
||||
const blocks: string[] = [];
|
||||
let openList: DocxListInfo | null = null;
|
||||
let listItems: string[] = [];
|
||||
@@ -863,6 +867,7 @@ function orderedDocxDocumentToHtml(
|
||||
hasPageBreak = hasPageBreak || result.hasPageBreak;
|
||||
hasTab = hasTab || result.hasTab;
|
||||
hasList = hasList || Boolean(result.list);
|
||||
hasQuote = hasQuote || result.hasQuote;
|
||||
|
||||
if (!result.html) {
|
||||
return;
|
||||
@@ -907,7 +912,8 @@ function orderedDocxDocumentToHtml(
|
||||
hasLineBreak,
|
||||
hasPageBreak,
|
||||
hasTab,
|
||||
hasList
|
||||
hasList,
|
||||
hasQuote
|
||||
};
|
||||
}
|
||||
|
||||
@@ -924,6 +930,7 @@ function orderedDocxParagraphToHtml(
|
||||
const list = docxParagraphListInfo(properties, numberingDefinitions);
|
||||
const hasParagraphAlignment = Boolean(style);
|
||||
const hasBookmark = Boolean(bookmark);
|
||||
const hasQuote = tagName === "blockquote";
|
||||
let hasInlineColorOrHighlight = false;
|
||||
let hasImage = false;
|
||||
let hasLineBreak = false;
|
||||
@@ -941,7 +948,7 @@ function orderedDocxParagraphToHtml(
|
||||
const content = runs.join("");
|
||||
|
||||
if (!content.trim()) {
|
||||
return { html: "", hasInlineColorOrHighlight, hasParagraphAlignment, hasBookmark, hasImage, hasLineBreak, hasPageBreak, hasTab, list };
|
||||
return { html: "", hasInlineColorOrHighlight, hasParagraphAlignment, hasBookmark, hasImage, hasLineBreak, hasPageBreak, hasTab, hasQuote, list };
|
||||
}
|
||||
|
||||
const attributes = [style ? `style="${style}"` : "", bookmark ? `id="${escapeHtml(bookmark)}"` : ""].filter(Boolean).join(" ");
|
||||
@@ -955,6 +962,7 @@ function orderedDocxParagraphToHtml(
|
||||
hasLineBreak,
|
||||
hasPageBreak,
|
||||
hasTab,
|
||||
hasQuote,
|
||||
list
|
||||
};
|
||||
}
|
||||
@@ -968,6 +976,7 @@ function orderedDocxParagraphToHtml(
|
||||
hasLineBreak,
|
||||
hasPageBreak,
|
||||
hasTab,
|
||||
hasQuote,
|
||||
list
|
||||
};
|
||||
}
|
||||
@@ -1036,6 +1045,9 @@ function docxParagraphTagName(properties: XmlRecord) {
|
||||
if (["heading6", "heading 6"].includes(styleValue)) {
|
||||
return "h6";
|
||||
}
|
||||
if (styleValue === "quote") {
|
||||
return "blockquote";
|
||||
}
|
||||
|
||||
return "p";
|
||||
}
|
||||
|
||||
@@ -22,6 +22,22 @@ describe("wordOffice DOCX import", () => {
|
||||
]);
|
||||
});
|
||||
|
||||
it("imports DOCX Quote style as blockquote", async () => {
|
||||
const blob = await exportDocxBlob("Quote.docx", "<blockquote>Quoted fragment</blockquote>");
|
||||
const file = new File([blob], "Quote.docx", { type: "application/vnd.openxmlformats-officedocument.wordprocessingml.document" });
|
||||
const imported = await importDocxFile(file);
|
||||
|
||||
expect(imported.html).toContain("<blockquote>Quoted fragment</blockquote>");
|
||||
expect(htmlToWordBlocks(imported.html)).toEqual([
|
||||
{
|
||||
type: "paragraph",
|
||||
text: "Quoted fragment",
|
||||
runs: [{ text: "Quoted fragment" }],
|
||||
quote: true
|
||||
}
|
||||
]);
|
||||
});
|
||||
|
||||
it("imports DOCX text color and highlight from OOXML", async () => {
|
||||
const blob = await exportDocxBlob(
|
||||
"Color.docx",
|
||||
|
||||
Reference in New Issue
Block a user