Skip to main content

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-label naming 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​

PropTypeDefaultDescription
itemsarray-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_labelsboolean-When true, shows text labels alongside icons.
classesarray-Additional CSS class words merged into the root element.
attributesobject-Additional HTML attributes spread on the root element.

Classes​

ClassCapabilityDefaultDescription
.subtleEmphasis-Lower emphasis; a muted, quieter weight.
.neutralEmphasisYesDefault emphasis; the standard weight at balanced contrast.
.accentEmphasis-Higher emphasis; a stronger, louder weight.
.solidFill-Filled surface; background and border rendered.
.outlineFill-Bordered surface; transparent background.
.ghostFill-No surface; text or icon only.
.smSize-Small.
.mdSizeYesMedium.
.lgSize-Large.
.roundedShape-Rounded corners.
.squareShape-Sharp corners.
.circleShape-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 or aria-label is present
  • External links use rel="noopener noreferrer"
  • Visible :focus-visible outline on each link

Dependencies​

  • icon - supplies the SVG icons (inline or sprite-based)
  • icon - shared icon rendering
  • footer - common placement location