# `PhiaUi.Components.DonutChart`
[🔗](https://github.com/charlenopires/PhiaUI/blob/v0.1.17/lib/phia_ui/components/data/donut_chart.ex#L1)

Donut chart with a center slot — pure SVG, zero JS.

Uses ring-shaped arc paths (outer + inner radius). Supports a `:center`
slot for custom content (metric value, icon, etc.).

## Examples

    <.donut_chart data={[
      %{label: "Completed", value: 70},
      %{label: "Pending",   value: 20},
      %{label: "Failed",    value: 10}
    ]}>
      <:center>70%</:center>
    </.donut_chart>

    <.donut_chart
      data={[%{label: "Used", value: 80}, %{label: "Free", value: 20}]}
      hole_ratio={0.65}
    />

# `donut_chart`

## Attributes

* `data` (`:list`) (required) - List of `%{label, value}` (and optional `:color`).
* `colors` (`:list`) - Override default palette. Defaults to `[]`.
* `hole_ratio` (`:float`) - Ratio of inner radius to outer (0.3–0.8). Controls ring thickness. Defaults to `0.55`.
* `show_legend` (`:boolean`) - Defaults to `true`.
* `animate` (`:boolean`) - Defaults to `true`.
* `animation_duration` (`:integer`) - Defaults to `600`.
* `spacing` (`:integer`) - Gap in pixels between slices (0-8). Defaults to `0`.
* `show_link_labels` (`:boolean`) - Show leader lines from slices to external labels. Defaults to `false`.
* `show_values` (`:boolean`) - Show data values alongside labels in the legend. Defaults to `false`.
* `active_shape` (`:boolean`) - Enable hover expand effect on slices (Recharts activeShape pattern). Defaults to `false`.
* `active_expand` (`:integer`) - Radius expansion in px on hover when active_shape is true. Defaults to `6`.
* `id` (`:string`) - Unique ID for the chart (auto-generated if not provided). Defaults to `nil`.
* `title` (`:string`) - Chart title rendered above the visualization. Defaults to `nil`.
* `description` (`:string`) - Chart description for context (rendered below title). Defaults to `nil`.
* `class` (`:string`) - Defaults to `nil`.
* Global attributes are accepted.
## Slots

* `center` - Content rendered in the donut center (text, value, etc.).

---

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