CtaSection
CtaSectionThe next step Close a section with a clear next step, an optional secondary route and concise supporting context.
Landing & pricingPrimary and secondary destinations
Both actions are real links. A button appears only when its label and destination are supplied.
CtaSection brings a message and its next step together in one surface. The primary link leads; the secondary link offers a quieter alternative. Actions follow the copy in narrow containers and sit beside it when there is room. Use meta for a short reassurance below the description.
Bring your next idea to life.
Start with a few well-made pieces. Shape them into an experience that feels like yours.
A clear heading, one prominent action, and a quieter alternative.
<CtaSection
eyebrow="YOUR NEXT CHAPTER"
title="Bring your next idea to life."
subtitle="Start with a few well-made pieces. Shape them into an experience that feels like yours."
primaryLabel="Explore components"
primaryHref="/components/"
primaryIcon="lucide:arrow-right"
secondaryLabel="Read the guides"
secondaryHref="/guides/"
meta="Every example includes source you can build on."
tone="accent"
variant="spotlight"/> Add a custom action
The actions slot follows the built-in links.
Choose a layout
Match the structure to your content.
<CtaSection
title="Choose a layout"
subtitle="Match the structure to your content."
variant="surface"
>
<template #actions>
<BtnLink href="/components/layout/flex/" variant="surface">One axis</BtnLink>
<BtnLink href="/components/layout/grid/" tone="accent">Two axes</BtnLink>
</template>
</CtaSection> All ten semantic tones
The same composition in every semantic tone. Child tones are explicit where the composition owns them, including navigation actions.
neutral Make it yours
Start with a useful pattern.
accent Make it yours
Start with a useful pattern.
feature Make it yours
Start with a useful pattern.
secondary Make it yours
Start with a useful pattern.
custom Make it yours
Start with a useful pattern.
ghost Make it yours
Start with a useful pattern.
info Make it yours
Start with a useful pattern.
success Make it yours
Start with a useful pattern.
warning Make it yours
Start with a useful pattern.
danger Make it yours
Start with a useful pattern.
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 Make it yours
Start with a useful pattern.
surfaceAlt Make it yours
Start with a useful pattern.
spotlight Make it yours
Start with a useful pattern.
glass Make it yours
Start with a useful pattern.
flat Make it yours
Start with a useful pattern.
flatAlt Make it yours
Start with a useful pattern.
flatSolid outlineFill outline Make it yours
Start with a useful pattern.
subtle Make it yours
Start with a useful pattern.
subtleBtn Make it yours
Start with a useful pattern.
link Make it yours
Start with a useful pattern.
sheen underline Make it yours
Start with a useful pattern.
rail bracket Make it yours
Start with a useful pattern.
none Make it yours
Start with a useful pattern.
Switch the site theme to compare the same samples in both palettes.
Every action arrangement
Primary onlyStart building
Secondary onlyKeep exploring
Both destinationsFind your pattern
Explore by the work you need to do.
Custom actionsChoose a starting point
Copy without navigationA clear invitation
Add destinations when they are ready.
Built-in links require both a label and href. The actions slot renders independently; meta supplies supporting copy.
Feature map
| Public feature | Visible example |
|---|---|
| tone, variant | Complete galleries above, with all supported values visible together. |
| eyebrow, title, subtitle, meta | Both destinations shows the full message; copy without navigation omits the optional actions. |
| primaryLabel, primaryHref, primaryIcon | Primary only shows a real destination and an icon at the end. Both label and href are required. |
| secondaryLabel, secondaryHref, secondaryIcon | Secondary only shows the quieter alternative with an icon. Both label and href are required. |
| actions slot | Custom actions adds a guide link and status badge independently of built-in destinations. |
| Native attributes and events | Pass attributes through the root; keyboard behavior belongs to the composed native controls. |
This component exposes tone and variant, but no variantMode. Style individual child components explicitly when their appearance should match.
Behavior and accessibility
The title is h2. Use specific action labels that describe the destination. Primary and secondary actions are BtnLink components, so navigation retains native link behavior.
API reference
CtaSection 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.
eyebrow
RefOrValue<string> - Default
not set
Short context above the heading, such as a category or release label.
title
RefOrValue<string> - Default
not set
Visible heading. Choose a short title that identifies the content or task.
subtitle
RefOrValue<string> - Default
not set
Supporting text beneath the title.
primaryLabel
RefOrValue<string> - Default
not set
Visible primary link text. Requires the matching Href prop.
primaryHref
RefOrValue<string> - Default
not set
Primary link destination. Requires the matching Label prop.
primaryIcon
RefOrValue<string> - Default
not set
Registered SVG icon for the primary link.
secondaryLabel
RefOrValue<string> - Default
not set
Visible secondary link text. Requires the matching Href prop.
secondaryHref
RefOrValue<string> - Default
not set
Secondary link destination. Requires the matching Label prop.
secondaryIcon
RefOrValue<string> - Default
not set
Registered SVG icon for the secondary link.
meta
RefOrValue<string> - Default
not set
Secondary context such as an update time, limitation or reassurance.
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
surface
Visual treatment. Accepts solid, surface, surfaceAlt, spotlight, glass, flat, flatAlt, flatSolid, outlineFill, outline, subtle, subtleBtn, link, sheen, underline, rail, bracket or none.
Composition
actions slot: additional actions. There is no default content slot. Register defineCtaSectionComponent with Panel, Grid, SectionHeader, Flex and BtnLink dependencies.