diff --git a/README.md b/README.md index 096ff40..c79e3a5 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:spacing` `before`/`after`, переносы строк, разрывы страниц, табуляцию, закладки, внешние и внутренние гиперссылки-якоря, маркированные и нумерованные списки через `w:numPr`/`numbering.xml`, простые таблицы, базовые растровые изображения, явные цвета текста, подсветку, размер и семейство шрифта из OOXML, нижний и верхний индекс через `w:vertAlign`, а при экспорте DOCX сохраняются заголовки HTML `h1`–`h6`, цитаты HTML `blockquote` как стиль Word `Quote`, абзацы, переносы строк, разрывы страниц, табуляция, выравнивание, отступы абзацев из HTML `margin-left`/`text-indent` и интервалы из HTML `margin-top`/`margin-bottom`, закладки из HTML `id`, списки, простые таблицы, внешние и внутренние гиперссылки-якоря, базовые растровые изображения и базовое inline-форматирование текста: полужирный, курсив, подчеркивание, зачеркивание, нижний и верхний индекс, цвет текста, подсветка, размер и семейство шрифта. +- QWord открывает `.docx` и сохраняет `.docx`; при импорте базовых DOCX-абзацев читает заголовки Word `Heading 1`–`Heading 6`, стиль Word `Quote` как HTML `blockquote`, выравнивание, отступы `w:ind`, интервалы абзацев `w:spacing` `before`/`after` и межстрочный интервал `w:spacing` `line`/`lineRule`, переносы строк, разрывы страниц, табуляцию, закладки, внешние и внутренние гиперссылки-якоря, маркированные и нумерованные списки через `w:numPr`/`numbering.xml`, простые таблицы, базовые растровые изображения, явные цвета текста, подсветку, размер и семейство шрифта из OOXML, нижний и верхний индекс через `w:vertAlign`, а при экспорте DOCX сохраняются заголовки HTML `h1`–`h6`, цитаты HTML `blockquote` как стиль Word `Quote`, абзацы, переносы строк, разрывы страниц, табуляция, выравнивание, отступы абзацев из HTML `margin-left`/`text-indent`, интервалы из HTML `margin-top`/`margin-bottom` и межстрочный интервал из HTML `line-height`, закладки из 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 слайда, сохраняет скрытые слайды, переходы слайдов, заметки докладчика, внешние ссылки текста заголовка/подзаголовка и изображений, базовые растровые изображения слайдов, пользовательский цвет фона слайда, списки подзаголовка, а также цвет, размер, семейство шрифта, начертание `b`/`i`/`u`/`strike` и выравнивание `a:pPr algn` текста заголовка/подзаголовка. - 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` и `w:vertAlign` для переносов строк/разрывов страниц/табуляции/цвета/подсветки/размера/семейства/зачеркивания/нижнего и верхнего индекса текста DOCX, выравнивание, отступы и интервалы абзацев DOCX через `w:jc`/`w:ind`/`w:spacing`, закладки 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, цвет, размер, семейство шрифта, начертание `b`/`i`/`u`/`strike` и выравнивание `a:pPr algn` текста заголовка/подзаголовка 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`/`w:spacing`, включая `line`/`lineRule`, закладки 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, цвет, размер, семейство шрифта, начертание `b`/`i`/`u`/`strike` и выравнивание `a:pPr algn` текста заголовка/подзаголовка 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 6c85c62..f8eb518 100644 --- a/src/io/wordOffice.test.ts +++ b/src/io/wordOffice.test.ts @@ -477,6 +477,18 @@ describe("wordOffice helpers", () => { ]); }); + it("сохраняет HTML-межстрочный интервал абзацев для DOCX", () => { + const blocks = htmlToWordBlocks(` +

Auto line height

+

Exact line height

+ `); + + expect(blocks).toEqual([ + { type: "paragraph", text: "Auto line height", runs: [{ text: "Auto line height" }], spacing: { line: 360, lineRule: "auto" } }, + { type: "paragraph", text: "Exact line height", runs: [{ text: "Exact line height" }], spacing: { line: 480, lineRule: "exact" } } + ]); + }); + it("записывает отступы абзацев в w:ind экспортированного DOCX", async () => { const blob = await exportDocxBlob( "Indent.docx", @@ -501,6 +513,18 @@ describe("wordOffice helpers", () => { expect(documentXml).toMatch(/]*w:before="240")(?=[^>]*w:after="360")[^>]*\/>/); }); + it("записывает межстрочный интервал абзацев в w:spacing экспортированного DOCX", async () => { + const blob = await exportDocxBlob( + "LineSpacing.docx", + '

Auto line height

Exact line height

' + ); + const zip = await JSZip.loadAsync(await blob.arrayBuffer()); + const documentXml = await zip.file("word/document.xml")?.async("string"); + + expect(documentXml).toMatch(/]*w:line="360")(?=[^>]*w:lineRule="auto")[^>]*\/>/); + expect(documentXml).toMatch(/]*w:line="480")(?=[^>]*w:lineRule="exact")[^>]*\/>/); + }); + it("нормализует HTML после импорта DOCX", () => { expect(normalizeImportedDocxHtml("

Готово

\n")).toBe("

Готово

"); }); diff --git a/src/io/wordOffice.ts b/src/io/wordOffice.ts index 9478a9a..db9b92e 100644 --- a/src/io/wordOffice.ts +++ b/src/io/wordOffice.ts @@ -44,8 +44,12 @@ export interface WordParagraphIndent { export interface WordParagraphSpacing { before?: number; after?: number; + line?: number; + lineRule?: WordParagraphLineRule; } +export type WordParagraphLineRule = "auto" | "exact" | "atLeast"; + export type WordHeadingLevel = 1 | 2 | 3 | 4 | 5 | 6; export type WordBlock = @@ -109,6 +113,7 @@ type DocxModule = { AlignmentType?: Record; Document: new (options: Record) => unknown; HeadingLevel: Record; + LineRuleType?: Record; Packer: { toBlob?: (document: unknown) => Promise; toBuffer?: (document: unknown) => Promise; @@ -556,19 +561,27 @@ function docxParagraphSpacing(spacing: WordParagraphSpacing | undefined, default const normalized = normalizedParagraphSpacing(spacing); return { after: normalized.after ?? defaultAfter, - ...(normalized.before ? { before: normalized.before } : {}) + ...(normalized.before ? { before: normalized.before } : {}), + ...(normalized.line ? { line: normalized.line, lineRule: normalized.lineRule } : {}) }; } function normalizedParagraphSpacing(spacing: WordParagraphSpacing | undefined) { const before = normalizedTwips(spacing?.before); const after = normalizedTwips(spacing?.after); + const line = normalizedTwips(spacing?.line); + const lineRule = normalizedParagraphLineRule(spacing?.lineRule); return { ...(before ? { before } : {}), - ...(after !== undefined ? { after } : {}) + ...(after !== undefined ? { after } : {}), + ...(line ? { line, lineRule } : {}) }; } +function normalizedParagraphLineRule(lineRule: WordParagraphLineRule | undefined) { + return lineRule === "exact" || lineRule === "atLeast" ? lineRule : "auto"; +} + function normalizedParagraphIndent(indent: WordParagraphIndent | undefined) { const left = normalizedTwips(indent?.left); const firstLine = normalizedTwips(indent?.firstLine); @@ -716,9 +729,11 @@ function paragraphSpacingFromElement(element: Element): WordParagraphSpacing | u const style = element.getAttribute("style") ?? ""; const before = cssTwipsValue(style, "margin-top"); const after = cssTwipsValue(style, "margin-bottom"); + const lineHeight = cssLineHeightValue(style); const spacing = { ...(before && before > 0 ? { before } : {}), - ...(after && after > 0 ? { after } : {}) + ...(after && after > 0 ? { after } : {}), + ...(lineHeight ? lineHeight : {}) }; return Object.keys(spacing).length > 0 ? spacing : undefined; } @@ -736,6 +751,28 @@ function cssTwipsValue(style: string, property: "margin-left" | "margin-top" | " return cssLengthToTwips(raw); } +function cssLineHeightValue(style: string): WordParagraphSpacing | undefined { + const raw = /(?:^|;)\s*line-height\s*:\s*([^;]+)/i.exec(style)?.[1]?.trim().toLowerCase() ?? ""; + if (!raw || ["inherit", "initial", "unset", "revert", "normal"].includes(raw)) { + return undefined; + } + + const ratioMatch = /^([0-9]+(?:\.[0-9]+)?)$/.exec(raw); + if (ratioMatch) { + const ratio = Number.parseFloat(ratioMatch[1]); + return Number.isFinite(ratio) && ratio > 0 ? { line: Math.round(ratio * 240), lineRule: "auto" } : undefined; + } + + const percentMatch = /^([0-9]+(?:\.[0-9]+)?)%$/.exec(raw); + if (percentMatch) { + const ratio = Number.parseFloat(percentMatch[1]) / 100; + return Number.isFinite(ratio) && ratio > 0 ? { line: Math.round(ratio * 240), lineRule: "auto" } : undefined; + } + + const line = cssLengthToTwips(raw); + return line && line > 0 ? { line, lineRule: "exact" } : undefined; +} + function cssLengthToTwips(raw: string) { if (!raw || ["inherit", "initial", "unset", "revert", "auto"].includes(raw)) { return undefined; @@ -1148,12 +1185,32 @@ function docxParagraphSpacingStyles(properties: XmlRecord) { const spacing = childRecord(properties, "w:spacing"); const before = docxTwipsAttribute(spacing, ["w:before"]); const after = docxTwipsAttribute(spacing, ["w:after"]); + const line = docxTwipsAttribute(spacing, ["w:line"]); + const lineRule = docxAttribute(spacing, "w:lineRule"); return [ before ? `margin-top: ${formatPointSize(before / 20)}pt;` : "", - after && after !== defaultParagraphSpacingAfterTwips ? `margin-bottom: ${formatPointSize(after / 20)}pt;` : "" + after && after !== defaultParagraphSpacingAfterTwips ? `margin-bottom: ${formatPointSize(after / 20)}pt;` : "", + docxLineHeightStyle(line, lineRule) ].filter(Boolean); } +function docxLineHeightStyle(line: number | undefined, lineRule: string) { + if (!line || line <= 0) { + return ""; + } + + const normalizedRule = lineRule.trim().toLowerCase(); + if (!normalizedRule || normalizedRule === "auto") { + return `line-height: ${formatLineHeightRatio(line / 240)};`; + } + + return `line-height: ${formatPointSize(line / 20)}pt;`; +} + +function formatLineHeightRatio(value: number) { + return Number.isInteger(value) ? String(value) : value.toFixed(2).replace(/0+$/, "").replace(/\.$/, ""); +} + function docxParagraphListInfo(properties: XmlRecord, numberingDefinitions: DocxNumberingDefinitions): DocxListInfo | undefined { const numbering = childRecord(properties, "w:numPr"); const numId = docxAttribute(childRecord(numbering, "w:numId"), "w:val"); diff --git a/src/io/wordOfficeImport.test.ts b/src/io/wordOfficeImport.test.ts index 0819908..edbacc5 100644 --- a/src/io/wordOfficeImport.test.ts +++ b/src/io/wordOfficeImport.test.ts @@ -381,4 +381,22 @@ describe("wordOffice DOCX import", () => { { type: "paragraph", text: "Paragraph spacing", runs: [{ text: "Paragraph spacing" }], spacing: { before: 240, after: 360 } } ]); }); + + it("imports DOCX paragraph line spacing from OOXML", async () => { + const blob = await exportDocxBlob( + "LineSpacing.docx", + '

Auto line height

Exact line height

' + ); + const file = new File([blob], "LineSpacing.docx", { + type: "application/vnd.openxmlformats-officedocument.wordprocessingml.document" + }); + const imported = await importDocxFile(file); + + expect(imported.html).toContain("line-height: 1.5;"); + expect(imported.html).toContain("line-height: 24pt;"); + expect(htmlToWordBlocks(imported.html)).toEqual([ + { type: "paragraph", text: "Auto line height", runs: [{ text: "Auto line height" }], spacing: { line: 360, lineRule: "auto" } }, + { type: "paragraph", text: "Exact line height", runs: [{ text: "Exact line height" }], spacing: { line: 480, lineRule: "exact" } } + ]); + }); });