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

Doughnut Chart

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

Doughnut Chart

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

Doughnut charts show proportional data as slices of a ring with a hollow center. They offer a cleaner look than pie charts and work well in dashboards where the center space can provide additional context.

Get Doughnut 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
  • Native Styles
  • CSS + Layout Utilities
  • Ever-Growing Pattern Library
  • Unlimited Hosted Projects
  • Pre-Built Pro Themes
  • Pro Theme Builder
  • Pro Color Tools
  • Official Figma Design Kit
  • WA Pro Perpetual License
  • Actual Human™ Support
Get Web Awesome Pro + Doughnut Chart!

Already have Pro? Log in

<wa-doughnut-chart
  label="Project Time Allocation"
  description="A doughnut chart showing how project time is distributed across activities"
>
  <script type="application/json">
    {
      "data": {
        "labels": ["Development", "Design", "Testing", "Meetings", "Planning"],
        "datasets": [{ "label": "Hours", "data": [35, 20, 15, 18, 12] }]
      }
    }
  </script>
</wa-doughnut-chart>

Similar to pie charts but with an empty center.

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-doughnut-chart label="Revenue by Region" description="A doughnut chart showing revenue distribution across regions">
  <script type="application/json">
    {
      "data": {
        "labels": ["North America", "Europe", "Asia", "Other"],
        "datasets": [
          {
            "label": "Revenue",
            "data": [42, 28, 22, 8]
          }
        ]
      }
    }
  </script>
</wa-doughnut-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-doughnut-chart
  id="doughnut-js-example"
  label="Revenue by Region"
  description="A doughnut chart of revenue by region"
>
</wa-doughnut-chart>
<script type="module">
  const chart = document.querySelector('#doughnut-js-example');

  chart.config = {
    data: {
      labels: ['North America', 'Europe', 'Asia', 'Other'],
      datasets: [
        {
          label: 'Revenue',
          data: [42, 28, 22, 8],
        },
      ],
    },
  };
</script>

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

Cutout Size

Link to This Section

Control the size of the center hole through the Chart.js cutout option. The default is '50%'. Use a higher percentage for a thinner ring or a lower one for a thicker ring.

<wa-doughnut-chart
  id="doughnut-cutout-example"
  label="Thin Ring"
  description="A doughnut chart with a larger center cutout"
>
</wa-doughnut-chart>
<script type="module">
  const chart = document.querySelector('#doughnut-cutout-example');

  chart.config = {
    data: {
      labels: ['Used', 'Available'],
      datasets: [
        {
          label: 'Storage',
          data: [72, 28],
        },
      ],
    },
    options: {
      cutout: '75%',
    },
  };
</script>

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

  chart.config = {
    data: {
      labels: ['Completed', 'In Progress', 'Pending'],
      datasets: [
        {
          label: 'Tasks',
          data: [45, 30, 25],
        },
      ],
    },
  };
</script>

Legend

Link to This Section

Use the legend-position attribute to control where the legend appears. Add without-legend to hide it entirely.

<wa-doughnut-chart
  id="doughnut-legend"
  legend-position="bottom"
  label="Legend at Bottom"
  description="A doughnut chart with the legend at the bottom"
>
</wa-doughnut-chart>
<script type="module">
  const chart = document.querySelector('#doughnut-legend');

  chart.config = {
    data: {
      labels: ['Email', 'Social', 'Direct', 'Referral'],
      datasets: [
        {
          label: 'Traffic Source',
          data: [30, 25, 28, 17],
        },
      ],
    },
  };
</script>

Disabling Features

Link to This Section

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

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

  chart.config = {
    data: {
      labels: ['Glazed', 'Old Fashioned', 'Boston Cream'],
      datasets: [
        {
          label: 'Donuts Sold',
          data: [520, 310, 190],
        },
      ],
    },
  };
</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/doughnut-chart/doughnut-chart.js';

After installing Web Awesome via npm, import this component:

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

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

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

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

import WaDoughnutChart from '@awesome.me/webawesome/dist/react/doughnut-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 'doughnut'
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.12.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