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";
import "capsomer/tokens.css";
import "capsomer/contact-card.css";
import { ContactCard, ContactGrid } from "capsomer/react/contact-card";
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
| Prop | Type | Required | Does |
|---|
title | ReactNode | Yes | |
|---|
headingLevel | "h2" | "h3" | "h4" | | |
|---|
text | ReactNode | | A sentence over the ways. |
|---|
ways | ContactWay[] | | Links: an email, a profile, a booking page. |
|---|
wayColumns | 1 | 2 | 3 | | The ways' columns in this card. Omitted: as many as fit at 12rem. |
|---|
lines | ContactLine[] | | Labeled phone numbers. |
|---|
address | string[] | | Address lines, linked to a map when mapHref is given. |
|---|
mapHref | string | | |
|---|
country | string | | |
|---|
children | ReactNode | | |
|---|
| Prop | Type | Required | Does |
|---|
children | ReactNode | Yes | |
|---|
plain | boolean | | |
|---|
CSS variables
| Variable | Default |
|---|
--cap-contact-address-color | var(--muted) |
|---|
--cap-contact-address-face | inherit |
|---|
--cap-contact-address-size | inherit |
|---|
--cap-contact-card-min | 16rem |
|---|
--cap-contact-card-title-case | none |
|---|
--cap-contact-card-title-color | var(--text) |
|---|
--cap-contact-card-title-face | var(--display) |
|---|
--cap-contact-card-title-size | var(--fs-h3) |
|---|
--cap-contact-card-title-tracking | normal |
|---|
--cap-contact-card-title-weight | var(--weight-heading) |
|---|
--cap-contact-way-color | var(--accent-text) |
|---|
--cap-contact-way-face | inherit |
|---|
--cap-contact-way-min | 12rem |
|---|
--cap-contact-way-size | inherit |
|---|
Parts and data attributes
| Class | Is |
|---|
.cap-contact-address | its own class |
|---|
.cap-contact-card | the root |
|---|
.cap-contact-card-title | a part |
|---|
.cap-contact-grid | its own class |
|---|
.cap-contact-lines | its own class |
|---|
.cap-contact-text | its own class |
|---|
.cap-contact-way | its own class |
|---|
.cap-contact-ways | its own class |
|---|
| Attribute | Values |
|---|
data-columns | 1 2 3 |
|---|
data-variant | plain |
|---|
| State | Read from |
|---|
:hover | the platform |
|---|
Accessibility
| Key | Does |
|---|
| Tab | Moves 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.