PageScope
Receiver of page { ... }.
The page body is implicitly a vertical column: content added via text, column, row, spacer, image, or weighted stacks top-to-bottom. Nest an explicit row for horizontal sections.
Properties on this scope control the page-level frame: physical size, padding inset around the content area, spacing between children, cross-axis horizontalAlignment, main-axis verticalArrangement, and the pageBreakStrategy used when content overflows. Each defaults to a value inherited from the enclosing DocumentScope — override here for a single page or there for the whole document.
Properties
Cross-axis alignment for children that are narrower than the page content area. Defaults to HorizontalAlignment.Start; switch to HorizontalAlignment.Center for centred prose layouts.
Page margins applied as an inset inside the page bounds. Defaults to the document-wide value supplied by DocumentScope.defaultPagePadding.
Strategy used when a child does not fit in the remaining vertical space. See PageBreakStrategy for the trade-offs.
How the top-level children are distributed along the page's vertical axis. Defaults to VerticalArrangement.Top; pick a Space* value to spread content across the page height.
Functions
Registers a named jump target at this position. Pair with linkToAnchor to build clickable cross-references ("see chapter 3") and tables of contents.
Appends a Z-stacking container. Children stack along the depth axis: the first added is at the bottom, the last on top. Use this for image overlays, badges, or any composition where children share the same X/Y space.
Appends a vertical bulleted list — one row per item, each consisting of a bullet marker and the item text on the same line. Wrapping text in an item indents continuation lines under the first text line, not under the bullet, which matches the typical typographic convention for prose lists.
Appends a vertical container that stacks its children top-to-bottom.
Appends a donut chart — a pie with a circular hole punched in the centre.
Configures a footer rendered at the bottom of every physical page. Mirror of header; the same PageContext semantics apply.
Appends a free-form vector drawing authored in a local coordinate space of (0, 0)–(width, height) and scaled into the node's final rectangle. Use it for diagrams, decorations, or any shape the primitive nodes don't cover — everything stays sharp vector output.
Configures a header rendered at the top of every physical page produced by this logical page. The block is invoked once per physical page with a PageContext carrying the current page number and the total page count, so callers can build dynamic content like Page X of Y.
Appends an image rendered at its intrinsic pixel dimensions, mapped 1px → 1pt. Useful when the source asset is already sized for print.
Appends an image whose width is given and whose height is derived from the intrinsic aspect ratio (sniffed from the PNG/JPEG header).
Appends an image node with explicit dimensions.
Wraps the children added in block in a group the page-break machinery never splits: under the Slice strategy the group moves to a fresh page whole instead of being cut mid-content — the break-inside: avoid of this DSL. Use it for figures with their captions, stat cards, or any cluster where a page break in the middle would read as a bug.
Appends a multi-series line chart.
Appends a line chart.
Appends a numbered list — same shape as bulletList but with "1.", "2.", … markers. Use startAt when the list logically continues from another series (e.g. step 4 of a tutorial that already showed steps 1–3 elsewhere).
Appends a pie chart.
Appends a QR code symbol encoding data in byte mode (UTF-8). The symbol is drawn as crisp vector squares, so it scans reliably at any print size, and the smallest QR version that fits the payload at the requested errorCorrection level is selected automatically.
Appends a multi-style paragraph. Lets a single paragraph mix bold, italic, coloured, or otherwise differently styled segments without splitting into separate text blocks.
Appends a horizontal container that lays its children left-to-right.
Appends a stacked bar chart.
Appends a tabular layout with the given columns and arbitrary rows.
Appends an automatically generated table of contents.
Appends a vector icon previously parsed with VectorImage.parse.
Convenience overload that parses xml on the fly and embeds the resulting vector. Prefer the VectorImage overload when the same icon is reused several times — parsing is not free.