LandingBand
LandingBandShaped backdrop A full-width visual band with shaped edges, background imagery and theme-aware surfaces.
Landing & pricingA shaped section boundary
The bottom edge creates a transition into the next section. Keep the important copy away from the clipped edge.
Compare the composition, then open its source tab to adapt it.
<LandingBand
tone="accent"
height="14rem"
bottomEdge="slant-up"
edgeSize="2rem"
alignItems="center"
>
<SectionHeader
eyebrow="BUILD WITH PURESTACK"
title="One coherent interface"
subtitle="Content, components and a shared theme."
/>
</LandingBand> Two deliberate edges
Each edge has an independent direction and starting position.
<LandingBand
tone="info"
variant="surface"
topEdge="slant-down"
bottomEdge="slant-down"
edgeSize="1.5rem"
topEdgeStart="20%"
bottomEdgeStart="40%"
paddingTop="2rem"
paddingBottom="2rem"
>
<SectionHeader
title="Space for a new chapter"
subtitle="A visual pause between sections."
/>
</LandingBand> All ten semantic tones
The same composition in every semantic tone. Child tones are explicit where the composition owns them, including navigation actions.
neutral accent feature secondary custom ghost info success warning danger Switch the site theme to compare the same samples in both palettes.
All eighteen visual variants
Every supported variant is shown in accent, including none. Variant controls the outer treatment; nested content may use its own treatment.
solid surface surfaceAlt spotlight glass flat flatAlt flatSolid outlineFill outline subtle subtleBtn link sheen underline rail bracket none Switch the site theme to compare the same samples in both palettes.
Both variant modes
Hover these outlineFill examples to compare stateless and stateful treatments. Stateful styling adds interaction states; it does not turn a container into a button.
stateless stateful Switch the site theme to compare the same samples in both palettes.
Every edge combination
The top and bottom edges independently accept flat, slant-up, or slant-down. These nine miniatures keep every combination in view. Gallery bands are contained for comparison; the original examples above retain viewport bleed.
flat / flat flat / slant-up flat / slant-down slant-up / flat slant-up / slant-up slant-up / slant-down slant-down / flat slant-down / slant-up slant-down / slant-down edgeSize controls depth; topEdgeStart and bottomEdgeStart move the start of each slope.
Every image fit
The same small SVG background compares cover and contain with the browser behavior of fill, none, and scale-down. This is a decorative background; put meaningful imagery in an accessible image element.
cover contain fill none scale-down Each frame is 9rem high with centered imagery. CSS background-size receives imageFit directly: fill, none, and scale-down are not standard background-size keywords, so the browser ignores them. Use cover, contain, or a valid CSS size for predictable results.
Position, spacing, and flow
Image at the left Delayed slopes Flex end alignment Block flow and margins Bands are decorative and have pointer-events disabled. Put navigation and forms outside the band.
Feature map
| Public feature | Visible example |
|---|---|
| tone, variant, variantMode | Complete galleries above, with all supported values visible together. |
| image, imageFit, imagePosition | Every image fit and the left-aligned background sample use the same decorative SVG. |
| topEdge, bottomEdge | All nine independent edge combinations appear together. |
| edgeSize, topEdgeStart, bottomEdgeStart | Delayed slopes uses a deeper edge and different start positions. |
| height, paddingTop, paddingBottom | Compare the short miniatures with the taller, padded delayed-slope example. height is a minimum, so content can grow. |
| display, alignItems, justifyContent | Compare default flex flow, centered content, end alignment, and block flow. |
| marginTop, marginBottom | Block flow and margins adds space before and after the band. |
| Default slot | Section headers and plain text are decorative content; keep interactive controls outside the band. |
| Native attributes and events | Pass attributes through the root; keyboard behavior belongs to the composed native controls. |
Behavior and accessibility
Use backgrounds as decoration and keep meaningful image content in a normal image element with alt text. Edge clipping needs enough padding. The full-width bleed is intentional; avoid placing a band in a narrow card. Interactive children must explicitly opt back into pointer events.
API reference
LandingBand contract
Props below are the public template API. RefOrValue accepts a literal or a reactive ref; bind refs with a colon-prefixed attribute. Native attributes and events can be passed through the component root.
tone
RefOrValue<SemanticTone> - Default
inherited
Semantic intent: neutral, accent, secondary, info, success, warning, danger, feature, custom or ghost. The active skin supplies the colors.
variant
RefOrValue<ComponentVariant> - Default
surfaceAlt
Visual treatment. Accepts solid, surface, surfaceAlt, spotlight, glass, flat, flatAlt, flatSolid, outlineFill, outline, subtle, subtleBtn, link, sheen, underline, rail, bracket or none.
variantMode
RefOrValue<ComponentVariantMode> - Default
stateless
Use stateless for content surfaces; stateful enables the treatment’s hover, focus and active styles. It does not add interaction handlers.
image
RefOrValue<string> - Default
not set
Background image URL. It becomes a CSS background and has no accessible alternative text.
imageFit
RefOrValue<LandingBandImageFit> - Default
cover
Background sizing value: cover, contain, fill, none or scale-down are accepted by the type; CSS background-size reliably supports cover, contain and valid CSS sizes.
imagePosition
RefOrValue<string> - Default
center
CSS background-position value, such as center or center top.
display
RefOrValue<CSSProps['display']> - Default
flex
CSS display mode for the section.
alignItems
RefOrValue<CSSProps['alignItems']> - Default
start
CSS align-items for the band’s content.
justifyContent
RefOrValue<CSSProps['justifyContent']> - Default
center
CSS justify-content for the band’s content.
height
RefOrValue<string> - Default
16rem
CSS minimum height, not a fixed height. Content can make the band taller.
marginTop
RefOrValue<string> - Default
0
CSS top margin.
marginBottom
RefOrValue<string> - Default
0
CSS bottom margin.
paddingTop
RefOrValue<string> - Default
1em
Top padding; a slanted top edge adds edgeSize automatically.
paddingBottom
RefOrValue<string> - Default
1em
Bottom padding; a slanted bottom edge adds edgeSize automatically.
topEdge
RefOrValue<LandingBandEdge> - Default
flat
Top clipping edge: flat, slant-up or slant-down.
bottomEdge
RefOrValue<LandingBandEdge> - Default
flat
Bottom clipping edge: flat, slant-up or slant-down.
edgeSize
RefOrValue<string> - Default
4rem
Vertical depth of the slant, expressed as a CSS length.
topEdgeStart
RefOrValue<string> - Default
0%
Horizontal start of the top diagonal as a CSS length or percentage.
bottomEdgeStart
RefOrValue<string> - Default
0%
Horizontal start of the bottom diagonal as a CSS length or percentage.
Composition
Default slot: band content. Register defineLandingBandComponent. The active doc layout variables keep full-width edges aligned as sidebars open and close.