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

Chart utilities toolbar.

Inspired by eCharts `toolbox` — provides a button group with common chart
utilities: download SVG, reset zoom, toggle series visibility.

Uses `Phoenix.LiveView.JS` for client-side interactions (no custom JS hooks).

## Examples

    <.chart_toolbox
      chart_id="my-chart"
      tools={[:download, :reset]}
    />

    <.chart_toolbox
      chart_id="revenue-chart"
      tools={[:toggle_series]}
      all_series={["Revenue", "Cost", "Profit"]}
      visible_series={["Revenue", "Cost"]}
      on_toggle_series="toggle-series"
    />

# `chart_toolbox`

## Attributes

* `chart_id` (`:string`) (required) - ID of the target chart SVG container.
* `tools` (`:list`) - List of tools to show. Options: :download, :reset, :toggle_series. Defaults to `[:download, :reset, :toggle_series]`.
* `visible_series` (`:list`) - Currently visible series names. Defaults to `[]`.
* `all_series` (`:list`) - All available series names. Defaults to `[]`.
* `on_toggle_series` (`:string`) - Event name for series toggle. Defaults to `nil`.
* `on_reset_zoom` (`:string`) - Event name for zoom reset. Defaults to `nil`.
* `position` (`:atom`) - Toolbar position. Defaults to `:top_right`. Must be one of `:top_right`, `:top_left`, `:bottom_right`, or `:bottom_left`.
* `class` (`:string`) - Defaults to `nil`.
* Global attributes are accepted.

---

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