# Signal

> A small row of stepped bars that shows a level, such as priority, strength or coverage.

Show priority, strength or any other level with the signal component - a compact row of stepped bars that sits next to a label.

Source: https://docs.tabler.io/ui/components/signal

---

## Basic example

Build a signal from a `.signal` wrapper with three `.signal-bar` elements. Add `.active` to each bar that should be lit. The bars grow in even steps, and the unlit ones stay visible in a lighter tone.

```html
<span class="signal" role="img" aria-label="Level 2 of 3">
  <span class="signal-bar active"></span>
  <span class="signal-bar active"></span>
  <span class="signal-bar"></span>
</span>
```

## With a label

Put the signal next to a text label. When the label already names the level, hide the signal from assistive technology with `aria-hidden="true"`.

```html
<div class="d-flex flex-column gap-2">
  <div class="d-flex align-items-center gap-2">
    <span class="signal signal-orange" aria-hidden="true">
      <span class="signal-bar active"></span>
      <span class="signal-bar active"></span>
      <span class="signal-bar active"></span>
    </span>Urgent
  </div>
  <div class="d-flex align-items-center gap-2">
    <span class="signal signal-blue" aria-hidden="true">
      <span class="signal-bar active"></span>
      <span class="signal-bar active"></span>
      <span class="signal-bar"></span>
    </span>Normal
  </div>
  <div class="d-flex align-items-center gap-2">
    <span class="signal signal-green" aria-hidden="true">
      <span class="signal-bar active"></span>
      <span class="signal-bar"></span>
      <span class="signal-bar"></span>
    </span>Low
  </div>
</div>
```

## Colors

Add a `.signal-{color}` class to color the bars. Without it, the signal uses the secondary text color.

```html
<div class="d-flex gap-3">
  <span class="signal" role="img" aria-label="Level 2 of 3">
    <span class="signal-bar active"></span>
    <span class="signal-bar active"></span>
    <span class="signal-bar"></span>
  </span>
  <span class="signal signal-primary" role="img" aria-label="Level 2 of 3">
    <span class="signal-bar active"></span>
    <span class="signal-bar active"></span>
    <span class="signal-bar"></span>
  </span>
  <span class="signal signal-green" role="img" aria-label="Level 2 of 3">
    <span class="signal-bar active"></span>
    <span class="signal-bar active"></span>
    <span class="signal-bar"></span>
  </span>
  <span class="signal signal-red" role="img" aria-label="Level 2 of 3">
    <span class="signal-bar active"></span>
    <span class="signal-bar active"></span>
    <span class="signal-bar"></span>
  </span>
</div>
```

## Number of bars

Use from two to five bars. The component counts them and keeps the steps even, so no extra class is needed.

```html
<div class="d-flex gap-3">
  <span class="signal signal-primary" role="img" aria-label="Level 1 of 2">
    <span class="signal-bar active"></span>
    <span class="signal-bar"></span>
  </span>
  <span class="signal signal-primary" role="img" aria-label="Level 3 of 4">
    <span class="signal-bar active"></span>
    <span class="signal-bar active"></span>
    <span class="signal-bar active"></span>
    <span class="signal-bar"></span>
  </span>
  <span class="signal signal-primary" role="img" aria-label="Level 4 of 5">
    <span class="signal-bar active"></span>
    <span class="signal-bar active"></span>
    <span class="signal-bar active"></span>
    <span class="signal-bar active"></span>
    <span class="signal-bar"></span>
  </span>
</div>
```

## Size

A signal is a `1.25rem` square, the same as an extra small [avatar](/ui/components/avatar). Set `--tblr-signal-size` on the signal to resize it.

```html
<div class="d-flex align-items-end gap-3">
  <span class="signal signal-primary" style="--tblr-signal-size: 1rem" role="img" aria-label="Level 2 of 3">
    <span class="signal-bar active"></span>
    <span class="signal-bar active"></span>
    <span class="signal-bar"></span>
  </span>
  <span class="signal signal-primary" role="img" aria-label="Level 2 of 3">
    <span class="signal-bar active"></span>
    <span class="signal-bar active"></span>
    <span class="signal-bar"></span>
  </span>
  <span class="signal signal-primary" style="--tblr-signal-size: 1.5rem" role="img" aria-label="Level 2 of 3">
    <span class="signal-bar active"></span>
    <span class="signal-bar active"></span>
    <span class="signal-bar"></span>
  </span>
  <span class="signal signal-primary" style="--tblr-signal-size: 2rem" role="img" aria-label="Level 2 of 3">
    <span class="signal-bar active"></span>
    <span class="signal-bar active"></span>
    <span class="signal-bar"></span>
  </span>
</div>
```

## Accessibility

- Show the level with the number of lit bars, not with color alone. An orange and a green signal with the same bars look identical to many users.
- A signal without a text label needs `role="img"` and an `aria-label` that states the level, for example "Priority: urgent".
- A signal next to a label that already names the level is decoration. Hide it with `aria-hidden="true"`.
