Shows where each box is and tells the customer.
Integration Card
An integration card stands for one outside service the product can work with: its mark, its name, what connecting it does, and the control that connects it.
Sends each paid order to your books at the end of the day.
Posts new orders to a channel your team already reads.
Sends the customer a receipt from your own address.
Calls your own server when an order changes.
Keeps a sheet of orders up to date every hour.
<div class="tray-demo tray-demo--col">
<div class="tray-integrations">
<article class="tray-integration">
<div class="tray-integration__head">
<span class="tray-integration__icon"><svg class="tray-icon" aria-hidden="true"><use href="#tray-i-truck"/></svg></span>
<label class="tray-switch"><input type="checkbox" role="switch" aria-label="Courier tracking" checked><span class="tray-switch__track"></span></label>
</div>
<div class="tray-integration__text">
<b>Courier tracking</b>
<p>Shows where each box is and tells the customer.</p>
</div>
<div class="tray-integration__foot"><span>On since 2 November</span><a href="#" aria-label="Settings for Courier tracking">Settings</a></div>
</article>
<article class="tray-integration">
<div class="tray-integration__head">
<span class="tray-integration__icon"><svg class="tray-icon" aria-hidden="true"><use href="#tray-i-receipt-text"/></svg></span>
<label class="tray-switch"><input type="checkbox" role="switch" aria-label="Accounting export" checked><span class="tray-switch__track"></span></label>
</div>
<div class="tray-integration__text">
<b>Accounting export</b>
<p>Sends each paid order to your books at the end of the day.</p>
</div>
<div class="tray-integration__foot"><span>On since 14 October</span><a href="#" aria-label="Settings for Accounting export">Settings</a></div>
</article>
<article class="tray-integration">
<div class="tray-integration__head">
<span class="tray-integration__icon"><svg class="tray-icon" aria-hidden="true"><use href="#tray-i-message-square"/></svg></span>
<button class="tray-btn tray-btn--quiet tray-btn--xs" type="button" aria-label="Connect Chat alerts">Connect</button>
</div>
<div class="tray-integration__text">
<b>Chat alerts</b>
<p>Posts new orders to a channel your team already reads.</p>
</div>
<div class="tray-integration__foot"><span>Not connected</span></div>
</article>
<article class="tray-integration">
<div class="tray-integration__head">
<span class="tray-integration__icon"><svg class="tray-icon" aria-hidden="true"><use href="#tray-i-mail"/></svg></span>
<button class="tray-btn tray-btn--quiet tray-btn--xs" type="button" aria-label="Fix Email receipts">Fix</button>
</div>
<div class="tray-integration__text">
<b>Email receipts</b>
<p>Sends the customer a receipt from your own address.</p>
</div>
<div class="tray-integration__foot"><span class="tray-danger"><svg class="tray-icon tray-icon--sm" aria-hidden="true"><use href="#tray-i-circle-alert"/></svg> The address needs to be confirmed again</span></div>
</article>
<article class="tray-integration">
<div class="tray-integration__head">
<span class="tray-integration__icon"><svg class="tray-icon" aria-hidden="true"><use href="#tray-i-code"/></svg></span>
<button class="tray-btn tray-btn--quiet tray-btn--xs" type="button" aria-label="Upgrade Webhooks">Upgrade</button>
</div>
<div class="tray-integration__text">
<b>Webhooks</b>
<p>Calls your own server when an order changes.</p>
</div>
<div class="tray-integration__foot"><span>On the Market plan</span><a href="#" aria-label="Compare plans for Webhooks">Compare plans</a></div>
</article>
<article class="tray-integration">
<div class="tray-integration__head">
<span class="tray-integration__icon"><svg class="tray-icon" aria-hidden="true"><use href="#tray-i-layout-grid"/></svg></span>
<button class="tray-btn tray-btn--quiet tray-btn--xs" type="button" aria-label="Connect Spreadsheet sync">Connect</button>
</div>
<div class="tray-integration__text">
<b>Spreadsheet sync</b>
<p>Keeps a sheet of orders up to date every hour.</p>
</div>
<div class="tray-integration__foot"><span>Not connected</span></div>
</article>
</div>
</div>Playground
One outside service the shop can work with: its state, which decides the control in the corner (a switch, or a button when it needs a sign-in or a plan) and the words in the foot, and what connecting it does.
Markup
<div class="tray-integrations">
<article class="tray-integration">
<div class="tray-integration__head">
<span class="tray-integration__icon"><svg class="tray-icon" aria-hidden="true"><use href="#tray-i-truck"/></svg></span>
<label class="tray-switch"><input type="checkbox" role="switch" aria-label="Courier tracking" checked><span class="tray-switch__track"></span></label>
</div>
<div class="tray-integration__text">
<b>Courier tracking</b>
<p>Shows where each box is and tells the customer.</p>
</div>
<div class="tray-integration__foot"><span>On since 2 November</span><a href="/integrations/courier">Settings</a></div>
</article>
</div>tray-integrations is the grid: cards of at least 17rem that fill the row. The control at the end of the head is a Switch for a connection that turns on and off in place, or a small quiet button ("Connect") for one that opens the other service to sign in. The foot says the state in words and links to the integration's own settings.
The mark is the service's own logo when you may use it (an <img> in the 48px tile). Otherwise an icon for what the service does.
Accessibility
Each card is an <article>. The switch is a checkbox with role="switch": it is announced as on or off, Space flips it, and its aria-label is the service's name. "Connect", "Fix" and "Settings" read the same in every card, so their names hold the service too, after the visible word: aria-label="Connect Chat alerts" on the button and aria-label="Settings for Courier tracking" on the link, as in the example. The mark is decoration beside the name: an icon is aria-hidden, a logo <img> takes alt="". A failed connection is said in words with an icon, never by the danger colour alone.
Do and don't
- Do say what the person gets, not what the service is: "Sends each paid order to your books".
- Do show a failed connection in the foot in
dangerwith a way to fix it. - Don't draw another company's logo from memory.
- Don't connect on a switch when the service needs a sign-in: use the button.