diff --git a/README.md b/README.md index 7afb9c0..855f6c3 100644 --- a/README.md +++ b/README.md @@ -44,7 +44,7 @@ npm run build ## Поддержка форматов -- QWord открывает `.docx` и сохраняет `.docx`; при импорте базовых DOCX-абзацев читает заголовки Word `Heading 1`/`Heading 2`/`Heading 3`, выравнивание, отступы `w:ind`, переносы строк, разрывы страниц, табуляцию, закладки, внешние и внутренние гиперссылки-якоря, маркированные и нумерованные списки через `w:numPr`/`numbering.xml`, простые таблицы, базовые растровые изображения, явные цвета текста, подсветку, размер и семейство шрифта из OOXML, а при экспорте DOCX сохраняются заголовки HTML `h1`/`h2`/`h3`, абзацы, переносы строк, разрывы страниц, табуляция, выравнивание и отступы абзацев из HTML `margin-left`/`text-indent`, закладки из HTML `id`, списки, простые таблицы, внешние и внутренние гиперссылки-якоря, базовые растровые изображения и базовое inline-форматирование текста: полужирный, курсив, подчеркивание, зачеркивание, цвет текста, подсветка, размер и семейство шрифта. +- 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-форматирование текста: полужирный, курсив, подчеркивание, зачеркивание, цвет текста, подсветка, размер и семейство шрифта. - 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` пока не реализованы. diff --git a/src/features/qword/QWord.tsx b/src/features/qword/QWord.tsx index 8d16ec5..525c858 100644 --- a/src/features/qword/QWord.tsx +++ b/src/features/qword/QWord.tsx @@ -129,6 +129,9 @@ const styleGalleryOptions = [ { value: "h1", label: "Заголовок 1" }, { value: "h2", label: "Заголовок 2" }, { value: "h3", label: "Заголовок 3" }, + { value: "h4", label: "Заголовок 4" }, + { value: "h5", label: "Заголовок 5" }, + { value: "h6", label: "Заголовок 6" }, { value: "blockquote", label: "Цитата" } ]; diff --git a/src/io/wordOffice.test.ts b/src/io/wordOffice.test.ts index 12272ef..d78bc39 100644 --- a/src/io/wordOffice.test.ts +++ b/src/io/wordOffice.test.ts @@ -11,6 +11,9 @@ describe("wordOffice helpers", () => {

План проекта

Задачи

Контроль качества

+

Сценарии

+
Шаги
+
Детали

Первый абзац.

`); @@ -19,6 +22,9 @@ describe("wordOffice helpers", () => { { type: "heading", level: 1, text: "План проекта", runs: [{ text: "План проекта" }] }, { type: "heading", level: 2, text: "Задачи", runs: [{ text: "Задачи" }] }, { type: "heading", level: 3, text: "Контроль качества", runs: [{ text: "Контроль качества" }] }, + { type: "heading", level: 4, text: "Сценарии", runs: [{ text: "Сценарии" }] }, + { type: "heading", level: 5, text: "Шаги", runs: [{ text: "Шаги" }] }, + { type: "heading", level: 6, text: "Детали", runs: [{ text: "Детали" }] }, { type: "paragraph", text: "Первый абзац.", runs: [{ text: "Первый абзац." }] }, { type: "list", @@ -181,12 +187,15 @@ describe("wordOffice helpers", () => { expect(documentXml).toMatch(/]*>Line 1<\/w:t>[\s\S]*[\s\S]*]*>Line 2<\/w:t>/); }); - it("записывает h3 как стиль Heading3 в XML экспортированного DOCX", async () => { - const blob = await exportDocxBlob("Заголовок3.docx", "

Подраздел

"); + it("записывает h3-h6 как стили Heading3-Heading6 в XML экспортированного DOCX", async () => { + const blob = await exportDocxBlob("Заголовки.docx", "

Раздел

Подраздел

Сценарий
Деталь
"); const zip = await JSZip.loadAsync(await blob.arrayBuffer()); const documentXml = await zip.file("word/document.xml")?.async("string"); expect(documentXml).toMatch(/]*w:val="Heading3"[^>]*\/>/); + expect(documentXml).toMatch(/]*w:val="Heading4"[^>]*\/>/); + expect(documentXml).toMatch(/]*w:val="Heading5"[^>]*\/>/); + expect(documentXml).toMatch(/]*w:val="Heading6"[^>]*\/>/); }); it("записывает HTML-разрывы страниц как w:br w:type page в XML экспортированного DOCX", async () => { diff --git a/src/io/wordOffice.ts b/src/io/wordOffice.ts index c84b45c..5bcae2f 100644 --- a/src/io/wordOffice.ts +++ b/src/io/wordOffice.ts @@ -39,8 +39,10 @@ export interface WordParagraphIndent { hanging?: number; } +export type WordHeadingLevel = 1 | 2 | 3 | 4 | 5 | 6; + export type WordBlock = - | { type: "heading"; level: 1 | 2 | 3; text: string; runs: WordInlineRun[]; alignment?: WordParagraphAlignment; indent?: WordParagraphIndent; bookmark?: string } + | { 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: "list"; ordered: boolean; items: WordListItem[] } | { type: "table"; rows: string[][] } @@ -111,7 +113,10 @@ const mammothStyleMap = [ "p[style-name='Title'] => h1:fresh", "p[style-name='Heading 1'] => h1:fresh", "p[style-name='Heading 2'] => h2:fresh", - "p[style-name='Heading 3'] => h3:fresh" + "p[style-name='Heading 3'] => h3:fresh", + "p[style-name='Heading 4'] => h4:fresh", + "p[style-name='Heading 5'] => h5:fresh", + "p[style-name='Heading 6'] => h6:fresh" ]; const xmlParserOptions = { ignoreAttributes: false, @@ -239,7 +244,7 @@ export function htmlToWordBlocks(html: string): WordBlock[] { return; } - if (tagName === "h1" || tagName === "h2" || tagName === "h3") { + if (isHeadingTagName(tagName)) { const runs = elementInlineRuns(node); const text = inlineRunsText(runs); const alignment = paragraphAlignmentFromElement(node); @@ -382,20 +387,17 @@ export function wordInlineRunsToTextRunOptions(runs: WordInlineRun[]) { return runs.map(wordInlineRunToTextRunOption); } -function headingLevelFromTagName(tagName: string): 1 | 2 | 3 { - if (tagName === "h3") { - return 3; - } - - return tagName === "h2" ? 2 : 1; +function isHeadingTagName(tagName: string): tagName is `h${WordHeadingLevel}` { + return /^h[1-6]$/.test(tagName); } -function docxHeadingLevel(level: 1 | 2 | 3, docx: DocxModule) { - if (level === 3) { - return docx.HeadingLevel.HEADING_3 ?? docx.HeadingLevel.HEADING_2; - } +function headingLevelFromTagName(tagName: `h${WordHeadingLevel}`): WordHeadingLevel { + return Number.parseInt(tagName.slice(1), 10) as WordHeadingLevel; +} - return level === 1 ? docx.HeadingLevel.HEADING_1 : docx.HeadingLevel.HEADING_2; +function docxHeadingLevel(level: WordHeadingLevel, docx: DocxModule) { + const headingKey = `HEADING_${level}`; + return docx.HeadingLevel[headingKey] ?? docx.HeadingLevel.HEADING_2; } function wordInlineRunToTextRunOption(run: WordInlineRun) { @@ -1025,6 +1027,15 @@ function docxParagraphTagName(properties: XmlRecord) { if (["heading3", "heading 3"].includes(styleValue)) { return "h3"; } + if (["heading4", "heading 4"].includes(styleValue)) { + return "h4"; + } + if (["heading5", "heading 5"].includes(styleValue)) { + return "h5"; + } + if (["heading6", "heading 6"].includes(styleValue)) { + return "h6"; + } return "p"; } diff --git a/src/io/wordOfficeImport.test.ts b/src/io/wordOfficeImport.test.ts index 5a55f12..70c79a3 100644 --- a/src/io/wordOfficeImport.test.ts +++ b/src/io/wordOfficeImport.test.ts @@ -5,13 +5,21 @@ const tinyPngBase64 = "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42 const tinyPngDataUri = `data:image/png;base64,${tinyPngBase64}`; describe("wordOffice DOCX import", () => { - it("imports DOCX Heading 3 as h3", async () => { - const blob = await exportDocxBlob("Heading3.docx", "

Quality gate

"); - const file = new File([blob], "Heading3.docx", { type: "application/vnd.openxmlformats-officedocument.wordprocessingml.document" }); + it("imports DOCX Heading 3-6 as h3-h6", async () => { + const blob = await exportDocxBlob("Headings.docx", "

Quality gate

Scenario

Step
Detail
"); + const file = new File([blob], "Headings.docx", { type: "application/vnd.openxmlformats-officedocument.wordprocessingml.document" }); const imported = await importDocxFile(file); expect(imported.html).toContain("

Quality gate

"); - expect(htmlToWordBlocks(imported.html)).toEqual([{ type: "heading", level: 3, text: "Quality gate", runs: [{ text: "Quality gate" }] }]); + expect(imported.html).toContain("

Scenario

"); + expect(imported.html).toContain("
Step
"); + expect(imported.html).toContain("
Detail
"); + expect(htmlToWordBlocks(imported.html)).toEqual([ + { type: "heading", level: 3, text: "Quality gate", runs: [{ text: "Quality gate" }] }, + { type: "heading", level: 4, text: "Scenario", runs: [{ text: "Scenario" }] }, + { type: "heading", level: 5, text: "Step", runs: [{ text: "Step" }] }, + { type: "heading", level: 6, text: "Detail", runs: [{ text: "Detail" }] } + ]); }); it("imports DOCX text color and highlight from OOXML", async () => {