Under the wireframe header, screens hold UI controls. One to three screens
render side by side, each inside a device frame. It is the fastest way to sketch
an app or web layout without drawing a single box.
wireframetitle: Onboarding
screen Login [phone] {
heading: Welcome back
input: Email
input: Password
button: Sign in [half]
button: SSO [half]
navbar: Home | Feed | Profile [active: 0]
}
screen Name [frame] { controls }. The frame is phone (the default),
tablet, browser, or window. Give two or three screens to show a flow.
wireframescreen Phone [phone] {
statusbar
heading: Inbox
list: Alice | Bob | Carol
tabbar: Home | Search | Me [active: 0]
}
screen Desktop [browser] {
heading: Inbox
search: Search mail
list: Alice | Bob | Carol
}
A control is kind or kind: label, plus optional attributes. Widths are
positional: full (default), half, third, or two-thirds. Consecutive
controls pack onto one row while their fractions fit. The full list of kinds is
in the reference.
wireframescreen Form [window] {
heading: Create account
input: Full name
input: Email [half]
input: Phone [half]
dropdown: Country
textarea: Bio
checkbox: Email me updates [checked]
button: Submit [half]
button: Cancel [half]
}
By default a control fills its screen's column. A width attribute puts several on
one row: full (the default), half, third, two-thirds. Consecutive controls
whose widths add up to a row sit side by side, so two halfs pair off and three
thirds make a trio. A row that doesn't fill up keeps its widths and leaves the
rest empty, so a lone half button stays half wide. 1/2, 1/3 and 2/3 are accepted spellings.
wireframescreen Profile [browser] {
heading: Edit profile
input: First name [half]
input: Last name [half]
input: Email
button: Save changes
}
Two halves share a row; the button below returns to full width.
Buttons are neutral outlines by default. Mark the main action primary to give
it the blue accent, or name any palette color (red, green, yellow, and so
on) to fill it with that hue. Colors also tint cards, badges, toggles, tooltips
and the other filled controls.
wireframescreen Confirm [window] {
heading: Delete this project?
paragraph: Everything in it goes with it.
button: Cancel [third]
button: Archive instead [third, primary]
button: Delete [third, red]
}
A tooltip points down by default; write up, left or right to point it
another way. Add over to float a control on top of the page instead of giving
it a row of its own. It anchors to the control written before it: below it, or
above it for a tooltip that points down, beside it for left and right. An
over control with nothing before it is centered on the screen, like a modal.
A quoted label keeps \n line breaks.
wireframescreen Projects [browser] {
heading: Projects
search: Search projects [two-thirds]
button: + New project [third, primary]
tooltip: Create your first project · 2 of 5 [up, over]
list: Onboarding revamp | Billing page | Mobile beta
button: ← Back [half]
button: Next → [half, primary]
}
A product tour step: a tooltip under the highlighted button.
A popover is the card a product tour or onboarding hint floats over the page:
a title, body text and an optional footer with a progress note and two buttons.
Write its parts in order, separated by |: title | body | footer | secondary | primary. Leave out the parts you don't need, or leave one empty (| |) to skip
it. A popover always floats: it sits below the control written before it with
its pointer aimed at it. up (the default), down, left and right move the
pointer, and a side with no room falls back to below. A popover with nothing
before it is centered on the screen without a pointer; none drops the pointer
anywhere.
wireframescreen Projects [browser] {
heading: Projects
search: Search projects [two-thirds]
button: + New project [third, primary]
popover: Create your first project | Projects group your tours. Click New project to add one, or press Next to keep going. | 2 of 5 | ‹ Previous | Next ›
list: Onboarding revamp | Billing page | Mobile beta
}
A tour step pointing at the button it explains.
For a couple of fuller layouts, a mobile shopping app across two screens (a
product list and a cart) using the mobile-specific controls.