Footer
Site footer shell with a full-width background. It declares no slots: every layout decision lives in the consumer's composition, so drop a container and grid into the footer and assemble link columns, brand, newsletter, social, and legal content there. Header is the companion shell and works the same way, so the two share one composition vocabulary.
Usage
When to use
- Every page in the site needs a consistent footer landmark
- The footer must host multiple blocks (link columns, brand, newsletter, social, legal)
- A full-width background is required behind footer content
When not to use
- A single-line attribution strip - use a plain
<footer>with minimal content - Embedded widgets that are not site-wide
Do
- Use semantic headings inside link columns so screen reader users can jump between groups
- Label nested
<nav>elements with distinctaria-labelvalues - Maintain sufficient contrast in all background and text states
Don't
- Don't place the primary site navigation in the footer as the only navigation method
- Don't let background images reduce text contrast below AA
API
Props
| Prop | Type | Default | Description |
|---|---|---|---|
classes | array | - | Additional CSS class words merged into the root element. |
attributes | object | - | Additional HTML attributes spread on the root element. |
Classes
| Class | Capability | Default | Description |
|---|---|---|---|
.subtle | Emphasis | - | Lower emphasis; a muted, quieter weight. |
.neutral | Emphasis | Yes | Default emphasis; the standard weight at balanced contrast. |
.accent | Emphasis | - | Higher emphasis; a stronger, louder weight. |
.fluid | Layout | Yes | Full-width, no max-width. |
.contained | Layout | - | Constrained to a max-width. |
Examples
Default
Classless <footer> composed into three rows of link columns, brand, newsletter, social, and legal content.
With background image
Footer with a background image behind the composed content.
Mobile vertical
Upper-row columns stack vertically on mobile; grid from md breakpoint.
Simple
The smallest composition, a legal line and a back-to-top link on one row.
Accessibility
- WCAG 2.2 AA
<footer>provides the implicitcontentinfolandmark- Navigation groups use
<nav>with distinctaria-labelvalues (e.g. "Footer navigation", "Legal") - Link columns use semantic headings so screen reader users can navigate between groups
- Sufficient color contrast for background, text, and link states
Dependencies
- grid - inner layout of the composed rows
- container - inner content alignment
- header - companion shell at the top of the page