# `ExRatatui.Widgets.LineGauge`
[🔗](https://github.com/mcass19/ex_ratatui/blob/v0.10.1/lib/ex_ratatui/widgets/line_gauge.ex#L1)

A thin horizontal progress bar widget.

Similar to `ExRatatui.Widgets.Gauge` but renders as a single line using
line-drawing characters.

## Fields

  * `:ratio` - progress value, a number in `0.0..1.0`. Integers `0` and `1`
    are accepted and coerced to floats. Any other value raises
    `ArgumentError` at render time.
  * `:label` - optional label string displayed alongside the gauge
  * `:style` - `%ExRatatui.Style{}` for the widget background
  * `:filled_style` - `%ExRatatui.Style{}` for the filled portion
  * `:unfilled_style` - `%ExRatatui.Style{}` for the unfilled portion
  * `:block` - optional `%ExRatatui.Widgets.Block{}` container

## Examples

    iex> %ExRatatui.Widgets.LineGauge{ratio: 0.6, label: "60%"}
    %ExRatatui.Widgets.LineGauge{
      ratio: 0.6,
      label: "60%",
      style: %ExRatatui.Style{},
      filled_style: %ExRatatui.Style{},
      unfilled_style: %ExRatatui.Style{},
      block: nil
    }

# `t`

```elixir
@type t() :: %ExRatatui.Widgets.LineGauge{
  block: ExRatatui.Widgets.Block.t() | nil,
  filled_style: ExRatatui.Style.t(),
  label: String.t() | nil,
  ratio: float(),
  style: ExRatatui.Style.t(),
  unfilled_style: ExRatatui.Style.t()
}
```

---

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