# `LedgerUI.Components.Cover`
[🔗](https://github.com/devaction-labs/ledger_ui/blob/v0.2.0/lib/ledger_ui/components/cover.ex#L1)

The canvas cover: a wide band in the accent gradient (or a quiet surface) that heads a profile
or a page, with a title on it, or a record's avatar overlapping its lower edge.

    <.cover title="Distribuidora Sertão" />

    <.cover height={110} title="Distribuidora Sertão" subtitle="Cliente desde 2021">
      <:avatar><.avatar name="Distribuidora Sertão" tint="#1a7f4b" size="64" shape="rounded" /></:avatar>
    </.cover>

    <.cover tone="neutral" height={120} />

`tone` is `accent` (the teal gradient, white text) or `neutral` (the sunken surface). `src`
lays a picture over the band. Without `:avatar` the `title` is written on the band, at the
bottom; with it, the avatar overlaps the band's lower edge with the `title` and `subtitle`
beside it. The inner block goes on the band (actions, a badge).

# `cover`

## Attributes

* `tone` (`:string`) - Defaults to `"accent"`. Must be one of `"accent"`, or `"neutral"`.
* `height` (`:integer`) - The band's height in pixels. Defaults to `180`.
* `src` (`:string`) - A picture that covers the band. Defaults to `nil`.
* `title` (`:string`) - Defaults to `nil`.
* `subtitle` (`:string`) - Defaults to `nil`.
* `class` (`:any`) - Defaults to `nil`.
* Global attributes are accepted.
## Slots

* `avatar` - An avatar that overlaps the band's lower edge.
* `inner_block` - Content on the band.

# `cover_card`

Same as `cover/1` (same attributes and slots), under the name the design vitrine uses.
## Attributes

* `tone` (`:string`) - Defaults to `"accent"`. Must be one of `"accent"`, or `"neutral"`.
* `height` (`:integer`) - The band's height in pixels. Defaults to `180`.
* `src` (`:string`) - A picture that covers the band. Defaults to `nil`.
* `title` (`:string`) - Defaults to `nil`.
* `subtitle` (`:string`) - Defaults to `nil`.
* `class` (`:any`) - Defaults to `nil`.
* Global attributes are accepted.
## Slots

* `avatar` - An avatar that overlaps the band's lower edge.
* `inner_block` - Content on the band.

---

*Consult [api-reference.md](api-reference.md) for complete listing*
