Skip to content

App frame

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";

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

PropTypeRequiredDoes
childrenReactNodeYes
addressReactNodeThe address in the bar ("example.com/dashboard"), or the window's title for an app frame.
variant"browser" | "app"
footReactNodeA line at the foot ("Sample data").
decorativebooleanA picture only: the frame is hidden from assistive tech, and description says in words what it shows.
descriptionReactNode

CSS variables

VariableDefault
--cap-app-frame-shadowvar(--shadow-m)

Parts and data attributes

ClassIs
.cap-app-framethe root
.cap-app-frame-addressa part
.cap-app-frame-bara part
.cap-app-frame-bodya part
.cap-app-frame-dotsa part
.cap-app-frame-foota part
AttributeValues
data-variantapp

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.