# icon

The markup of every demo on <https://kuiper.oeds.it/icon/>, extracted from that
page. It is generated, so it cannot disagree with what the page renders.

Load the framework from the origin and read <https://kuiper.oeds.it/docs/KUIPER.md> first:
a Kuiper class carries no prefix and a UIkit behavior attribute carries `data-`.

## size

One specimen per size rung, so the ladder reads as a single column. A rung sets the height, the type size and the horizontal padding together, and the sizeless specimen is identical to `-m` by construction.

```html
<div class="grid-xs" data-grid>
 <div class="width-auto"><div class="card text-center"><p><span data-icon="star" role="img" aria-label="star icon"></span></p><p class="text-xs text-muted">icon</p></div></div>
</div>
```

## size

Varies: the `icon-*` ladder over 5 rungs, `xs` to `xl`.

```html
<div class="grid-xs" data-grid>
 <div class="width-auto"><div class="card text-center"><p><span data-icon="star" class="icon-xs" role="img" aria-label="star icon-xs"></span></p><p class="text-xs text-muted">icon-xs</p></div></div>
 <div class="width-auto"><div class="card text-center"><p><span data-icon="star" class="icon-s" role="img" aria-label="star icon-s"></span></p><p class="text-xs text-muted">icon-s</p></div></div>
 <div class="width-auto"><div class="card text-center"><p><span data-icon="star" class="icon-m" role="img" aria-label="star icon-m"></span></p><p class="text-xs text-muted">icon-m</p></div></div>
 <div class="width-auto"><div class="card text-center"><p><span data-icon="star" class="icon-l" role="img" aria-label="star icon-l"></span></p><p class="text-xs text-muted">icon-l</p></div></div>
 <div class="width-auto"><div class="card text-center"><p><span data-icon="star" class="icon-xl" role="img" aria-label="star icon-xl"></span></p><p class="text-xs text-muted">icon-xl</p></div></div>
</div>
```

## rotation

Varies: 8 specimens.

```html
<div class="grid-xs" data-grid>
 <div class="width-auto"><div class="card text-center"><p><span data-icon="angle-right" class="icon-right" role="img" aria-label="angle-right icon-right"></span></p><p class="text-xs text-muted">icon-right</p></div></div>
 <div class="width-auto"><div class="card text-center"><p><span data-icon="angle-right" class="icon-bottom-right" role="img" aria-label="angle-right icon-bottom-right"></span></p><p class="text-xs text-muted">icon-bottom-right</p></div></div>
 <div class="width-auto"><div class="card text-center"><p><span data-icon="angle-right" class="icon-bottom" role="img" aria-label="angle-right icon-bottom"></span></p><p class="text-xs text-muted">icon-bottom</p></div></div>
 <div class="width-auto"><div class="card text-center"><p><span data-icon="angle-right" class="icon-bottom-left" role="img" aria-label="angle-right icon-bottom-left"></span></p><p class="text-xs text-muted">icon-bottom-left</p></div></div>
 <div class="width-auto"><div class="card text-center"><p><span data-icon="angle-right" class="icon-left" role="img" aria-label="angle-right icon-left"></span></p><p class="text-xs text-muted">icon-left</p></div></div>
 <div class="width-auto"><div class="card text-center"><p><span data-icon="angle-right" class="icon-top-left" role="img" aria-label="angle-right icon-top-left"></span></p><p class="text-xs text-muted">icon-top-left</p></div></div>
 <div class="width-auto"><div class="card text-center"><p><span data-icon="angle-right" class="icon-top" role="img" aria-label="angle-right icon-top"></span></p><p class="text-xs text-muted">icon-top</p></div></div>
 <div class="width-auto"><div class="card text-center"><p><span data-icon="angle-right" class="icon-top-right" role="img" aria-label="angle-right icon-top-right"></span></p><p class="text-xs text-muted">icon-top-right</p></div></div>
</div>
```

## color

The same specimen repeated on each ground Kuiper paints. The point is what you do NOT write: the ink, the border and the placeholder follow the ground through the `--foreground-*` tokens, so no color class appears on the specimen itself.

Varies: `text-*` over 12 color roles.

Shown 2 times on the page, on different grounds. The markup is
identical: the ground is a class on the panel around it.

```html
<div class="grid-xs" data-grid>
 <div class="width-auto"><div class="card text-center"><div class="text-primary"><p><span data-icon="star" role="img" aria-label="star primary"></span></p><p class="text-xs">primary</p></div></div></div>
 <div class="width-auto"><div class="card text-center"><div><p><span data-icon="star" role="img" aria-label="star muted"></span></p><p class="text-xs">base</p></div></div></div>
 <div class="width-auto"><div class="card text-center"><div class="text-muted"><p><span data-icon="star" role="img" aria-label="star muted"></span></p><p class="text-xs">muted</p></div></div></div>
 <div class="width-auto"><div class="card text-center"><div class="text-secondary"><p><span data-icon="star" role="img" aria-label="star secondary"></span></p><p class="text-xs">secondary</p></div></div></div>
 <div class="width-auto"><div class="card text-center"><div class="text-tertiary"><p><span data-icon="star" role="img" aria-label="star tertiary"></span></p><p class="text-xs">tertiary</p></div></div></div>
 <div class="width-auto"><div class="card text-center"><div class="text-danger"><p><span data-icon="star" role="img" aria-label="star danger"></span></p><p class="text-xs">danger</p></div></div></div>
 <div class="width-auto"><div class="card text-center"><div class="text-warning"><p><span data-icon="star" role="img" aria-label="star warning"></span></p><p class="text-xs">warning</p></div></div></div>
 <div class="width-auto"><div class="card text-center"><div class="text-accent"><p><span data-icon="star" role="img" aria-label="star accent"></span></p><p class="text-xs">accent</p></div></div></div>
 <div class="width-auto"><div class="card text-center"><div class="text-success"><p><span data-icon="star" role="img" aria-label="star success"></span></p><p class="text-xs">success</p></div></div></div>
 <div class="width-auto"><div class="card text-center"><div class="text-info"><p><span data-icon="star" role="img" aria-label="star info"></span></p><p class="text-xs">info</p></div></div></div>
 <div class="width-auto"><div class="card text-center"><div class="text-action"><p><span data-icon="star" role="img" aria-label="star action"></span></p><p class="text-xs">action</p></div></div></div>
 <div class="width-auto"><div class="card text-center"><div class="text-urgent"><p><span data-icon="star" role="img" aria-label="star urgent"></span></p><p class="text-xs">urgent</p></div></div></div>
 <div class="width-auto"><div class="card text-center"><div class="text-emphasis"><p><span data-icon="star" role="img" aria-label="star emphasis"></span></p><p class="text-xs">emphasis</p></div></div></div>
</div>
```

## with text

The icon beside running text, which is the case the cap-height correction exists for: `vertical-align: calc((0.711em - box) / 2)` puts the box on the band an eye actually reads, not on the x-height that `middle` targets.

Varies: the `text-*` ladder over 5 rungs, `xs` to `xl`.

```html
<div class="grid-xs" data-grid>
 <div class="width-1-1"><div class="card text-left"><p><i data-icon="star"></i>&nbsp;base html&nbsp;<i data-icon="star"></i></p></div></div>
 <div class="width-1-1"><div class="card text-left text-xs"><p><i data-icon="star"></i>&nbsp;text-xs&nbsp;<i data-icon="star"></i></p></div></div>
 <div class="width-1-1"><div class="card text-left text-s"><p><i data-icon="star"></i>&nbsp;text-s&nbsp;<i data-icon="star"></i></p></div></div>
 <div class="width-1-1"><div class="card text-left text-m"><p><i data-icon="star"></i>&nbsp;text-m&nbsp;<i data-icon="star"></i></p></div></div>
 <div class="width-1-1"><div class="card text-left text-l"><p><i data-icon="star"></i>&nbsp;text-l&nbsp;<i data-icon="star"></i></p></div></div>
 <div class="width-1-1"><div class="card text-left text-xl"><p><i data-icon="star"></i>&nbsp;text-xl&nbsp;<i data-icon="star"></i></p></div></div>
</div>
```

## with text

Varies: 6 specimens.

```html
<div class="grid-xs" data-grid>
 <div class="width-1-1"><div class="card text-left h6"><p><i data-icon="star"></i>&nbsp;h6&nbsp;<i data-icon="star"></i></p></div></div>
 <div class="width-1-1"><div class="card text-left h5"><p><i data-icon="star"></i>&nbsp;h5&nbsp;<i data-icon="star"></i></p></div></div>
 <div class="width-1-1"><div class="card text-left h4"><p><i data-icon="star"></i>&nbsp;h4&nbsp;<i data-icon="star"></i></p></div></div>
 <div class="width-1-1"><div class="card text-left h3"><h3><i data-icon="star"></i>&nbsp;h3&nbsp;<i data-icon="star"></i></h3></div></div>
 <div class="width-1-1"><div class="card text-left h2"><h3><i data-icon="star"></i>&nbsp;h2&nbsp;<i data-icon="star"></i></h3></div></div>
 <div class="width-1-1"><div class="card text-left h1"><h3><i data-icon="star"></i>&nbsp;h1&nbsp;<i data-icon="star"></i></h3></div></div>
</div>
```

## with text

Varies: the `hero-*` ladder over 5 rungs, `xs` to `xl`.

```html
<div class="grid-xs" data-grid>
 <div class="width-1-1"><div class="card text-left hero-xs"><h3><i data-icon="star"></i>&nbsp;hero-xs&nbsp;<i data-icon="star"></i></h3></div></div>
 <div class="width-1-1"><div class="card text-left hero-s"><h3><i data-icon="star"></i>&nbsp;hero-s&nbsp;<i data-icon="star"></i></h3></div></div>
 <div class="width-1-1"><div class="card text-left hero-m"><h3><i data-icon="star"></i>&nbsp;hero-m&nbsp;<i data-icon="star"></i></h3></div></div>
 <div class="width-1-1"><div class="card text-left hero-l"><h3><i data-icon="star"></i>&nbsp;hero-l&nbsp;<i data-icon="star"></i></h3></div></div>
 <div class="width-1-1"><div class="card text-left hero-xl"><h3><i data-icon="star"></i>&nbsp;hero-xl&nbsp;<i data-icon="star"></i></h3></div></div>
</div>
```

## in button

The icon inside a button. This is the one context where the correction is not used at all: a button's icon is a FLEX ITEM, where `vertical-align` is ignored by specification and the flex centring already lands within a pixel of the cap band.

Varies: the `button-*` ladder over 5 rungs, `xs` to `xl`.

```html
<div class="grid-xs" data-grid>
 <div class="width-auto"><div class="card text-center"><p><button aria-label="menu" class="button"><i data-icon="star"></i>button<i data-icon="star"></i></button></p></div></div>
 <div class="width-auto"><div class="card text-center"><p><button aria-label="menu" class="button button-xs"><i data-icon="star"></i>button-xs<i data-icon="star"></i></button></p></div></div>
 <div class="width-auto"><div class="card text-center"><p><button aria-label="menu" class="button button-s"><i data-icon="star"></i>button-s<i data-icon="star"></i></button></p></div></div>
 <div class="width-auto"><div class="card text-center"><p><button aria-label="menu" class="button button-m"><i data-icon="star"></i>button-m<i data-icon="star"></i></button></p></div></div>
 <div class="width-auto"><div class="card text-center"><p><button aria-label="menu" class="button button-l"><i data-icon="star"></i>button-l<i data-icon="star"></i></button></p></div></div>
 <div class="width-auto"><div class="card text-center"><p><button aria-label="menu" class="button button-xl"><i data-icon="star"></i>button-xl<i data-icon="star"></i></button></p></div></div>
</div>
```

## in button

Varies: the `button-*` ladder over 5 rungs, `xs` to `xl`.

```html
<div class="grid-xs" data-grid>
 <div class="width-auto"><div class="card text-center"><p><button data-icon="star" aria-label="menu" class="button button-rectangle"></button></p><p class="text-xs text-muted">rectangle</p></div></div>
 <div class="width-auto"><div class="card text-center"><p><button data-icon="star" aria-label="menu" class="button button-rectangle button-xs"></button></p><p class="text-xs text-muted">xs</p></div></div>
 <div class="width-auto"><div class="card text-center"><p><button data-icon="star" aria-label="menu" class="button button-rectangle button-s"></button></p><p class="text-xs text-muted">s</p></div></div>
 <div class="width-auto"><div class="card text-center"><p><button data-icon="star" aria-label="menu" class="button button-rectangle button-m"></button></p><p class="text-xs text-muted">m</p></div></div>
 <div class="width-auto"><div class="card text-center"><p><button data-icon="star" aria-label="menu" class="button button-rectangle button-l"></button></p><p class="text-xs text-muted">l</p></div></div>
 <div class="width-auto"><div class="card text-center"><p><button data-icon="star" aria-label="menu" class="button button-rectangle button-xl"></button></p><p class="text-xs text-muted">xl</p></div></div>
</div>
```

## in button

Varies: the `button-*` ladder over 5 rungs, `xs` to `xl`.

```html
<div class="grid-xs" data-grid>
 <div class="width-auto"><div class="card text-center"><p><button data-icon="star" aria-label="menu" class="button button-rounded button-rectangle"></button></p><p class="text-xs text-muted">rectangle<br>rounded</p></div></div>
 <div class="width-auto"><div class="card text-center"><p><button data-icon="star" aria-label="menu" class="button button-rounded button-rectangle button-xs"></button></p><p class="text-xs text-muted">xs</p></div></div>
 <div class="width-auto"><div class="card text-center"><p><button data-icon="star" aria-label="menu" class="button button-rounded button-rectangle button-s"></button></p><p class="text-xs text-muted">s</p></div></div>
 <div class="width-auto"><div class="card text-center"><p><button data-icon="star" aria-label="menu" class="button button-rounded button-rectangle button-m"></button></p><p class="text-xs text-muted">m</p></div></div>
 <div class="width-auto"><div class="card text-center"><p><button data-icon="star" aria-label="menu" class="button button-rounded button-rectangle button-l"></button></p><p class="text-xs text-muted">l</p></div></div>
 <div class="width-auto"><div class="card text-center"><p><button data-icon="star" aria-label="menu" class="button button-rounded button-rectangle button-xl"></button></p><p class="text-xs text-muted">xl</p></div></div>
</div>
```

## in button

Varies: the `button-*` ladder over 5 rungs, `xs` to `xl`.

```html
<div class="grid-xs" data-grid>
 <div class="width-auto"><div class="card text-center"><p><button data-icon="star" aria-label="menu" class="button button-square"></button></p><p class="text-xs text-muted">square</p></div></div>
 <div class="width-auto"><div class="card text-center"><p><button data-icon="star" aria-label="menu" class="button button-square button-xs"></button></p><p class="text-xs text-muted">xs</p></div></div>
 <div class="width-auto"><div class="card text-center"><p><button data-icon="star" aria-label="menu" class="button button-square button-s"></button></p><p class="text-xs text-muted">s</p></div></div>
 <div class="width-auto"><div class="card text-center"><p><button data-icon="star" aria-label="menu" class="button button-square button-m"></button></p><p class="text-xs text-muted">m</p></div></div>
 <div class="width-auto"><div class="card text-center"><p><button data-icon="star" aria-label="menu" class="button button-square button-l"></button></p><p class="text-xs text-muted">l</p></div></div>
 <div class="width-auto"><div class="card text-center"><p><button data-icon="star" aria-label="menu" class="button button-square button-xl"></button></p><p class="text-xs text-muted">xl</p></div></div>
</div>
```

## in button

Varies: the `button-*` ladder over 5 rungs, `xs` to `xl`.

```html
<div class="grid-xs" data-grid>
 <div class="width-auto"><div class="card text-center"><p><button data-icon="star" aria-label="menu" class="button button-rounded button-square"></button></p><p class="text-xs text-muted">square<br>rounded</p></div></div>
 <div class="width-auto"><div class="card text-center"><p><button data-icon="star" aria-label="menu" class="button button-rounded button-square button-xs"></button></p><p class="text-xs text-muted">xs</p></div></div>
 <div class="width-auto"><div class="card text-center"><p><button data-icon="star" aria-label="menu" class="button button-rounded button-square button-s"></button></p><p class="text-xs text-muted">s</p></div></div>
 <div class="width-auto"><div class="card text-center"><p><button data-icon="star" aria-label="menu" class="button button-rounded button-square button-m"></button></p><p class="text-xs text-muted">m</p></div></div>
 <div class="width-auto"><div class="card text-center"><p><button data-icon="star" aria-label="menu" class="button button-rounded button-square button-l"></button></p><p class="text-xs text-muted">l</p></div></div>
 <div class="width-auto"><div class="card text-center"><p><button data-icon="star" aria-label="menu" class="button button-rounded button-square button-xl"></button></p><p class="text-xs text-muted">xl</p></div></div>
</div>
```

## in button

Varies: the `button-*` ladder over 5 rungs, `xs` to `xl`.

```html
<div class="grid-xs" data-grid>
 <div class="width-auto"><div class="card text-center"><p><button data-icon="star" aria-label="menu" class="button button-disc"></button></p><p class="text-xs text-muted">disc</p></div></div>
 <div class="width-auto"><div class="card text-center"><p><button data-icon="star" aria-label="menu" class="button button-disc button-xs"></button></p><p class="text-xs text-muted">xs</p></div></div>
 <div class="width-auto"><div class="card text-center"><p><button data-icon="star" aria-label="menu" class="button button-disc button-s"></button></p><p class="text-xs text-muted">s</p></div></div>
 <div class="width-auto"><div class="card text-center"><p><button data-icon="star" aria-label="menu" class="button button-disc button-m"></button></p><p class="text-xs text-muted">m</p></div></div>
 <div class="width-auto"><div class="card text-center"><p><button data-icon="star" aria-label="menu" class="button button-disc button-l"></button></p><p class="text-xs text-muted">l</p></div></div>
 <div class="width-auto"><div class="card text-center"><p><button data-icon="star" aria-label="menu" class="button button-disc button-xl"></button></p><p class="text-xs text-muted">xl</p></div></div>
</div>
```

## in button

Varies: the `button-*` ladder over 5 rungs, `xs` to `xl`.

```html
<div class="grid-xs" data-grid>
 <div class="width-auto"><div class="card text-center"><p><button data-icon="star" aria-label="menu" class="button button-icon"></button></p><p class="text-xs text-muted">button-icon</p></div></div>
 <div class="width-auto"><div class="card text-center"><p><button data-icon="star" aria-label="menu" class="button button-icon button-xs"></button></p><p class="text-xs text-muted">xs</p></div></div>
 <div class="width-auto"><div class="card text-center"><p><button data-icon="star" aria-label="menu" class="button button-icon button-s"></button></p><p class="text-xs text-muted">s</p></div></div>
 <div class="width-auto"><div class="card text-center"><p><button data-icon="star" aria-label="menu" class="button button-icon button-m"></button></p><p class="text-xs text-muted">m</p></div></div>
 <div class="width-auto"><div class="card text-center"><p><button data-icon="star" aria-label="menu" class="button button-icon button-l"></button></p><p class="text-xs text-muted">l</p></div></div>
 <div class="width-auto"><div class="card text-center"><p><button data-icon="star" aria-label="menu" class="button button-icon button-xl"></button></p><p class="text-xs text-muted">xl</p></div></div>
</div>
```
