General chart
LesliView::Charts::General is the shared ViewComponent base for Lesli charts. Applications normally render Bar or Line; subclasses supply the Chart.js type and dataset defaults.
<%= render LesliView::Charts::Bar.new(
id: "tickets-chart",
title: "Tickets",
subtitle: "Created this week",
labels: ["Mon", "Tue", "Wed"],
datasets: [{ label: "Created", data: [4, 7, 3] }],
height: "320px",
compact: false
) %>
| Option | Default | Purpose |
|---|---|---|
id: | Generated | DOM target passed to the JavaScript chart renderer |
title: | nil | Accessible chart heading and default single-dataset label |
subtitle: | nil | Supporting copy |
labels: | [] | X-axis labels |
dataset: | nil | Shorthand for one data series |
datasets: | nil | Array of Chart.js-compatible dataset hashes |
database_to_dataset: | nil | Records with xaxiskey and yaxiskey fields for one series |
database_to_datasets: | nil | Records with dataname, xaxiskey, and yaxiskey fields |
height: | 400px | CSS length; invalid values fall back to 400px |
compact: | false | Uses the compact title presentation |
If several data inputs are supplied, later conversion options take precedence over datasets and dataset. Database conversion helpers are also available as database_to_dataset and database_to_datasets for compatibility.
The rendered page requires the window.LesliChart JavaScript provided by the Lesli frontend assets. Rendering waits for Turbo when the document is still loading.
Component files
lib/lesli_view/charts/
bar.rb
line.rb
general.rb
general/
general.html.erb
general.css
Bar and Line inherit the template from General, so they do not need separate directories or duplicated presentation files. Their Ruby API is unchanged.
The sidecar stylesheet uses semantic classes and unprefixed @apply, and is imported by source/tailwind/view.css into the existing LesliView stylesheet. Global theme variables remain in LesliAssets.
Last Update: 2026/11/18