woven_ring_chart 2.0.2
woven_ring_chart: ^2.0.2 copied to clipboard
A woven doughnut chart for Flutter. Segments lap over one another like shingles, so every boundary between two colours is a true semicircle.
Changelog #
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
2.0.2 - 2026-10-11 #
Changed #
- Breaking: require Flutter 3.47.7 and Dart 3.13.5 or later. The chart API and Flutter-only runtime dependency remain unchanged.
- Migrate the showcase to
material_ui1.6.0 and update its link launcher tourl_launcher6.3.3.
Fixed #
- Keep extremely small finite positive values visible under the
enforcepolicy, even when normalization beside a much larger value underflows. - Keep charts without usable values idle during updates and controller replay,
and stop an active entrance when animation is changed to
none. - Keep dropped values from adding a neutral track during entrance animations.
- Render very large finite start angles at their equivalent rotation without losing segment geometry or gradient continuity.
- Apply translucency once to gradient overlaps, visible borders, and transitions between one and several segments. Keep opacity fades continuous through zero.
- Apply segment opacity once to the combined fill, border, and self-joint, including borders and surfaces in different colour spaces.
- Preserve the parent background behind translucent chart surfaces.
- Remove internal seams between translucent segments, including on web.
- Keep gradients continuous through single-segment entrances and when the sole positive value moves to another position in the segment list.
- Preserve head colours on long counterclockwise gradient segments.
- Carry the destination highlight through transitions that collapse several segments into a previously empty position.
- Ignore out-of-range highlight indices while a shrinking data list still has fading outgoing segments.
- Replace only the selected border's contribution when highlights change during interrupted transitions.
- Resolve surface-derived border colours immediately after interrupted data transitions.
- Preserve overlap order across the seam in dense, thick rings.
- Keep shadows outside the chart's hole on web.
- Correct the showcase's gradient snippet, narrow-screen links, and Android link fallback, and keep the deployed install line tied to a version available on pub.dev.
1.0.2 - 2026-08-07 #
Changed #
example/lib/main.dartis the short getting-started example, which is what pub.dev shows under Example. The showcase moved toexample/lib/showcase.dart.
1.0.1 - 2026-08-07 #
Changed #
- The example is now a single-page showcase, live at https://omar-hanafy.github.io/woven_ring_chart/, and the README links to it.
1.0.0 - 2026-08-07 #
Initial release.
Added #
WovenRingChart, a doughnut chart whose segments lap over one another in one consistent direction. Every boundary between two colours is the backward semicircle of a round cap, including the seam where the last segment closes onto the first. The chart is square and centres itself in whatever box it is given.WovenRingChart.emptyandWovenRingChart.loading, both the same diameter and thickness as a chart with data, so a screen does not reflow when the data arrives.WovenSegment, one coloured piece of the ring, carrying a value in any unit, a fill, an optional border, an optional accessibility label, and an opacity. Values are normalized against each other and their order is never changed.WovenFill, solid, an explicit gradient, orWovenFill.shadedderived from a single colour, andWovenBorder, an optional hairline. Borders are clipped inside the segment, so a bordered segment is never fatter than its neighbours and the ring's outer edge stays a circle.WovenRingStyle: thickness, overlap depth, start angle, direction, gradient axis and direction, surface colour, an optionalWovenShadowunder every segment head, and the two policies below. Every measurement is a fraction of the outer diameter, so one style renders correctly at any size.WovenSmallValuePolicy, choosing whether a value too small to draw is raised to one ring-thickness of arc with the rest rescaled, or allowed to vanish under its neighbour with the proportions left truthful.WovenSingleSegmentStyle, choosing whether a lone value covering the whole ring keeps a visible self-joint. It renders as a plain continuous ring by default.- Two entrance animations,
WovenRingAnimation.sweepandWovenRingAnimation.grow, andWovenRingChartController.replay()to run one again. Data changes animate in place: segments stretch and shrink and colours crossfade, so the chart never blinks. Retargeting mid-flight starts from the frame already on screen. highlightedIndexandhighlightBorder, giving one segment a border while the others stay unbordered.MediaQuery.disableAnimationssupport, completing entrances and data changes immediately.- Semantics:
semanticLabelandsemanticValuefor the chart, or per-segment labels that are joined when no chart-level label is given. Labelling segments does not remove the centre widget from the accessibility tree, and the loading chart announces itself as a live region. WovenPalette, a reference set of colours plusWovenPalette.cycle, which repeats a palette without letting a colour touch itself across the seam.WovenRingGeometry,WovenSegmentExtent, andwovenSegmentFractions, the geometry and normalization the chart uses, exported so they can be measured against or reused directly.
