# XWUIAppRail

An application side rail: the brand, search and create elements it is given, grouped link items with icons, swatches, badges, statuses and pickers, footer links and a usage meter. It collapses to icons (and closes to its head bar on phones) and focuses the search on Ctrl+K / Cmd+K.

Items are real links, so navigation, middle-click and screen readers work as on any page; `selected` marks the current one. The brand, search and create fields take elements (for example composed XWUI components). Event: `toggle`.

## BasicUsage

A studio rail with groups, a badge and a usage meter.

```example
file: examples/BasicUsage.ts
html: examples/BasicUsage.html
title: BasicUsage
description: A studio rail with groups, a badge and a usage meter.
```

## Collapsed

The same rail collapsed to icons.

```example
file: examples/Collapsed.ts
html: examples/Collapsed.html
title: Collapsed
description: The same rail collapsed to icons.
```

```api
```