Revision history for HTML-D3 - Visualise various charts using D3
0.16 Mon Sep 21 07:34:35 PM EDT 2026
[ Enhancements ]
- render_heatmap_snippet: new snippet method that generates an embeddable
D3 v7 grid heatmap. Accepts an array of [$x, $y, $value] triples and an
optional \%opts hashref with keys: color_scheme (YlOrRd/Blues/Greens/
Purples/RdPu/YlGnBu, default YlOrRd), x_label, y_label, val_label
(tooltip label, default 'Value'), show_values (print value in each cell,
auto-suppressed when cell < 28px), cell_padding (0-8 px gap, default 2),
legend (colour-scale bar, default on), animated (fade-in with
prefers-reduced-motion support, default off). Returns
{ svg_id => 'heatmap', html => Str }. undef values are silently skipped;
duplicate (x, y) pairs: last write wins. Requires Scalar::Util
looks_like_number (already in core distribution).
0.15 Wed Sep 16 01:51:38 PM EDT 2026
[ Enhancements ]
- render_pie_chart, render_animated_pie_chart, render_pie_chart_snippet: new
optional C<separator> key in the C<%opts> second argument controls the
character shown between label and value in the legend (default C<'/'>).
render_pie_chart and render_animated_pie_chart now accept the optional
second hashref argument for the first time; existing callers passing only
C<$data> are unaffected.
0.14 Tue Sep 15 09:12:17 PM EDT 2026
[ Enhancements ]
- render_pie_chart_snippet: major upgrade. Now accepts an optional second
argument \%opts with six keys:
- animated (bool, default 0): fan slices in from arc-length 0 using
attrTween / d3.easeBackOut.overshoot(1.2) with 800 ms staggered
transitions; legend fades in after; respects prefers-reduced-motion
- donut (bool, default 0): inner radius 38% of outer; total sum shown
in the centre hole
- sort_slices ('value'|'label'|'none', default 'none'): sort order
- max_slices (int, default 0): collapse tail into an "Other" slice
- legend (bool, default 1): HTML legend panel with colour swatches
- color_scheme (string, default 'tableau10'): supports tableau10,
category10, set2, set3, paired
Negative values are silently converted to their absolute value; zero-
value slices are silently omitted. Optional \%extra hashref per data
point is shown as additional rows in the hover tooltip.
svg_id changes from 'chart' to 'pie_chart' for namespace clarity.
(Breaking change in svg_id value; all other behaviour is backward-
compatible when opts are omitted.)
0.13 Tue Sep 15 06:05:45 PM EDT 2026
[ Enhancements ]
- render_zoomable_line_chart_snippet: accept an optional second argument
{ animated => 1 } to animate the initial line draw on page load.
The line traces itself left-to-right via stroke-dashoffset / d3.easeLinear
(1200 ms); data-point circles then fade in from opacity 0 over 300 ms
(after a 1200 ms delay so they appear only once the line reaches them).
Subsequent zoom and reset redraws are never animated.
Respects prefers-reduced-motion: when the user has requested reduced
motion the chart draws immediately at full opacity.
Omitting the second argument or passing { animated => 0 } gives the
existing behaviour unchanged (backward-compatible).
0.12 Sun Sep 13 08:14:05 AM EDT 2026
[ Enhancements ]
- Added render_animated_bar_chart(): bar chart with on-load grow animation —
each bar rises from the baseline using d3.transition() with an 800 ms
duration and a 100 ms per-bar stagger, so bars appear one after another
from left to right
- Added render_animated_line_chart(): line chart with on-load draw animation —
the line traces itself left-to-right via the stroke-dashoffset technique with
d3.easeLinear (1500 ms), followed by data-point circles fading in from
opacity 0 once the line is complete
- Added render_pie_chart(): full-page pie chart with percentage labels inside
each slice and a colour legend; slices coloured with d3.schemeCategory10
- Added render_animated_pie_chart(): same as render_pie_chart() but slices fan
out from zero on page load via attrTween/d3.interpolate (1000 ms), with
percentage labels fading in once drawing is complete
- Added render_pie_chart_snippet(): embeddable pie chart fragment returning
{svg_id, html} — no page shell, no D3 CDN tag; caller loads D3
[ Tests ]
- Test::HTML::T5 doesn't build on a number of platforms, so
remove the dependancy. Hopefully this will be fixed at sometime.
0.11 Thu Sep 10 09:32:08 PM EDT 2026
[ Bug Fixes ]
- render_zoomable_line_chart_snippet: the y-axis lower bound was
hard-coded to 0, causing data points with negative Y values to be
plotted off-screen below the x-axis. Changed to
Math.min(0, d3.min(newData, d => d.value)) so the domain extends
downward when the data contains negative values (e.g.
accounting-notation amounts).
0.10 Fri Aug 28 08:57:09 PM EDT 2026
[ Enhancements ]
- Added render_zoomable_line_chart_snippet(): embeddable line chart with brush-to-zoom — drag to select an x-axis range, animated transition to the zoomed view, incremental re-zoom on the zoomed view, and a Reset zoom button to restore the full dataset
0.09 Thu Aug 27 09:16:02 PM EDT 2026
[ Enhancements ]
- render_line_chart_snippet: accept an optional third element per data pair — a hashref of extra key/value pairs serialised as an "extra" property in the D3 data binding and appended as additional rows in the mouseover tooltip
0.08 Thu Aug 27 01:30:10 PM EDT 2026
[ Enhancements ]
- Use Params::Get
- Added test dashboard
- Added support for Object::Configure
- Added render_line_chart_snippet() returning an embeddable {svg_id, html} fragment for use in Mojolicious TT (and similar) layouts without post-processing
[ Bug Fixes ]
- Escape </b> as <\/b> in all JavaScript tooltip .html() strings to fix html-tidy '<' + '/' + letter failures on cpantesters
https://www.cpantesters.org/cpan/report/8321add6-d178-11ef-8e88-00fe6d8775ea
0.07 Fri Jan 10 21:16:49 EST 2025
Added support for interactive legends
0.06 Thu Jan 9 21:51:36 EST 2025
Added support for legends
0.05 Wed Jan 8 21:04:21 EST 2025
Added support for animated tooltips
0.04 Tue Jan 7 21:26:42 EST 2025
Added support for line charts with tooltips
Added support for multiple line charts with tooltips
0.03 Mon Jan 6 20:55:12 EST 2025
Added line chart support
Use JSON::MaybeXS instead of JSON
0.02 Mon Jan 6 10:13:11 EST 2025
Fix CI breakage
0.01 Mon Jan 6 09:47:22 EST 2025
First draft - POC: generates bar charts only
Keyboard Shortcuts
Global
s
Focus search bar
?
Bring up this help dialog
GitHub
gp
Go to pull requests
gi
Go to GitHub issues (only if GitHub is preferred repository)