Font Awesome Build Awesome
Try SSR Server-side rendering (SSR) generates component HTML on the server before the page loads, improving SEO and initial load time. Use the switch to see Web Awesome components render with and without SSR.
Search this website ⌘KCtrl+K Light Dark System Docs Select Color Scheme Default Awesome Shoelace Active Brutalist Glossy Matter Mellow Playful Premium Tailspin Docs Select Theme View Project on GitHub Star Project on GitHub
Start Components Docs Help
Login Log into your account
Web Awesome Font Awesome Build Awesome
Search this site… /
Try SSR Server-side rendering (SSR) generates component HTML on the server before the page loads, improving SEO and initial load time. Use the switch to see Web Awesome components render with and without SSR.
Light Dark System Docs Select Color Scheme Default Awesome Shoelace Active Brutalist Glossy Matter Mellow Playful Premium Tailspin Docs Select Theme

Getting Started

  • Installation
  • Usage
  • Forms
  • Localization
  • Frameworks
  • Using with AI
  • Figma Design Kit ProThis requires access to Web Awesome Pro
  • Server Rendering

Resources

  • Accessibility
  • Browser Support
  • Contributing
  • Patterns ProPatterns require access to Web Awesome Pro
  • Migrating from Shoelace
  • Visual Tests
  • Changelog
  • Help & Support

Theming & Utilities

  • Overview
  • Built-in Themes
  • Color Palettes
  • Design Tokens
  • Customizing & Theming
  • CSS Utilities

Actions

  • Button
  • Button Group
  • Copy Button
  • Dropdown
    • Dropdown Item

Forms

  • Checkbox
  • Checkbox Group
  • Color Picker
  • Combobox ProThis requires access to Web Awesome Pro
  • Date Input ProThis requires access to Web Awesome Pro
  • Date Picker ProThis requires access to Web Awesome Pro
  • File Input ProThis requires access to Web Awesome Pro
  • Input
  • Known Date
  • Number Input
  • OTP Input
  • Radio Group
    • Radio
  • Rating
  • Select
    • Option
  • Slider
  • Switch
  • Textarea
  • Time Input

Layout

  • Accordion
    • Accordion Item
  • Card
  • Details
  • Dialog
  • Divider
  • Drawer
  • Page
  • Scroller
  • Split Panel

Navigation

  • Breadcrumb
    • Breadcrumb Item
  • Pagination
  • Tab Group
    • Tab
    • Tab Panel
  • Tree
    • Tree Item

Feedback

  • Badge
  • Callout
  • Progress Bar
  • Progress Ring
  • Skeleton
  • Spinner
  • Tag
  • Toast
    • Toast Item
  • Tooltip

Media

  • Animated Image
  • Avatar
  • Carousel
    • Carousel Item
  • Comparison
  • Icon
  • Markdown
  • QR Code
  • Video ProThis requires access to Web Awesome Pro
  • Video Playlist ProThis requires access to Web Awesome Pro
  • Zoomable Frame

Data Viz ProThis requires access to Web Awesome Pro

  • Bar Chart
  • Bubble Chart
  • Data Grid
  • Doughnut Chart
  • Line Chart
  • Pie Chart
  • Polar Area Chart
  • Radar Chart
  • Scatter Chart
  • Sparkline
  • Advanced Usage

Helpers

  • Animation
  • Format Bytes
  • Format Date
  • Format Number
  • Include
  • Intersection Observer
  • Mutation Observer
  • Popover
  • Popup
  • Random Content
  • Relative Time
  • Resize Observer

Pie Chart

  • Examples
  • Providing Data with JSON
  • Providing Data with JavaScript
  • Colors
  • Legend
  • Disabling Features
  • API
  • Importing
  • Slots
  • Attributes & Properties
  • CSS Custom Properties
On This Page...
  • Examples
  • Providing Data with JSON
  • Providing Data with JavaScript
  • Colors
  • Legend
  • Disabling Features
  • API
  • Importing
  • Slots
  • Attributes & Properties
  • CSS Custom Properties

Pie Chart

<wa-pie-chart>
ProIncluded with Web Awesome Pro Stable Data Viz Since 3.3

Pie charts show the proportional composition of a whole as slices of a circle. They work best with a small number of categories where the relative proportions matter more than exact values.

Get Pie Chart with Web Awesome Pro! Subscribing to Web Awesome Pro gives you every Pro component, plus premium themes, color tools, team collaboration, and more.
  • Pro Components
  • Responsive Layout Tools
  • Ever-Growing Pattern Library
  • Unlimited Hosted Projects
  • Pre-Built Pro Themes
  • Pro Theme Builder
  • Pro Color Tools
  • Official Figma Design Kit Newer additions to Web Awesome, like <wa-toast>, aren't included in the currently available kit, but a new version is in the works.
    Track its progress on GitHub.
  • WA Pro Perpetual License
  • Actual Human™ Support
Get Web Awesome Pro + Pie Chart!

Already have Pro? Log in

<wa-pie-chart
  label="Browser Market Share"
  description="A pie chart showing browser market share with Chrome leading at 65%"
>
  <script type="application/json">
    {
      "data": {
        "labels": ["Chrome", "Safari", "Firefox", "Edge", "Other"],
        "datasets": [{ "label": "Market Share", "data": [65, 18, 8, 5, 4] }]
      }
    }
  </script>
</wa-pie-chart>

See <wa-chart> for advanced configuration, custom plugins, and direct Chart.js access.

Examples

Link to This Section

Providing Data with JSON

Link to This Section

Place a <script type="application/json"> tag inside the component with your chart data. Each value in the data array corresponds to a label. The JSON follows the Chart.js configuration format.

<wa-pie-chart label="Budget Allocation" description="A pie chart showing how a budget is allocated across departments">
  <script type="application/json">
    {
      "data": {
        "labels": ["Engineering", "Marketing", "Sales", "Operations"],
        "datasets": [
          {
            "label": "Budget",
            "data": [40, 25, 20, 15]
          }
        ]
      }
    }
  </script>
</wa-pie-chart>

Providing Data with JavaScript

Link to This Section

Set the config property from JavaScript when your data comes from code rather than static markup. The chart re-renders automatically each time you assign it. For data that updates at runtime, try the live controls in Accessing the Chart.js Instance.

<wa-pie-chart id="pie-js-example" label="Budget Allocation" description="A pie chart of budget allocation">
</wa-pie-chart>
<script type="module">
  const chart = document.querySelector('#pie-js-example');

  chart.config = {
    data: {
      labels: ['Engineering', 'Marketing', 'Sales', 'Operations'],
      datasets: [
        {
          label: 'Budget',
          data: [40, 25, 20, 15],
        },
      ],
    },
  };
</script>

config is shallowly reactive.
If you mutate the object in place, reassign it to trigger a re-render.

Colors

Link to This Section

Override the default color palette using the --fill-color-* and --border-color-* CSS custom properties to apply custom colors to each slice.

<wa-pie-chart
  id="pie-colors"
  label="Custom Colors"
  description="A pie chart with custom slice colors"
  style="
    --fill-color-1: color-mix(in srgb, var(--wa-color-blue-60) 70%, transparent);
    --border-color-1: var(--wa-color-blue-60);
    --fill-color-2: color-mix(in srgb, var(--wa-color-cyan-60) 70%, transparent);
    --border-color-2: var(--wa-color-cyan-60);
    --fill-color-3: color-mix(in srgb, var(--wa-color-purple-60) 70%, transparent);
    --border-color-3: var(--wa-color-purple-60);
  "
>
</wa-pie-chart>
<script type="module">
  const chart = document.querySelector('#pie-colors');

  chart.config = {
    data: {
      labels: ['Desktop', 'Mobile', 'Tablet'],
      datasets: [
        {
          label: 'Traffic',
          data: [55, 35, 10],
        },
      ],
    },
  };
</script>

Legend

Link to This Section

Use the legend-position attribute to control where the legend appears. For pie charts, placing the legend on the side can help prevent overlap. Add without-legend to hide it entirely.

<wa-pie-chart
  id="pie-legend"
  legend-position="right"
  label="Legend on Right"
  description="A pie chart with the legend on the right side"
>
</wa-pie-chart>
<script type="module">
  const chart = document.querySelector('#pie-legend');

  chart.config = {
    data: {
      labels: ['Rent', 'Food', 'Transport', 'Entertainment', 'Savings'],
      datasets: [
        {
          label: 'Monthly Spending',
          data: [35, 25, 15, 10, 15],
        },
      ],
    },
  };
</script>

Disabling Features

Link to This Section

Use without-tooltip to hide hover tooltips and without-animation to disable transitions.

<wa-pie-chart
  id="pie-disabled"
  without-tooltip
  without-animation
  label="Minimal"
  description="A pie chart with tooltips and animations disabled"
>
</wa-pie-chart>
<script type="module">
  const chart = document.querySelector('#pie-disabled');

  chart.config = {
    data: {
      labels: ['Latte', 'Cold Brew', 'Espresso'],
      datasets: [
        {
          label: 'Daily Orders',
          data: [52, 30, 18],
        },
      ],
    },
  };
</script>

API

Link to This Section

Importing

Link to This Section

If you're using the autoloader or a hosted project, components load on demand — no manual import needed. To cherry-pick a component manually, use one of the following snippets.

CDN npm Self-Hosted React

Import this component directly from the CDN:

import 'https://ka-f.webawesome.com/[email protected]/components/pie-chart/pie-chart.js';

After installing Web Awesome via npm, import this component:

import '@awesome.me/webawesome/dist/components/pie-chart/pie-chart.js';

If you're self-hosting Web Awesome, import this component from your server:

import './webawesome/dist/components/pie-chart/pie-chart.js';

To import this component for React 18 or below, use the following code:

import WaPieChart from '@awesome.me/webawesome/dist/react/pie-chart/index.js';

Slots

Link to This Section

Learn more about using slots.

Name Description
(default) An optional <script type="application/json"> element containing the Chart.js configuration object.

Attributes & Properties

Link to This Section

Learn more about attributes and properties.

Name Description Reflects
config
The Chart.js configuration object. Setting this property will automatically re-render the chart.
Type ChartJS['config']
description
description
A description of the chart, used for accessibility.
Type string | null
Default null
grid
grid
Which axes to show grid lines on.
Type 'x' | 'y' | 'both' | 'none'
Default 'both'
indexAxis
index-axis
The base axis of the dataset. 'x' for vertical bars and 'y' for horizontal bars.
Type 'x' | 'y'
Default 'x'
label
label
A label for the chart, used for accessibility.
Type string | null
Default null
legendPosition
legend-position
The position of the legend relative to the chart.
Type LayoutPosition | 'start' | 'end'
Default 'top'
max
max
The maximum value for the value axis.
Type number | null
Default null
min
min
The minimum value for the value axis.
Type number | null
Default null
plugins
plugins
Additional Chart.js plugins to register for this chart instance.
Type array
Default []
stacked
stacked
Stacks datasets on top of each other along the value axis.
Type boolean
Default false
type
type
The type of chart to render. Valid types include bar, line, pie, doughnut, polarArea, radar, scatter, and bubble.
Type ChartType
Default 'pie'
withoutAnimation
without-animation
Disables chart animations
Type boolean
Default false
withoutLegend
without-legend
Hides the legend
Type boolean
Default false
withoutTooltip
without-tooltip
Hides tooltips over data points
Type boolean
Default false
xLabel
x-label
A label for the x-axis.
Type string | null
Default null
yLabel
y-label
A label for the y-axis.
Type string | null
Default null

CSS Custom Properties

Link to This Section

Learn more about CSS custom properties.

Name Description
--border-color-1
Border color for the first dataset.
Default var(--wa-color-blue-60)
--border-color-2
Border color for the second dataset.
Default var(--wa-color-pink-60)
--border-color-3
Border color for the third dataset.
Default var(--wa-color-green-60)
--border-color-4
Border color for the fourth dataset.
Default var(--wa-color-yellow-60)
--border-color-5
Border color for the fifth dataset.
Default var(--wa-color-purple-60)
--border-color-6
Border color for the sixth dataset.
Default var(--wa-color-orange-60)
--border-radius
Border radius for bar charts.
Default var(--wa-border-radius-s)
--border-width
Border width for bars and arcs.
Default var(--wa-border-width-s)
--fill-color-1
Fill color for the first dataset.
Default color-mix(in srgb, var(--wa-color-blue-60) 40%, transparent)
--fill-color-2
Fill color for the second dataset.
Default color-mix(in srgb, var(--wa-color-pink-60) 40%, transparent)
--fill-color-3
Fill color for the third dataset.
Default color-mix(in srgb, var(--wa-color-green-60) 40%, transparent)
--fill-color-4
Fill color for the fourth dataset.
Default color-mix(in srgb, var(--wa-color-yellow-60) 40%, transparent)
--fill-color-5
Fill color for the fifth dataset.
Default color-mix(in srgb, var(--wa-color-purple-60) 40%, transparent)
--fill-color-6
Fill color for the sixth dataset.
Default color-mix(in srgb, var(--wa-color-orange-60) 40%, transparent)
--grid-border-width
Border width for chart grid lines and axis borders.
Default var(--wa-border-width-s)
--grid-color
Color of the chart grid lines and axis borders.
Default var(--wa-color-neutral-border-quiet)
--line-border-width
Border width for line and radar charts.
Default var(--wa-border-width-m)
--point-radius
Radius of data point dots.
Default var(--wa-border-width-m)
Need a hand? Report a bug Ask for help
Go Make Something Awesome
Version 3.11.0 © Fonticons, Inc.
  • Terms
  • Privacy
  • Refunds
  • Core License
  • Pro License

Quick Links

  • Components
  • CSS Utilities
  • Theming
  • Using with AI
  • Changelog
  • Help & Support

Recent Searches

    D'oh! No results for “”

    Suggest on GitHub Ask on Discord
    Navigate Select
    Close Esc

    We Have Cookies…

    We use cookies to make webawesome.com work better by storing limited information about your usage.

    We value your privacy, so we won't use them for evil or ask you to join the dark side.

    Customize
    Necessary Only Accept All
    Strictly Necessary
    Required to make the site function correctly — cannot be turned off
    Functionality Analytics
    Cancel Confirm Cookie Choices