Socials
Social media link list with icon-only or icon + label items. Renders as a horizontal list of platform links with composable fill, size, shape, and emphasis values. Typically placed in the site footer, sidebar, or author bios.
Usage
When to use
- Footer social media link strip
- Author or contributor profile with platform links
- Contact page with organizational social accounts
When not to use
- Sharing the current page on social networks - use a dedicated share component instead
- A single standalone link - use a plain button or link
Do
- Give each link an accessible name - either a visible text label or an
aria-labelnaming the platform, not both - Mark decorative icons as
aria-hidden="true"when the link has an accessible label - Use
rel="noopener noreferrer"for external targets
Don't
- Use icons alone without an accessible name
- Mix social links with unrelated navigation links in the same list
API
Props
| Prop | Type | Default | Description |
|---|---|---|---|
items | array | - | Array of {url, text, icon?} social link objects. url is the destination, text is the platform name used as the accessible label, and icon is optional pre-rendered icon markup. |
has_labels | boolean | - | When true, shows text labels alongside icons. |
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. |
.solid | Fill | - | Filled surface; background and border rendered. |
.outline | Fill | - | Bordered surface; transparent background. |
.ghost | Fill | - | No surface; text or icon only. |
.sm | Size | - | Small. |
.md | Size | Yes | Medium. |
.lg | Size | - | Large. |
.rounded | Shape | - | Rounded corners. |
.square | Shape | - | Sharp corners. |
.circle | Shape | - | Perfect circle. |
Examples
Labeled
Icon + label items when the has_labels property is true.
Fills
The three surface treatments via the .solid, .outline, and .ghost values. solid paints a filled surface behind each item, outline draws the border alone, and ghost leaves the icon on its own.
Shapes
Corner geometry via the .circle, .square, and .rounded values, shown on outlined items so the corners are visible.
Sizes
Small, medium, and large icon sizes via the .sm, .md, .lg values.
Accessibility
- WCAG 2.2 AA
<ul>for the list so screen readers announce the number of items- Each link has an accessible name (visible label or
aria-label) - Icons are
aria-hidden="true"when a text label oraria-labelis present - External links use
rel="noopener noreferrer" - Visible
:focus-visibleoutline on each link
Dependencies
- icon - supplies the SVG icons (inline or sprite-based)