# button-icon

The markup of every demo on <https://kuiper.oeds.it/button-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-`.

## default

The component with no options set -- what the markup alone gives you, before any parameter is tuned. Read this one first: every other panel on the page is a departure from it.

Varies: 3 specimens.

```html
<div data-grid>
 <div class="width-1-1 width-1-2@s width-1-3@m width-1-4@l width-1-7@xl"><div class="card text-center"><p><button data-icon="star" aria-label="star" class="button button-icon"></button></p><p class="text-xs text-muted">default</p></div></div>
 <div class="width-1-1 width-1-2@s width-1-3@m width-1-4@l width-1-7@xl"><div class="card text-center"><p><button data-icon="star" aria-label="star" class="button button-icon button-outline"></button></p><p class="text-xs text-muted">button-outline</p></div></div>
 <div class="width-1-1 width-1-2@s width-1-3@m width-1-4@l width-1-7@xl"><div class="card text-center"><p><button data-icon="star" aria-label="star" class="button button-icon button-link"></button></p><p class="text-xs text-muted">button-link</p></div></div>
</div>
```

## 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.

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

```html
<div data-grid>
 <div class="width-1-1 width-1-2@s width-1-3@m width-1-4@l width-auto@xl"><div class="card text-center"><p><button data-icon="star" aria-label="star" class="button button-icon"></button></p><p class="text-xs text-muted">default</p></div></div>
 <div class="width-1-1 width-1-2@s width-1-3@m width-1-4@l width-auto@xl"><div class="card text-center"><p><button data-icon="star" aria-label="star" class="button button-icon button-3xs"></button></p><p class="text-xs text-muted">3xs</p></div></div>
 <div class="width-1-1 width-1-2@s width-1-3@m width-1-4@l width-auto@xl"><div class="card text-center"><p><button data-icon="star" aria-label="star" class="button button-icon button-2xs"></button></p><p class="text-xs text-muted">2xs</p></div></div>
 <div class="width-1-1 width-1-2@s width-1-3@m width-1-4@l width-auto@xl"><div class="card text-center"><p><button data-icon="star" aria-label="star" class="button button-icon button-xs"></button></p><p class="text-xs text-muted">xs</p></div></div>
 <div class="width-1-1 width-1-2@s width-1-3@m width-1-4@l width-auto@xl"><div class="card text-center"><p><button data-icon="star" aria-label="star" class="button button-icon button-s"></button></p><p class="text-xs text-muted">s</p></div></div>
 <div class="width-1-1 width-1-2@s width-1-3@m width-1-4@l width-auto@xl"><div class="card text-center"><p><button data-icon="star" aria-label="star" class="button button-icon button-m"></button></p><p class="text-xs text-muted">m</p></div></div>
 <div class="width-1-1 width-1-2@s width-1-3@m width-1-4@l width-auto@xl"><div class="card text-center"><p><button data-icon="star" aria-label="star" class="button button-icon button-l"></button></p><p class="text-xs text-muted">l</p></div></div>
 <div class="width-1-1 width-1-2@s width-1-3@m width-1-4@l width-auto@xl"><div class="card text-center"><p><button data-icon="star" aria-label="star" class="button button-icon button-xl"></button></p><p class="text-xs text-muted">xl</p></div></div>
 <div class="width-1-1 width-1-2@s width-1-3@m width-1-4@l width-auto@xl"><div class="card text-center"><p><button data-icon="star" aria-label="star" class="button button-icon button-2xl"></button></p><p class="text-xs text-muted">2xl</p></div></div>
 <div class="width-1-1 width-1-2@s width-1-3@m width-1-4@l width-auto@xl"><div class="card text-center"><p><button data-icon="star" aria-label="star" class="button button-icon button-3xl"></button></p><p class="text-xs text-muted">3xl</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: `button-*` over 13 color roles.

```html
<div data-grid>
 <div class="width-1-1 width-1-2@s width-1-3@m width-1-4@l width-1-7@xl"><div class="card text-center"><p><button data-icon="star" aria-label="star" class="button button-icon button-black"></button></p><p class="text-xs text-black">black</p></div></div>
 <div class="width-1-1 width-1-2@s width-1-3@m width-1-4@l width-1-7@xl"><div class="card text-center"><p><button data-icon="star" aria-label="star" class="button button-icon"></button></p><p class="text-xs">default</p></div></div>
 <div class="width-1-1 width-1-2@s width-1-3@m width-1-4@l width-1-7@xl"><div class="card text-center"><p><button data-icon="star" aria-label="star" class="button button-icon button-muted"></button></p><p class="text-xs text-muted">muted</p></div></div>
 <div class="width-1-1 width-1-2@s width-1-3@m width-1-4@l width-1-7@xl"><div class="card text-center"><p><button data-icon="star" aria-label="star" class="button button-icon button-primary"></button></p><p class="text-xs text-muted">primary</p></div></div>
 <div class="width-1-1 width-1-2@s width-1-3@m width-1-4@l width-1-7@xl"><div class="card text-center"><p><button data-icon="star" aria-label="star" class="button button-icon button-secondary"></button></p><p class="text-xs text-muted">secondary</p></div></div>
 <div class="width-1-1 width-1-2@s width-1-3@m width-1-4@l width-1-7@xl"><div class="card text-center"><p><button data-icon="star" aria-label="star" class="button button-icon button-tertiary"></button></p><p class="text-xs text-muted">tertiary</p></div></div>
 <div class="width-1-1 width-1-2@s width-1-3@m width-1-4@l width-1-7@xl"><div class="card text-center"><p><button data-icon="star" aria-label="star" class="button button-icon button-danger"></button></p><p class="text-xs text-muted">danger</p></div></div>
 <div class="width-1-1 width-1-2@s width-1-3@m width-1-4@l width-1-7@xl"><div class="card text-center"><p><button data-icon="star" aria-label="star" class="button button-icon button-warning"></button></p><p class="text-xs text-muted">warning</p></div></div>
 <div class="width-1-1 width-1-2@s width-1-3@m width-1-4@l width-1-7@xl"><div class="card text-center"><p><button data-icon="star" aria-label="star" class="button button-icon button-accent"></button></p><p class="text-xs text-muted">accent</p></div></div>
 <div class="width-1-1 width-1-2@s width-1-3@m width-1-4@l width-1-7@xl"><div class="card text-center"><p><button data-icon="star" aria-label="star" class="button button-icon button-success"></button></p><p class="text-xs text-muted">success</p></div></div>
 <div class="width-1-1 width-1-2@s width-1-3@m width-1-4@l width-1-7@xl"><div class="card text-center"><p><button data-icon="star" aria-label="star" class="button button-icon button-info"></button></p><p class="text-xs text-muted">info</p></div></div>
 <div class="width-1-1 width-1-2@s width-1-3@m width-1-4@l width-1-7@xl"><div class="card text-center"><p><button data-icon="star" aria-label="star" class="button button-icon button-action"></button></p><p class="text-xs text-muted">action</p></div></div>
 <div class="width-1-1 width-1-2@s width-1-3@m width-1-4@l width-1-7@xl"><div class="card text-center"><p><button data-icon="star" aria-label="star" class="button button-icon button-urgent"></button></p><p class="text-xs text-muted">urgent</p></div></div>
 <div class="width-1-1 width-1-2@s width-1-3@m width-1-4@l width-1-7@xl"><div class="card text-center"><p><button data-icon="star" aria-label="star" class="button button-icon button-emphasis"></button></p><p class="text-xs text-muted">emphasis</p></div></div>
</div>
```

## color

Varies: `button-*` over 13 color roles.

```html
<div data-grid>
 <div class="width-1-1 width-1-2@s width-1-3@m width-1-4@l width-1-7@xl"><div class="card text-center"><p><button data-icon="star" aria-label="star" class="button button-icon"></button></p><p class="text-xs">default</p></div></div>
 <div class="width-1-1 width-1-2@s width-1-3@m width-1-4@l width-1-7@xl"><div class="card text-center"><p><button data-icon="star" aria-label="star" class="button button-icon button-white"></button></p><p class="text-xs text-white">white</p></div></div>
 <div class="width-1-1 width-1-2@s width-1-3@m width-1-4@l width-1-7@xl"><div class="card text-center"><p><button data-icon="star" aria-label="star" class="button button-icon button-muted"></button></p><p class="text-xs text-muted">muted</p></div></div>
 <div class="width-1-1 width-1-2@s width-1-3@m width-1-4@l width-1-7@xl"><div class="card text-center"><p><button data-icon="star" aria-label="star" class="button button-icon button-primary"></button></p><p class="text-xs text-primary">primary</p></div></div>
 <div class="width-1-1 width-1-2@s width-1-3@m width-1-4@l width-1-7@xl"><div class="card text-center"><p><button data-icon="star" aria-label="star" class="button button-icon button-secondary"></button></p><p class="text-xs text-secondary">secondary</p></div></div>
 <div class="width-1-1 width-1-2@s width-1-3@m width-1-4@l width-1-7@xl"><div class="card text-center"><p><button data-icon="star" aria-label="star" class="button button-icon button-tertiary"></button></p><p class="text-xs text-tertiary">tertiary</p></div></div>
 <div class="width-1-1 width-1-2@s width-1-3@m width-1-4@l width-1-7@xl"><div class="card text-center"><p><button data-icon="star" aria-label="star" class="button button-icon button-danger"></button></p><p class="text-xs text-danger">danger</p></div></div>
 <div class="width-1-1 width-1-2@s width-1-3@m width-1-4@l width-1-7@xl"><div class="card text-center"><p><button data-icon="star" aria-label="star" class="button button-icon button-warning"></button></p><p class="text-xs text-warning">warning</p></div></div>
 <div class="width-1-1 width-1-2@s width-1-3@m width-1-4@l width-1-7@xl"><div class="card text-center"><p><button data-icon="star" aria-label="star" class="button button-icon button-accent"></button></p><p class="text-xs text-accent">accent</p></div></div>
 <div class="width-1-1 width-1-2@s width-1-3@m width-1-4@l width-1-7@xl"><div class="card text-center"><p><button data-icon="star" aria-label="star" class="button button-icon button-success"></button></p><p class="text-xs text-success">success</p></div></div>
 <div class="width-1-1 width-1-2@s width-1-3@m width-1-4@l width-1-7@xl"><div class="card text-center"><p><button data-icon="star" aria-label="star" class="button button-icon button-info"></button></p><p class="text-xs text-info">info</p></div></div>
 <div class="width-1-1 width-1-2@s width-1-3@m width-1-4@l width-1-7@xl"><div class="card text-center"><p><button data-icon="star" aria-label="star" class="button button-icon button-action"></button></p><p class="text-xs text-action">action</p></div></div>
 <div class="width-1-1 width-1-2@s width-1-3@m width-1-4@l width-1-7@xl"><div class="card text-center"><p><button data-icon="star" aria-label="star" class="button button-icon button-urgent"></button></p><p class="text-xs text-urgent">urgent</p></div></div>
 <div class="width-1-1 width-1-2@s width-1-3@m width-1-4@l width-1-7@xl"><div class="card text-center"><p><button data-icon="star" aria-label="star" class="button button-icon button-emphasis"></button></p><p class="text-xs text-emphasis">emphasis</p></div></div>
</div>
```
