Appearance
Block Attributes
All attributes available on block-level elements (frame, page, table, td, th, etc.).
Sizing
| Attribute | Type | Default | Description |
|---|---|---|---|
width | pt, cm, %, fill, auto | auto | Element width |
height | pt, cm, %, fill, auto | auto | Element height |
min-width | pt, cm, % | -- | Minimum width constraint |
max-width | pt, cm, % | -- | Maximum width constraint |
min-height | pt, cm, % | -- | Minimum height constraint |
max-height | pt, cm, % | -- | Maximum height constraint |
Layout
| Attribute | Type | Default | Description |
|---|---|---|---|
direction | column, col, row | column | Child stacking direction |
h-align | left, center, right | left | Horizontal alignment of content |
v-align | top, center, bottom | top | Vertical alignment of content |
text-align | left, right, center, justify | left | Text alignment within element |
Spacing
| Attribute | Type | Default | Description |
|---|---|---|---|
padding | pt, cm | 0 | Padding on all sides |
padding-top | pt, cm | 0 | Top padding |
padding-bottom | pt, cm | 0 | Bottom padding |
padding-left | pt, cm | 0 | Left padding |
padding-right | pt, cm | 0 | Right padding |
space-before-desired | pt, cm | 0 | Desired space above (compressed at page boundaries) |
space-after-desired | pt, cm | 0 | Desired space below (compressed at page boundaries) |
Positioning
| Attribute | Type | Default | Description |
|---|---|---|---|
top | pt, cm | -- | Absolute offset from parent top |
bottom | pt, cm | -- | Absolute offset from parent bottom |
left | pt, cm | -- | Absolute offset from parent left |
right | pt, cm | -- | Absolute offset from parent right |
Borders
| Attribute | Type | Default | Description |
|---|---|---|---|
border-weight | pt | 0 | Border width on all sides |
border-weight-top | pt | -- | Top border width |
border-weight-bottom | pt | -- | Bottom border width |
border-weight-left | pt | -- | Left border width |
border-weight-right | pt | -- | Right border width |
border-color | colour | -- | Border colour on all sides |
border-color-top | colour | -- | Top border colour |
border-color-bottom | colour | -- | Bottom border colour |
border-color-left | colour | -- | Left border colour |
border-color-right | colour | -- | Right border colour |
border-radius | pt | 0 | Corner radius on all corners |
border-radius-t | pt | -- | Top-left and top-right radius |
border-radius-b | pt | -- | Bottom-left and bottom-right radius |
border-radius-l | pt | -- | Top-left and bottom-left radius |
border-radius-r | pt | -- | Top-right and bottom-right radius |
border-radius-tl | pt | -- | Top-left corner radius |
border-radius-tr | pt | -- | Top-right corner radius |
border-radius-bl | pt | -- | Bottom-left corner radius |
border-radius-br | pt | -- | Bottom-right corner radius |
Appearance
| Attribute | Type | Default | Description |
|---|---|---|---|
background-color | colour | -- | Background fill colour |
rotation | 90, 180, 270 | -- | Clockwise rotation in degrees |
page-rotation | 0, 90, 180, 270 | -- | Requests that the containing page be rendered rotated clockwise by this many degrees. Set on any descendant — Papermill rotates the whole page at emission. See Page rotation. |
Breaking
| Attribute | Type | Default | Description |
|---|---|---|---|
break | auto, never | auto | Page breaking behaviour |
break-before | auto, frame | auto | Force a frame break before this element |
prevent-last | true, false | false | Prevent item being last in frame, breaking to next |
orphan-lines-threshold | number | -- | Minimum lines before allowing a break |
Text
| Attribute | Type | Default | Description |
|---|---|---|---|
text-transform | uppercase, lowercase, capitalize, upper, lower, title | -- | Text case transformation (inherited by children) |
case | Alias for text-transform | -- | Text case transformation (inherited by children) |
Conditional and Identity
| Attribute | Type | Default | Description |
|---|---|---|---|
show-if | data path | -- | Render only when condition is truthy |
id | string | -- | Unique element identifier |
target | string | -- | Link to element with matching id (internal link) |
outline | string | -- | Add to named outline collection |
level | number | -- | Hierarchy level in outline |
style | @alias-name, property=value | -- | Apply a style alias |
Page-Specific
| Attribute | Type | Default | Description |
|---|---|---|---|
format | A0-A10, A0-landscape-A10-landscape | -- | Named page format |
orientation | portrait, landscape | portrait | Whether to swap page format width and height |
page-margin | pt, cm | 0 | Page margin on all sides |
page-margin-top | pt, cm | -- | Top page margin |
page-margin-bottom | pt, cm | -- | Bottom page margin |
page-margin-left | pt, cm | -- | Left page margin |
page-margin-right | pt, cm | -- | Right page margin |
repeat | true, false | false | Repeat page for flow content |
flow | flow name | -- | Flow that controls page repetition |
deferred | true, false | false | Allow access to <repeat outline=""> |
name | data expression | -- | Dynamic page type selection |
Table-Specific
| Attribute | Type | Default | Description |
|---|---|---|---|
colspan | number | 1 | Number of columns a cell spans (on td/th) |
Page rotation
page-rotation is a per-element attribute that requests the whole page containing the element be rendered rotated by the given number of degrees clockwise. Allowed values are 0, 90, 180, 270; 0 is the same as omitting the attribute.
Unlike rotation, which rotates an element within its frame, page-rotation does not affect how the page is laid out — content fits the same way it would on a non-rotated page, and the document outline, page numbers, and cross-references continue to point at the same logical page. The rotation is a property of the rendered page.
press
<styles>
<alias name="wide-tables">
<padding>6pt</padding>
<child name="table" apply-if="breaks('width')">
<rotation>270</rotation>
<page-rotation>90</page-rotation>
</child>
<child name="table">
<width>100%</width>
<font-size>8pt</font-size>
</child>
</alias>
</styles>In this example a wide table that doesn't fit the page width is rotated 270° so it lays out vertically in the available column, and the whole page is rotated 90° so the upright table reads the right way up on the rendered landscape page. The two attributes compose: rotation makes a single element fit; page-rotation makes the page read the right way up.
Precedence
If more than one element on the same page requests a page-rotation, every non-zero request must agree. Conflicting values (e.g. one element asking for 90 while another asks for 270) are an authoring error — Papermill rejects the document with message Conflicting <page-rotation> values on the same page listing the conflicting source locations. This avoids "first wins" / "last wins" becoming a non-local surprise where reordering unrelated content changes the rendered orientation.
Composition
page-rotation is not inherited through component composition: a component that sets page-rotation internally does not pass the request to siblings outside the component unless they happen to live on the same page.