PDF Paper Formats and Orientation

The component accepts a named pdf-format string and pdf-orientation="portrait|landscape" (also p|l). Default format is a4, default orientation is portrait.

<Html2Pdf pdf-format="a3" pdf-orientation="landscape" :manual-pagination="true">
  <template #pdf-content><article>Landscape document</article></template>
</Html2Pdf>

The source normalizes A0–A10, B0–B10, C0–C10, dl, letter, government-letter, legal, junior-legal, ledger, tabloid, and credit-card. The selectable-text adapter and playground picker use these names. Small paper needs compact content; large or complex layouts still need viewer checks.

For custom dimensions, pass a numeric pair through the lower-level jsPDF options. The component's pdfFormat prop is a string, so do not bind an array to pdf-format.

<Html2Pdf
  :manual-pagination="true"
  :html-to-pdf-options="{ jsPDF: { unit: 'mm', format: [100, 180], orientation: 'portrait' } }"
>
  <template #pdf-content><article>Custom-size document</article></template>
</Html2Pdf>

When using automatic component pagination, calculate paginate-elements-by-height as the usable CSS pixel budget for the effective format, orientation, margins and header/footer heights. The playground computes this for its selected geometry. The selectable-text A3 fractional-boundary loop fix prevents a former repeated-page hang; final visual acceptance for all combinations still needs browser inspection.