Implementing Syncfusion Angular Bullet Chart
When to Use This Skill
Use this skill when you need to:
- Create a Bullet Chart component in an Angular application
- Display performance data with actual vs target comparisons
- Define and customize quality ranges (good, satisfactory, poor)
- Customize axes, labels, and data visualization elements
- Add accessibility features and keyboard navigation
- Configure tooltips, data labels, and animations
- Change chart orientation or apply themes
Component Overview
The Syncfusion Angular Bullet Chart is a specialized data visualization component designed for comparing actual values against target values. It's ideal for displaying performance metrics, progress tracking, and goal achievement visualization. The component displays:
- Value Bar (Actual Bar): The primary data measurement (feature measure)
- Target Bar (Comparative Bar): The goal or benchmark value
- Ranges: Color-coded zones representing quality levels (Good, Satisfactory, Poor)
- Axis: Configurable scale for data values
- Labels & Tooltips: Additional context and information on hover
Documentation and Navigation Guide
Getting Started
📄 Read: references/getting-started.md
- Installation and package setup (
@syncfusion/ej2-angular-charts
)
- Basic Bullet Chart initialization
- Angular CLI setup for Angular 21+
- Standalone component architecture
- Module injection for features (tooltips, etc.)
- Adding data source and basic configuration
Data Binding and Sources
📄 Read: references/data-binding.md
- Local data binding for static datasets
- Remote data binding for dynamic data
- Data source structure and field mapping
- Mapping valueField and targetField
- Dynamic data updates
Axes and Ranges Configuration
📄 Read: references/axes-and-ranges.md
- Major and minor tick customization
- Tick placement (inside/outside)
- Label formatting (number, percentage, currency)
- Axis label positioning and customization
- Category labels and custom label styles
- Opposed position for right-aligned axes
- Range definition and color customization
- Quality range visualization (Good, Satisfactory, Poor)
Visual Elements and Data Display
📄 Read: references/visual-elements.md
- Value bar styling and shape customization (Rect, Dot)
- Border and fill customization for actual bars
- Target bar types (Circle, Cross, Rect)
- Target bar color and width customization
- Data labels configuration and styling
- Tooltip setup and customization
- Tooltip templates with custom HTML
- Title and subtitle positioning
- Chart dimensions (pixels, percentage)
Customization and Styling
📄 Read: references/customization.md
- Horizontal vs Vertical orientation
- Right-to-left (RTL) support
- Animation configuration (duration, delay)
- Theme selection and application
- CSS customization approaches
- Responsive design patterns
Accessibility Features
📄 Read: references/accessibility.md
- WCAG 2.2, Section 508, and ADA compliance
- Keyboard navigation (Tab, Shift+Tab, Ctrl+P)
- Screen reader support and WAI-ARIA attributes
- Color contrast standards
- Mobile device support
Quick Start Example
Here's a minimal working example:
typescript
import { Component, OnInit } from '@angular/core';
import { BulletChartModule, BulletTooltipService } from '@syncfusion/ej2-angular-charts';
@Component({
imports: [BulletChartModule],
standalone: true,
selector: 'app-container',
template: `<ejs-bulletchart
[dataSource]='data'
valueField='value'
targetField='target'
[tooltip]='{ enable: true }'
title='Sales Performance'
[ranges]='ranges'>
</ejs-bulletchart>`,
providers: [BulletTooltipService]
})
export class AppComponent implements OnInit {
public data: any;
public ranges: any;
ngOnInit(): void {
this.data = [
{ value: 100, target: 80 },
{ value: 200, target: 180 }
];
this.ranges = [
{ end: 50, color: '#ffe0b2', opacity: 0.6 }, // Poor
{ end: 100, color: '#fff9c4', opacity: 0.6 }, // Satisfactory
{ end: 150, color: '#c8e6c9', opacity: 0.6 } // Good
];
}
}
Common Patterns
Pattern 1: Sales Performance Dashboard
When displaying sales metrics against targets:
typescript
data = [
{ category: 'Q1', value: 25000, target: 30000 },
{ category: 'Q2', value: 28000, target: 30000 },
{ category: 'Q3', value: 35000, target: 30000 }
];
ranges = [
{ end: 20000, color: '#ffe0b2' }, // Below Target
{ end: 30000, color: '#fff9c4' }, // On Target
{ end: 40000, color: '#c8e6c9' } // Above Target
];
Pattern 2: Employee Performance Ratings
When comparing individual performance scores:
typescript
data = [
{ name: 'Alice', value: 85, target: 80 },
{ name: 'Bob', value: 72, target: 80 },
{ name: 'Charlie', value: 90, target: 80 }
];
Pattern 3: KPI Tracking with Orientation
When space is limited or vertical display is preferred:
typescript
<ejs-bulletchart orientation='Vertical' ...></ejs-bulletchart>
Key Properties
| Property | Type | Purpose |
|---|
| Array | Array of data objects containing value and target fields |
| String | Property name for actual/feature measure value |
| String | Property name for target/comparative measure value |
| Array | Array of range objects defining quality zones |
| String | Title displayed at the top of chart |
| String | Subtitle for additional context |
| String | 'Horizontal' (default) or 'Vertical' |
| Object | Configuration for hover tooltips |
| Object | Configuration for value labels |
| String | Shape of value bar: 'Rect' (default) or 'Dot' |
| String | Shape of target bar: 'Rect', 'Circle', or 'Cross' |
| String/Number | Chart width in pixels or percentage |
| String/Number | Chart height in pixels or percentage |
| String | Theme name (Material, Fabric, Bootstrap, Tailwind, etc.) |
| Boolean | Enable right-to-left rendering |
| Object | Configuration for entrance animations |
Common Use Cases
API Reference
A complete API reference for the Syncfusion Angular
is available in the
folder. It lists component properties, methods, events, and usage notes that match the official API docs.
Read the full API reference here: references/api-reference.md
- Sales Performance Tracking: Display actual sales vs target with quality zones
- Quality Metrics: Monitor production quality against benchmarks
- HR Metrics: Track employee performance against goals
- Budget Analysis: Compare actual spending vs budgeted amounts
- Learning Progress: Show student progress toward learning objectives
- Health Metrics: Display health indicators against recommended values
- Project Status: Track project metrics against planned targets
Next Steps: Choose the reference file that matches your immediate need based on the guidance above, or start with getting-started.md if this is your first time using Bullet Chart.