A window with dots and an address bar around a product preview, so it reads as a picture of the app.
<div class="cap-app-frame" id="af-browser">
<div class="cap-app-frame-bar">
<span class="cap-app-frame-dots" aria-hidden="true"><span></span></span>
<span class="cap-app-frame-address">example.com/dashboard</span>
</div>
<div class="cap-app-frame-body"><p class="frame-demo">Three checks passing on example.com</p></div>
<div class="cap-app-frame-foot"><p class="cap-eyebrow" data-variant="mono">Sample data</p></div>
</div>
Installation
// package.json: "capsomer": "github:DrDustinEdwards/capsomer#v0.152.2"
import "capsomer/tokens.css";
import "capsomer/base.css";
import "capsomer/app-frame.css";
import "capsomer/tokens.css";
import "capsomer/app-frame.css";
import { AppFrame } from "capsomer/react/app-frame";
Usage
<p class="cap-sr-only">A picture of the queue working three sample payments.</p> <!-- decorative only -->
<div class="cap-app-frame" aria-hidden="true"> <!-- data-variant="app" -->
<div class="cap-app-frame-bar">
<span class="cap-app-frame-dots" aria-hidden="true"><span></span></span>
<span class="cap-app-frame-address">example.com/dashboard</span>
</div>
<div class="cap-app-frame-body">[preview]</div>
<div class="cap-app-frame-foot"><p class="cap-eyebrow" data-variant="mono">Sample data</p></div>
</div>
Examples
App
<div class="cap-app-frame" data-variant="app" id="af-app">
<div class="cap-app-frame-bar"><span class="cap-app-frame-address">Drafts</span></div>
<div class="cap-app-frame-body"><p class="frame-demo">Field notes, saved two minutes ago</p></div>
</div>
Decorative, with a description
<p class="cap-sr-only" id="af-description">A picture of the queue working three sample payments; two are recovered.</p>
<div class="cap-app-frame" aria-hidden="true" id="af-decorative">
<div class="cap-app-frame-bar">
<span class="cap-app-frame-dots" aria-hidden="true"><span></span></span>
<span class="cap-app-frame-address">example.com/queue</span>
</div>
<div class="cap-app-frame-body"><p class="frame-demo">Alex Rivera, $49, recovered</p></div>
</div>
API reference
AppFrame
| Prop | Type | Required | Does |
|---|
children | ReactNode | Yes | |
|---|
address | ReactNode | | The address in the bar ("example.com/dashboard"), or the window's title for an app frame. |
|---|
variant | "browser" | "app" | | |
|---|
foot | ReactNode | | A line at the foot ("Sample data"). |
|---|
decorative | boolean | | A picture only: the frame is hidden from assistive tech, and description says in words what it shows. |
|---|
description | ReactNode | | |
|---|
CSS variables
| Variable | Default |
|---|
--cap-app-frame-shadow | var(--shadow-m) |
|---|
Parts and data attributes
| Class | Is |
|---|
.cap-app-frame | the root |
|---|
.cap-app-frame-address | a part |
|---|
.cap-app-frame-bar | a part |
|---|
.cap-app-frame-body | a part |
|---|
.cap-app-frame-dots | a part |
|---|
.cap-app-frame-foot | a part |
|---|
| Attribute | Values |
|---|
data-variant | app |
|---|
Accessibility
Nothing to operate. A decorative frame holds nothing focusable.
- A decorative frame is
aria-hidden and has a text description beside it; a frame around real content is not hidden. - The address is
--muted on --surface: in the contrast report.