# Pie Chart
> Pie charts with custom HTML tooltips for showing proportions
Source: https://shellui.dev/docs/v0.3/components/advanced/charts/pie-chart
The `PieChart` component renders pie charts with custom HTML tooltips, ideal for showing proportions, distributions, and part-to-whole relationships. Built on **ApexCharts.Blazor** with ShellUI's shadcn-inspired tooltip styling.
## Installation
```bash
shellui add chart pie-chart
```
`chart` and its styles are installed as dependencies, and the `Blazor-ApexCharts` NuGet package is added for you.
## Basic Usage
```razor
@code {
private List browserData = new()
{
new("Chrome", 65), new("Firefox", 12),
new("Safari", 15), new("Edge", 8)
};
record BrowserShare(string Browser, double Percentage);
}
```
## Team Allocation
```razor
@code {
private List teamData = new()
{
new("Engineering", 42), new("Product", 12),
new("Design", 8), new("Marketing", 15),
new("Sales", 20), new("Support", 10)
};
record TeamAllocation(string Department, int Count);
}
```
## Budget Breakdown
```razor
@code {
private List budgetData = new()
{
new("Infrastructure", 4500),
new("Salaries", 35000),
new("Marketing", 8000),
new("Tools & Software", 2500),
new("Office", 3000)
};
record BudgetCategory(string Category, decimal Amount);
}
```
## Custom Tooltips
The `PieChart` component includes custom HTML tooltips styled to match ShellUI's design system. Tooltips automatically show category label, value, percentage of total, and color-coded indicators — no additional configuration needed.
## API Reference
| Property | Type | Default | Description |
|----------|------|---------|-------------|
| `TItem` | Generic type | — | The data item type |
| `Data` | `IEnumerable?` | `null` | Data collection to visualize |
| `Name` | `string` | `"Data"` | Series name shown in tooltip |
| `XValue` | `Func?` | `null` | Function to extract category label |
| `YValue` | `Func?` | `null` | Function to extract numeric value |
| `Theme` | `ChartTheme` | `Default` | Color theme (Default, Colorful, Monochrome) |
| `Title` | `string?` | `null` | Chart title |
| `Subtitle` | `string?` | `null` | Chart subtitle |
| `Height` | `string?` | `"400px"` | Chart height |
| `Width` | `string?` | `"100%"` | Chart width |
| `Class` | `string?` | `null` | Additional CSS classes |