Skip to content

Contact card

How to reach someone by kind, as links or labeled phone numbers, in cards or plain.

<div class="cap-contact-grid" id="cc-cards">
  <div class="cap-card cap-contact-card">
    <h3 class="cap-contact-card-title">Email</h3>
    <p class="cap-contact-text">Editing, courses and workshops:</p>
    <ul class="cap-contact-ways"><li><a class="cap-contact-way" href="mailto:hello@example.com">hello@example.com</a></li></ul>
  </div>
  <div class="cap-card cap-contact-card">
    <h3 class="cap-contact-card-title">Telephone</h3>
    <dl class="cap-contact-lines">
      <div><dt>Editing</dt><dd><a href="tel:+1-555-010-0100">555-010-0100</a> <span>or</span> <a href="tel:+1-555-010-0101">555-010-0101</a></dd></div>
      <div><dt>Accounts</dt><dd><a href="tel:+1-555-010-0102">555-010-0102</a></dd></div>
    </dl>
  </div>
  <div class="cap-card cap-contact-card">
    <h3 class="cap-contact-card-title">Office</h3>
    <address class="cap-contact-address"><span>Example Co</span><span>1 Example Way</span><span>Springfield, TX 75000</span></address>
  </div>
</div>

Installation

// package.json: "capsomer": "github:DrDustinEdwards/capsomer#v0.152.2"
import "capsomer/tokens.css";
import "capsomer/base.css";
import "capsomer/contact-card.css";

Usage

<!-- Each card is a .cap-card (needs card.css); .cap-contact-card beside it is the plain variant's hook. -->
<div class="cap-contact-grid">                 <!-- data-variant="plain" -->
  <div class="cap-card cap-contact-card">
    <h3 class="cap-contact-card-title">Telephone</h3>
    <dl class="cap-contact-lines">
      <div><dt>Editing</dt><dd><a href="tel:+1-555-010-0100">555-010-0100</a> <span>or</span> <a href="tel:+1-555-010-0101">555-010-0101</a></dd></div>
    </dl>
  </div>
  <div class="cap-card cap-contact-card">
    <h3 class="cap-contact-card-title">Email</h3>
    <ul class="cap-contact-ways" data-columns="1">   <!-- data-columns optional -->
      <li><a class="cap-contact-way" href="mailto:hello@example.com">hello@example.com<span aria-hidden="true"><svg>...</svg></span></a></li>
    </ul>
    <address class="cap-contact-address"><span>1 Example Way</span><span>Springfield, TX 75000</span></address>
  </div>
</div>

Examples

Plain, with a rule between

<div class="cap-contact-grid" data-variant="plain" id="cc-plain">
  <div class="cap-card cap-contact-card">
    <h3 class="cap-contact-card-title">Contact</h3>
    <ul class="cap-contact-ways">
      <li><a class="cap-contact-way" href="mailto:alex@example.com">alex@example.com</a></li>
      <li><a class="cap-contact-way" href="https://example.org/alex">Profile</a></li>
    </ul>
    <a class="cap-contact-address" href="https://example.org/map"><span>Example Library</span><span>1 Example Way</span></a>
  </div>
  <div class="cap-card cap-contact-card">
    <h3 class="cap-contact-card-title">The board</h3>
    <ul class="cap-contact-ways" data-columns="1" id="cc-one-column">
      <li><a class="cap-contact-way" href="https://example.org/agendas">Agendas<span aria-hidden="true"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M5 12h14M13 6l6 6-6 6"/></svg></span></a></li>
      <li><a class="cap-contact-way" href="https://example.org/minutes">Minutes<span aria-hidden="true"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M5 12h14M13 6l6 6-6 6"/></svg></span></a></li>
      <li><a class="cap-contact-way" href="https://example.org/calendar">Calendar<span aria-hidden="true"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M5 12h14M13 6l6 6-6 6"/></svg></span></a></li>
    </ul>
  </div>
</div>

API reference

ContactCard

PropTypeRequiredDoes
titleReactNodeYes
headingLevel"h2" | "h3" | "h4"
textReactNodeA sentence over the ways.
waysContactWay[]Links: an email, a profile, a booking page.
wayColumns1 | 2 | 3The ways' columns in this card. Omitted: as many as fit at 12rem.
linesContactLine[]Labeled phone numbers.
addressstring[]Address lines, linked to a map when mapHref is given.
mapHrefstring
countrystring
childrenReactNode

ContactGrid

PropTypeRequiredDoes
childrenReactNodeYes
plainboolean

CSS variables

VariableDefault
--cap-contact-address-colorvar(--muted)
--cap-contact-address-faceinherit
--cap-contact-address-sizeinherit
--cap-contact-card-min16rem
--cap-contact-card-title-casenone
--cap-contact-card-title-colorvar(--text)
--cap-contact-card-title-facevar(--display)
--cap-contact-card-title-sizevar(--fs-h3)
--cap-contact-card-title-trackingnormal
--cap-contact-card-title-weightvar(--weight-heading)
--cap-contact-way-colorvar(--accent-text)
--cap-contact-way-faceinherit
--cap-contact-way-min12rem
--cap-contact-way-sizeinherit

Parts and data attributes

ClassIs
.cap-contact-addressits own class
.cap-contact-cardthe root
.cap-contact-card-titlea part
.cap-contact-gridits own class
.cap-contact-linesits own class
.cap-contact-textits own class
.cap-contact-wayits own class
.cap-contact-waysits own class
AttributeValues
data-columns1 2 3
data-variantplain
StateRead from
:hoverthe platform

Accessibility

KeyDoes
TabMoves through the links in reading order
  • An address with no map is an address element; one with a map is a link whose name is the address.
  • Icons are decoration; the link's words name it.