DOCXKIT_HEADER_FOOTER_INVALID_CONTENT: 頁首頁尾內容無效

頁首或頁尾外掛回傳了 Paragraph、Table 以外的元素。

修復步驟

1. 頁首頁尾內容回傳 Paragraph 或 Table 實例。
2. 將行內元素包裝在 Paragraph 內。

問題範例

import { TextRun } from 'docx'

// Invalid output from a plugin used in a header/footer:
const render = () => new TextRun('Header')

修復範例

import { Paragraph, TextRun } from 'docx'

// Valid output from a plugin used in a header/footer:
const render = () => new Paragraph({ children: [new TextRun('Header')] })

常見原因

• 外掛直接回傳 TextRun 或其他不支援的子元素。

診斷欄位

• code: HEADER_FOOTER_INVALID_CONTENT
• diagnosticCode: DOCXKIT_HEADER_FOOTER_INVALID_CONTENT
• name: DocxKitError
• docs: https://docx-kit.ntnyq.dev/errors/docxkit_header_footer_invalid_content/

訊息範例

Header and footer plugins must render paragraphs or tables

原始碼與相關指南

• 原始碼
• 相關指南
• 捕捉錯誤
• 全部錯誤碼