Overrides the default colours.

Colours can either be a named palette defined in Contex.CategoryColourScale or a list of strings representing hex code of the colour as per CSS colour hex codes, but without the #. For example:

  barchart = BarChart.colours(barchart, ["fbb4ae", "b3cde3", "ccebc5"])

The colours will be applied to the data series in the same order as the columns are specified in set_val_col_names/2

Allows the axis tick labels to be overridden. For example, if you have a numeric representation of money and you want to have the value axis show it as millions of dollars you might do something like:

  # Turns 1_234_567.67 into $1.23M
  defp money_formatter_millions(value) when is_number(value) do
    "$#{:erlang.float_to_binary(value/1_000_000.0, [decimals: 2])}M"
  end

  defp show_chart(data) do
    BarChart.new(data)
    |> BarChart.custom_value_formatter(&money_formatter_millions/1)
  end

Specifies whether data labels are shown on the bars

Re-applies default settings.

Optionally specify a LiveView event handler. This attaches a phx-click attribute to each bar element. Note that it may not work with some browsers (e.g. Safari on iOS).

Forces the value scale to the given data range

Creates a new barchart from a dataset and sets defaults

Specifies whether the bars are drawn horizontally or vertically.

Specifies the padding between the category groups. Defaults to 2. Specified relative to the plot size.

Highlights a selected value based on matching category and series.

Sets the category column name. This must exist in the dataset.

This provides the labels for each bar or group of bars

Sets the value column names. Each must exist in the dataset.

This provides the value for each bar.

Specifies whether the bars are drawn stacked or grouped.