Typography
--text-3xl
1.8rem
Headline 1, Text in Compound Commands
--text-2xl
1.6rem
Headline 2
--text-xl
1.4rem
Headline 3
--text-lg
1.2rem
Headline 4
--text-base
1rem
Normal Text, Command Label, Tile Header
--text-sm
0.85rem
Small Text, Panel Footer
--text-xs
0.75rem
Tile Footer
Sizing
Padding
--padding-xs
0.15rem
--padding-sm
0.4rem
--padding
0.75rem
--padding-lg
1rem
→ Paddings are responsive (in rem).
Usage: paddings, anything which should grow/shrink with the root font-size
Spacing
--spacing-xs
2px
--spacing-sm
6px
--spacing
10px
--spacing-lg
14px
→ Spacings are not responsive (in px).
Usage: spacings, gaps, anything which should be stable regardless of the font-size
Scaling
By adding the class scaled and setting the CSS custom
property --scaled to a number like 1.5,
every responsive token (sizes, paddings, font-size) is scaled in
this scope. See the scaled tile as an example:
Colors
Primary
Tone 1
Tone 2
Tone 3
Tone 4
Warn
Usage
100
Text Color
500
Active/Focus State
600
Border/Flash Color
700
Corner Color
800
Command Color
950
Background
Layout
Page Layout
Choose yourself whether the body should scroll or the body should have a fixed width of 100%. For the latter, you should use one or more top-most panels which then will scroll their content.
You can see both options and how to implement them by toggling the
class height-100 on the html element of
this demo page.
Panel
Without Header and Footer
With Header and Footer
With another color variant
With a Command Dock
Docked in the Header
Docked in the Footer
Stacking
The panel has a translucent background, so when stacking multiple panels the background changes slightly with each level.
Tile
A tile holds text: a header, a value and a footer. Commands, inputs and headings in the tile body belong in a panel, since a tile's surface is tuned for its own ink only.
With Header
The header names what the tile shows, the article holds the value.
Controls
Command
Thin
Outline
With outline-in-light the command is rendered as
outline variant in light mode only.
Flashing
With reduced motion requested by the system, a command pulses three times slowly, then a dot in its corner keeps marking it.
Disabled
Abbreviations for small screens
When rendered on small screens (<640px) an abbreviation can be
used to reduce the space a command needs. When doing so, the text
node of the command should be empty and two
data- attributes should be used:
data-label and data-abbr.
In order to see the difference below, reduce/increase the browser window width.
Wrapping
The command's text is wrapped by default which increases the height of the command.
If you want to use ellipsis and a single line of text, a wrapper element is needed. See page's source code for details.
Double check if ellipsis is really needed and if yes, that the full text is visible with another interaction (no tooltip, since not mobile friendly and not in the sense of the Ada look and feel).
Compound
Thin
With Text
Vertical
Input
Disabled
Indicators
Spinner
With reduced motion requested by the system, the spinner turns three times slower instead of stopping, so it never looks frozen.
80px
32px
16px
Meter
Shows a quantity. Set --value inline to a number
between 0 and 1 (out-of-range values are clamped), and give the
element role="meter" with its
aria-value* attributes, since the fill itself is
decoration.
Segmented
Vertical
A vertical meter takes its parent's height, so the parent needs a definite one, or the meter collapses to nothing.
Chip
A small, non-interactive block for keys, codes, tags and
statuses. It uses the command's colours, so its contrast is
whatever the theme tunes for commands. Anything clickable should
be a command thin instead.
Inline in text: release v8.2.0 is Blocked on one review.
Recipes
Patterns built from existing components. Ada ships no class for them; the layout is a few lines of grid in your own stylesheet. See the page's source code for details.
Bar List
Labelled values compared at a glance: a chip, a meter and the value. Colour marks a state, the number carries the value.
Status Log
Coded lines in an ordered list. The colour sits in the chip, the text stays in the body colour.
- 01Checkout
- 02Install dependencies
- 03Build
- 04Test: 2 failed
- 05Deploy: skipped