benpickles/peity
Peity
Peity is a lightweight SVG data visualization library that transforms numeric text content and HTML attributes into small pie, donut, bar, and line charts. It functions as an attribute-driven renderer and a progressive enhancement tool, adding vector graphics to web pages by reading data directly from the DOM without requiring heavy JavaScript frameworks.
The library supports custom drawing functions and dynamic color assignments, allowing for the registration of new chart types and the use of custom functions to determine segment colors.
Its capability surface covers the rendering of mini data charts, such as sparklines and progress rings for dashboard metrics. It includes the ability to automatically redraw visualizations when underlying element text changes and allows for individual chart configuration through HTML data attributes.
Features
- SVG Data Visualization - Transforms numeric text and HTML attributes into lightweight SVG pie, donut, bar, and line charts.
- Micro-Data Visualizations - Provides a suite of lightweight SVG mini-charts including pie, donut, line, and bar visualizations.
- Bar Charts - Transforms comma-separated numeric lists into sparkline or bar-style SVG visualizations.
- Pie Charts - Converts numeric text into circular SVG pie and donut charts supporting proportional slices.
- SVG Path Calculations - Calculates precise arc and line coordinates to transform numeric arrays into scalable vector graphics.
- Vector Chart Generators - Generates scalable vector plots and charts directly from comma-separated numeric strings.
- SVG - Implements a framework for rendering data-driven charts using scalable vector graphics in the browser.
- Micro-Chart Widgets - Implements lightweight sparklines and progress rings for quick visual data indicators in dashboards.
- Graph SVG DOM Generators - Generates SVG elements in the browser DOM by mapping custom drawing functions to specific chart types.
- Data-to-SVG Generators - Implements a core engine that converts raw DOM text into structured SVG vector graphics.
- SVG Configuration Attributes - Uses HTML data attributes to configure visual settings and styles for individual vector chart instances.
- SVG Libraries - Provides a library for programmatic rendering of vector graphics with support for custom drawing functions.
- Data-Driven Color Mappings - Allows assigning chart colors dynamically using custom functions that evaluate data values.
- Dynamic Path Updating - Provides automatic updates to SVG vector paths when the underlying DOM element text changes.
- Custom Chart Type Registrations - Enables the extension of available visualizations by registering new chart types and drawing functions.
- Chart Extension Mechanisms - Supports registering custom chart types by mapping unique names to specific SVG drawing logic.
- Chart Redraw Triggers - Triggers an automatic redraw of the SVG chart when the underlying element's text content is modified.
- Dynamic Rendering Updaters - Provides a mechanism to automatically update the visual state of SVG charts in response to DOM text changes.
- Configuration Attributes - Provides a mechanism to configure chart settings and visual overrides directly via HTML data attributes.
- Progressive Enhancement Tools - Adds SVG visualizations to web pages by rendering data based on existing DOM text and attributes.
- Visual Data Enhancements - Enhances basic text content with SVG visualizations without requiring a complex JavaScript framework.
- SVG Path Redraws - Automatically recalculates and redraws SVG paths when the associated element text content changes.
- Data Visualization - Progress bars, line, and pie charts.
- Game Engines - Lightweight generator for sparkline-style charts.
Star history
How this analysis was created: This summary and feature list are AI-generated from collected project material and can contain mistakes. Stars, license and language are imported from GitHub. Inclusion does not mean that we have tested or audited this project. Check the source documentation for any feature you depend on. Learn more on our About page.
