From b8c347142a2f2a0f77dd9f14efb37ff0b62c2f64 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=D0=9A=D1=83=D1=80=D0=BD=D0=B0=D1=82=20=D0=90=D0=BD=D0=B4?= =?UTF-8?q?=D1=80=D0=B5=D0=B9?= Date: Tue, 2 Jun 2026 07:24:42 +0300 Subject: [PATCH] Preserve QWord subscript superscript in DOCX --- README.md | 4 ++-- src/io/wordOffice.test.ts | 40 +++++++++++++++++++++++++++++++++ src/io/wordOffice.ts | 36 ++++++++++++++++++++++++++++- src/io/wordOfficeImport.test.ts | 23 +++++++++++++++++++ 4 files changed, 100 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 9f57b6f..8be9400 100644 --- a/README.md +++ b/README.md @@ -44,7 +44,7 @@ npm run build ## Поддержка форматов -- 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-форматирование текста: полужирный, курсив, подчеркивание, зачеркивание, цвет текста, подсветка, размер и семейство шрифта. +- QWord открывает `.docx` и сохраняет `.docx`; при импорте базовых DOCX-абзацев читает заголовки Word `Heading 1`–`Heading 6`, стиль Word `Quote` как HTML `blockquote`, выравнивание, отступы `w:ind`, переносы строк, разрывы страниц, табуляцию, закладки, внешние и внутренние гиперссылки-якоря, маркированные и нумерованные списки через `w:numPr`/`numbering.xml`, простые таблицы, базовые растровые изображения, явные цвета текста, подсветку, размер и семейство шрифта из OOXML, нижний и верхний индекс через `w:vertAlign`, а при экспорте 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` пока не реализованы. @@ -60,7 +60,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 через `w:jc`/`w:ind`, закладки DOCX через `w:bookmarkStart`/`w:bookmarkEnd`, внешние `w:hyperlink r:id` и внутренние `w:hyperlink w:anchor` гиперссылки DOCX, маркированные и нумерованные списки DOCX через `w:numPr` и `numbering.xml`, внешние и внутренние гиперссылки XLSX, legacy-заметки ячеек XLSX через `comments.xml`, relationship `comments`, VML `vmlDrawing` и `legacyDrawing`, базовые растровые изображения DOCX/PPTX, простые таблицы, несколько листов, скрытые/veryHidden листы через `sheet state`, закрепленные области через `sheetViews pane`, скрытие сетки через `sheetView showGridLines`, масштаб листа через `sheetView zoomScale`, автофильтр через `autoFilter ref`, область печати XLSX через `_xlnm.Print_Area`, цвет вкладки листа через `sheetPr tabColor`, ширину и скрытие колонок через `cols/col width`/`col hidden`, высоту и скрытие строк через `row ht/customHeight`/`row hidden` и активный лист XLSX через `workbookView activeTab`, ячейки, формулы, shared formulas XLSX с относительными ссылками, базовые merged cells, базовые стили, RGB/theme/indexed цвета XLSX с учетом `xl/theme/theme1.xml`, размеры и семейства шрифта, зачеркивание ячеек, горизонтальное и вертикальное выравнивание, перенос текста, границы и цвет границ ячеек, числовые форматы и простые bar/line/pie диаграммы ячеек XLSX, текстовые слайды PPTX с переносами абзацев и ручными переносами строк `a:br` при импорте, внешние ссылки текста заголовка/подзаголовка и изображений PPTX через `a:hlinkClick` и hyperlink relationships, скрытые слайды PPTX через атрибут `show`, переходы PPTX через `p:transition` для `fade`/`push`/`wipe`, пользовательский фон слайдов 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` и `w:vertAlign` для переносов строк/разрывов страниц/табуляции/цвета/подсветки/размера/семейства/зачеркивания/нижнего и верхнего индекса текста DOCX, выравнивание и отступы абзацев DOCX через `w:jc`/`w:ind`, закладки DOCX через `w:bookmarkStart`/`w:bookmarkEnd`, внешние `w:hyperlink r:id` и внутренние `w:hyperlink w:anchor` гиперссылки DOCX, маркированные и нумерованные списки DOCX через `w:numPr` и `numbering.xml`, внешние и внутренние гиперссылки XLSX, legacy-заметки ячеек XLSX через `comments.xml`, relationship `comments`, VML `vmlDrawing` и `legacyDrawing`, базовые растровые изображения DOCX/PPTX, простые таблицы, несколько листов, скрытые/veryHidden листы через `sheet state`, закрепленные области через `sheetViews pane`, скрытие сетки через `sheetView showGridLines`, масштаб листа через `sheetView zoomScale`, автофильтр через `autoFilter ref`, область печати XLSX через `_xlnm.Print_Area`, цвет вкладки листа через `sheetPr tabColor`, ширину и скрытие колонок через `cols/col width`/`col hidden`, высоту и скрытие строк через `row ht/customHeight`/`row hidden` и активный лист XLSX через `workbookView activeTab`, ячейки, формулы, shared formulas XLSX с относительными ссылками, базовые merged cells, базовые стили, RGB/theme/indexed цвета XLSX с учетом `xl/theme/theme1.xml`, размеры и семейства шрифта, зачеркивание ячеек, горизонтальное и вертикальное выравнивание, перенос текста, границы и цвет границ ячеек, числовые форматы и простые bar/line/pie диаграммы ячеек XLSX, текстовые слайды PPTX с переносами абзацев и ручными переносами строк `a:br` при импорте, внешние ссылки текста заголовка/подзаголовка и изображений PPTX через `a:hlinkClick` и hyperlink relationships, скрытые слайды PPTX через атрибут `show`, переходы PPTX через `p:transition` для `fade`/`push`/`wipe`, пользовательский фон слайдов 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 в текущем инкременте не заявлены. Для QOutlook EML round-trip дополнительно покрывает HTML body через `multipart/alternative` без вложений и с вложениями внутри `multipart/mixed`. diff --git a/src/io/wordOffice.test.ts b/src/io/wordOffice.test.ts index 460aa69..15de62b 100644 --- a/src/io/wordOffice.test.ts +++ b/src/io/wordOffice.test.ts @@ -119,6 +119,25 @@ describe("wordOffice helpers", () => { ]); }); + it("preserves HTML subscript and superscript as inline runs for DOCX", () => { + const blocks = htmlToWordBlocks('

H2O m2 x

'); + + expect(blocks).toEqual([ + { + type: "paragraph", + text: "H2O m2 x", + runs: [ + { text: "H" }, + { text: "2", subscript: true }, + { text: "O m" }, + { text: "2", superscript: true }, + { text: " " }, + { text: "x", superscript: true } + ] + } + ]); + }); + it("сохраняет выравнивание абзацев и заголовков для DOCX", () => { const blocks = htmlToWordBlocks(`

Итоги

@@ -405,6 +424,27 @@ describe("wordOffice helpers", () => { expect(wordInlineRunsToTextRunOptions([{ text: "Deleted", strike: true }])).toEqual([{ text: "Deleted", strike: true }]); }); + it("converts subscript and superscript inline runs into docx parameters", () => { + expect( + wordInlineRunsToTextRunOptions([ + { text: "2", subscript: true }, + { text: "2", superscript: true } + ]) + ).toEqual([ + { text: "2", subScript: true }, + { text: "2", superScript: true } + ]); + }); + + it("writes subscript and superscript to exported DOCX XML", async () => { + const blob = await exportDocxBlob("Indexes.docx", "

H2O m2

"); + const zip = await JSZip.loadAsync(await blob.arrayBuffer()); + const documentXml = await zip.file("word/document.xml")?.async("string"); + + expect(documentXml).toMatch(/]*w:val="subscript"[^>]*\/>/); + expect(documentXml).toMatch(/]*w:val="superscript"[^>]*\/>/); + }); + it("записывает зачеркнутый текст в XML экспортированного DOCX", async () => { const blob = await exportDocxBlob("Зачеркнутый.docx", "

Удаленный текст

"); const zip = await JSZip.loadAsync(await blob.arrayBuffer()); diff --git a/src/io/wordOffice.ts b/src/io/wordOffice.ts index 71d875d..88481f1 100644 --- a/src/io/wordOffice.ts +++ b/src/io/wordOffice.ts @@ -11,6 +11,8 @@ export interface WordInlineRun { italics?: boolean; underline?: boolean; strike?: boolean; + subscript?: boolean; + superscript?: boolean; href?: string; color?: string; highlightColor?: string; @@ -415,6 +417,11 @@ function wordInlineRunToTextRunOption(run: WordInlineRun) { if (run.strike) { options.strike = true; } + if (run.superscript) { + options.superScript = true; + } else if (run.subscript) { + options.subScript = true; + } if (run.color) { options.color = run.color; } @@ -734,6 +741,11 @@ function cssFontFamilyStyleValue(style: string) { return normalizedFontFamily(firstFamily); } +function cssVerticalAlignValue(style: string) { + const raw = /(?:^|;)\s*vertical-align\s*:\s*([^;]+)/i.exec(style)?.[1]?.trim().toLowerCase() ?? ""; + return ["sub", "super"].includes(raw) ? raw : ""; +} + function normalizedCssColor(value: string) { const raw = value.trim().toLowerCase(); if (!raw || ["transparent", "inherit", "initial", "currentcolor", "auto"].includes(raw)) { @@ -1326,7 +1338,10 @@ function docxRunToHtml(run: unknown, imageDataByRelationshipId: DocxImageDataByR const fontSize = docxRunFontSize(properties); const fontFamily = docxRunFontFamily(properties); const hasStrike = hasDocxBoolean(properties, "w:strike") || hasDocxBoolean(properties, "w:dstrike"); - const hasInlineColorOrHighlight = Boolean(color || highlightColor || fontSize || fontFamily || hasStrike); + const verticalAlign = docxRunVerticalAlign(properties); + const hasSubscript = verticalAlign === "subscript"; + const hasSuperscript = verticalAlign === "superscript"; + const hasInlineColorOrHighlight = Boolean(color || highlightColor || fontSize || fontFamily || hasStrike || hasSubscript || hasSuperscript); const hasLineBreak = text.includes("\n"); const hasPageBreak = text.includes(pageBreakMarker); const hasTab = text.includes("\t"); @@ -1360,6 +1375,11 @@ function docxRunToHtml(run: unknown, imageDataByRelationshipId: DocxImageDataByR if (styles.length > 0) { html = `${html}`; } + if (hasSubscript) { + html = `${html}`; + } else if (hasSuperscript) { + html = `${html}`; + } } return { html: `${imageHtml}${text ? html : ""}`, hasInlineColorOrHighlight, hasImage: Boolean(imageHtml), hasLineBreak, hasPageBreak, hasTab }; @@ -1530,6 +1550,10 @@ function docxRunFontFamily(properties: XmlRecord) { ); } +function docxRunVerticalAlign(properties: XmlRecord) { + return docxAttribute(childRecord(properties, "w:vertAlign"), "w:val").trim().toLowerCase(); +} + function normalizedDocxHexColor(value: string) { const normalized = value.trim().toUpperCase(); if (!normalized || normalized === "AUTO" || normalized === "NONE") { @@ -1653,12 +1677,19 @@ function formatForElement(element: Element, inherited: InlineFormat): InlineForm cssColorValue(style, "background-color") || cssColorValue(style, "background") || inherited.highlightColor; const fontSize = cssFontSizeValue(style) ?? inherited.fontSize; const fontFamily = cssFontFamilyStyleValue(style) || inherited.fontFamily; + const verticalAlign = cssVerticalAlignValue(style); + const isSubscript = tagName === "sub" || verticalAlign === "sub"; + const isSuperscript = tagName === "sup" || verticalAlign === "super"; + const subscript = isSubscript ? true : isSuperscript ? false : inherited.subscript; + const superscript = isSuperscript ? true : isSubscript ? false : inherited.superscript; return cleanInlineFormat({ bold: inherited.bold || tagName === "b" || tagName === "strong" || /font-weight\s*:\s*(bold|[6-9]00)\b/i.test(style), italics: inherited.italics || tagName === "i" || tagName === "em" || /font-style\s*:\s*italic\b/i.test(style), underline: inherited.underline || tagName === "u" || /text-decoration(?:-line)?\s*:[^;]*underline/i.test(style), strike: inherited.strike || tagName === "s" || tagName === "strike" || tagName === "del" || /text-decoration(?:-line)?\s*:[^;]*line-through/i.test(style), + ...(subscript ? { subscript } : {}), + ...(superscript ? { superscript } : {}), ...(href ? { href } : {}), ...(color ? { color } : {}), ...(highlightColor ? { highlightColor } : {}), @@ -1700,6 +1731,8 @@ function sameInlineFormat(first: InlineFormat, second: InlineFormat) { Boolean(first.italics) === Boolean(second.italics) && Boolean(first.underline) === Boolean(second.underline) && Boolean(first.strike) === Boolean(second.strike) && + Boolean(first.subscript) === Boolean(second.subscript) && + Boolean(first.superscript) === Boolean(second.superscript) && (first.href ?? "") === (second.href ?? "") && (first.color ?? "") === (second.color ?? "") && (first.highlightColor ?? "") === (second.highlightColor ?? "") && @@ -1714,6 +1747,7 @@ function cleanInlineFormat(format: InlineFormat): InlineFormat { ...(format.italics ? { italics: true } : {}), ...(format.underline ? { underline: true } : {}), ...(format.strike ? { strike: true } : {}), + ...(format.superscript ? { superscript: true } : format.subscript ? { subscript: true } : {}), ...(format.href ? { href: format.href } : {}), ...(format.color ? { color: format.color } : {}), ...(format.highlightColor ? { highlightColor: format.highlightColor } : {}), diff --git a/src/io/wordOfficeImport.test.ts b/src/io/wordOfficeImport.test.ts index d66f13c..757c016 100644 --- a/src/io/wordOfficeImport.test.ts +++ b/src/io/wordOfficeImport.test.ts @@ -128,6 +128,29 @@ describe("wordOffice DOCX import", () => { ]); }); + it("imports DOCX subscript and superscript from OOXML", async () => { + const blob = await exportDocxBlob("Indexes.docx", "

H2O m2

"); + const file = new File([blob], "Indexes.docx", { + type: "application/vnd.openxmlformats-officedocument.wordprocessingml.document" + }); + const imported = await importDocxFile(file); + + expect(imported.html).toContain("2"); + expect(imported.html).toContain("2"); + expect(htmlToWordBlocks(imported.html)).toEqual([ + { + type: "paragraph", + text: "H2O m2", + runs: [ + { text: "H" }, + { text: "2", subscript: true }, + { text: "O m" }, + { text: "2", superscript: true } + ] + } + ]); + }); + it("imports DOCX line breaks from OOXML", async () => { const blob = await exportDocxBlob("LineBreak.docx", "

Line 1
Line 2

"); const file = new File([blob], "LineBreak.docx", {