Site color

Choose your site’s color palette.

Saved on this device.

LandingBand

LandingBandShaped backdrop

A full-width visual band with shaped edges, background imagery and theme-aware surfaces.

Landing & pricing

A shaped section boundary

The bottom edge creates a transition into the next section. Keep the important copy away from the clipped edge.

LandingBand in contextCOMPOSITION
BUILD WITH PURESTACK

One coherent interface

Content, components and a shared theme.

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.

Space for a new chapter

A visual pause between sections.

<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.

All ten semantic tonesCOMPOSITION

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.

All eighteen visual variantsCOMPOSITION

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.

Both variant modesCOMPOSITION

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.

Nine ways to frame a chapterCOMPOSITION
flat / flat
Next chapter
flat / slant-up
Next chapter
flat / slant-down
Next chapter
slant-up / flat
Next chapter
slant-up / slant-up
Next chapter
slant-up / slant-down
Next chapter
slant-down / flat
Next chapter
slant-down / slant-up
Next chapter
slant-down / slant-down
Next chapter

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.

Five background sizing strategiesCOMPOSITION
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

Control the backdrop geometryCOMPOSITION
Image at the left
Delayed slopes
Room around the content
Flex end alignment
Lower corner
Block flow and margins
A pause

Block content stacks naturally.

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.