syncfusion-react-circular-gauge

Implement Syncfusion React Circular Gauge for displaying KPIs, sensor data, speedometers, and real-time monitoring dashboards. Use this skill when users need to visualize quantitative measurements on a circular scale. Covers axes, pointers, ranges, customization, animations, print/export, accessibil

By syncfusion · 555 installs

npx skills add syncfusion/react-ui-components-skills --skill syncfusion-react-circular-gauge

Source repository · Upstream listing

Implementing Syncfusion React Circular Gauge When to Use This Skill Use the Circular Gauge component when you need to: Display measurements on a circular scale (speedometers, temperature gauges, fuel indicators) Monitor KPIs and metrics in dashboards (business metrics, sensor readings) Visualize progress or percentages in a circular format Show real time data with animated pointer updates Create responsive data visualizations with multiple pointers and ranges Print or export gauge visualizations for reports The Circular Gauge is ideal for applications requiring visual representation of values on a circular scale with customizable appearance, animations, and interactivity. Component Overview Syncfusion React Circular Gauge ( @syncfusion/ej2 react circulargauge ) is a data visualization component that displays values on a circular scale. It consists of: Axes The circular scale tracks with customizable angles, direction, and styling Pointers Value indicators in three types: Needle (default), RangeBar, or Marker Ranges Colored segments representing value ranges (e.g., 0 25%, 25 50%) Annotations Text or image overlays for labels and callouts Legend Optional legend displaying range meanings Export Print, PDF, PNG, or SVG export capabilities Documentation and Navigation Guide Choose the reference based on what you need to implement: Getting Started & Setup 📄 Read: [references/getting started.md](references/getting started.md) Install @syncfusion/ej2 react circulargauge package Setup in Vite or Create React App Basic component initialization Minimal working example CSS imports and themes When to read: First time setup or new project integration Gauge Structure: Axes, Pointers & Ranges 📄 Read: [references/axes pointers ranges.md](references/axes pointers ranges.md) Configure axes (angles, direction, styling) Add and customize pointers (Needle, RangeBar, Marker types) Define ranges with colors and labels Multiple axes and pointers When to read: Building the core gauge structure and data visualization Visual Appearance & Dimensions 📄 Read: [references/appearance dimensions.md](references/appearance dimensions.md) Add titles and customize styling Position gauge (centerX, centerY) Set dimensions (width, height, margin) Apply backgrounds, borders, color schemes Responsive design When to read: Customizing gauge look, sizing, and layout Annotations & Legend 📄 Read: [references/annotations legend.md](references/annotations legend.md) Add text annotations Add image annotations Position annotations Display and customize legend Handle legend interactions When to read: Adding labels, callouts, or explanatory elements Advanced Features 📄 Read: [references/advanced features.md](references/advanced features.md) Animation effects and timing User interaction (events, tooltips) Print and export to PDF/PNG/SVG Real time data binding Multiple gauge instances When to read: Adding interactions, animations, or export functionality API Reference 📄 Read: [references/api reference.md](references/api reference.md) Component props, events, methods, and child directive reference Quick lookup for commonly used props, methods and event args When to read: When you need exact API names, types or method signatures Accessibility & Internationalization 📄 Read: [references/accessibility i18n.md](references/accessibility i18n.md) WCAG 2.1 compliance and ARIA support Screen reader compatibility Keyboard navigation RTL language support Localization and culture settings When to read: Making gauges accessible or supporting multiple languages Common Patterns & Use Cases 📄 Read: [references/common patterns.md](references/common patterns.md) Speedometer pattern Progress/percentage gauge pattern Temperature/sensor monitoring Multi pointer dashboards Real time updates with animations Performance tips and troubleshooting When to read: Looking for common implementations or solving issues Quick Start Example Here's a minimal working example to get started: Install the package first: Common Patterns Pattern 1: Simple Progress Indicator Pattern 2: Multi Pointer Dashboard Use multiple pointers on the same axis to compare values: Pattern 3: Real Time Updates Key Configuration Props Prop Type Purpose title string Gauge title displayed at top centerX / centerY string Position (% or px) startAngle / endAngle number Axis sweep degrees (0 360) minimum / maximum number Axis scale range value (pointer) number Current pointer value type (pointer) 'Needle' \ 'RangeBar' \ 'Marker' Pointer visualization type radius (pointer) string Pointer length (% or px) color string Element color (hex, rgb, name) direction 'ClockWise' \ 'AntiClockWise' Axis direction animationDuration number Animation time in milliseconds For the complete API listing (all component props, events, methods and child directives) see: [references/api reference.md](references/api reference.md) Common Use Cases 1. Speedometer/Speed Monitor Display vehicle speed with colored ranges 2. Temperature Gauge Monitor temperature with hot/cold indicators 3. Performance KPI Show system metrics or business KPIs 4. Fuel/Battery Level Visualize resource consumption 5. Network Traffic Display bandwidth usage in real time 6. Sports/Gaming Scores Show player stats or game progress 7. Industrial Monitoring Sensor data visualization 8. Percentage/Progress Alternative circular progress visualization Next Steps 1. Start with Getting Started to set up your first gauge 2. Build structure using Axes, Pointers & Ranges reference 3. Customize appearance with styling reference 4. Add interactions with Advanced Features reference 5. Test accessibility using Accessibility reference 6. Reference common patterns for implementation ideas For more details or advanced scenarios, consult the specific reference files linked above.