Polar Area Chart
<wa-polar-area-chart>
Polar area charts compare values using segments that radiate from a center point with varying radius. Unlike pie charts, each segment has an equal angle while the radius varies, making them useful for comparing magnitudes without visual bias.
-
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 -
WA Pro Perpetual License -
Actual Human™ Support
<wa-polar-area-chart id="polar-hero" label="Monthly Rainfall" description="A polar area chart showing monthly rainfall in millimeters"> </wa-polar-area-chart> <script type="module"> const chart = document.querySelector('#polar-hero'); chart.config = { data: { labels: ['January', 'February', 'March', 'April', 'May', 'June'], datasets: [{ label: 'Rainfall (mm)', data: [78, 62, 85, 110, 95, 45] }] } }; </script>
For advanced configuration such as custom plugins and direct Chart.js access, see <wa-chart>.
Examples
Providing Data with JavaScript
For dynamic data, set the config property directly. The chart will re-render automatically.
<wa-polar-area-chart id="polar-js-example" label="Energy Production" description="A polar area chart of energy output"> </wa-polar-area-chart> <script type="module"> const chart = document.querySelector('#polar-js-example'); chart.config = { data: { labels: ['Solar', 'Wind', 'Hydro', 'Nuclear', 'Natural Gas'], datasets: [{ label: 'Output (GW)', data: [85, 72, 110, 95, 130] }] } }; </script>
Note that config is shallowly reactive. If you mutate the existing object in place, you must reassign it to trigger a re-render!
Providing Data with JSON
Place a <script type="application/json"> tag inside the component with your chart data. Each value in the data array corresponds to a label, and the segment radius reflects its magnitude.
<wa-polar-area-chart label="Energy Production" description="A polar area chart showing energy production by source in gigawatts"> <script type="application/json"> { "data": { "labels": ["Solar", "Wind", "Hydro", "Nuclear", "Natural Gas"], "datasets": [{ "label": "Output (GW)", "data": [85, 72, 110, 95, 130] }] } } </script> </wa-polar-area-chart>
Custom Colors
Override the default color palette using the --fill-color-* and --border-color-* CSS custom properties.
<wa-polar-area-chart id="polar-colors" label="Custom Colors" description="A polar area chart with custom segment colors" style=" --fill-color-1: color-mix(in srgb, var(--wa-color-blue-60) 60%, transparent); --border-color-1: var(--wa-color-blue-60); --fill-color-2: color-mix(in srgb, var(--wa-color-cyan-60) 60%, transparent); --border-color-2: var(--wa-color-cyan-60); --fill-color-3: color-mix(in srgb, var(--wa-color-purple-60) 60%, transparent); --border-color-3: var(--wa-color-purple-60); --fill-color-4: color-mix(in srgb, var(--wa-color-orange-60) 60%, transparent); --border-color-4: var(--wa-color-orange-60); " > </wa-polar-area-chart> <script type="module"> const chart = document.querySelector('#polar-colors'); chart.config = { data: { labels: ['North', 'South', 'East', 'West'], datasets: [{ label: 'Sales', data: [85, 60, 92, 75] }] } }; </script>
Legend
Use the legend-position attribute to control where the legend appears. Add without-legend to hide it entirely.
<wa-polar-area-chart id="polar-legend" legend-position="right" label="Legend on Right" description="A polar area chart with the legend on the right side"> </wa-polar-area-chart> <script type="module"> const chart = document.querySelector('#polar-legend'); chart.config = { data: { labels: ['Speed', 'Reliability', 'Comfort', 'Safety', 'Efficiency'], datasets: [{ label: 'Rating', data: [80, 90, 70, 95, 85] }] } }; </script>
Disabling Tooltips
Use the without-tooltip attribute to hide the tooltips that appear when hovering over segments.
<wa-polar-area-chart id="polar-tooltip" without-tooltip label="No Tooltips" description="A polar area chart with tooltips disabled"> </wa-polar-area-chart> <script type="module"> const chart = document.querySelector('#polar-tooltip'); chart.config = { data: { labels: ['A', 'B', 'C', 'D'], datasets: [{ label: 'Values', data: [40, 70, 55, 85] }] } }; </script>
Disabling Animations
Use the without-animation attribute to disable chart transitions.
<wa-polar-area-chart id="polar-anim" without-animation label="No Animation" description="A polar area chart with animation disabled"> </wa-polar-area-chart> <script type="module"> const chart = document.querySelector('#polar-anim'); chart.config = { data: { labels: ['A', 'B', 'C', 'D'], datasets: [{ label: 'Values', data: [40, 70, 55, 85] }] } }; </script>
Importing
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.
Import this component directly from the CDN:
import 'https://ka-f.webawesome.com/[email protected]/components/polar-area-chart/polar-area-chart.js';
After installing Web Awesome via npm, import this component:
import '@awesome.me/webawesome/dist/components/polar-area-chart/polar-area-chart.js';
If you're self-hosting Web Awesome, import this component from your server:
import './webawesome/dist/components/polar-area-chart/polar-area-chart.js';
To import this component for React 18 or below, use the following code:
import WaPolarAreaChart from '@awesome.me/webawesome/dist/react/polar-area-chart/index.js';
Slots
Learn more about using slots.
| Name | Description |
|---|---|
| (default) | An optional <script type="application/json"> element containing the Chart.js configuration object. |
Attributes & Properties
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'] |
||
css |
One or more CSSResultGroup to include in the component's shadow root. Host styles are automatically prepended.
Type
CSSResultGroup | undefinedDefault
[styles] |
||
descriptiondescription |
A description of the chart, used for accessibility.
Type
string | nullDefault
null |
||
gridgrid |
Which axes to show grid lines on.
Type
'x' | 'y' | 'both' | 'none'Default
'both' |
||
indexAxisindex-axis |
The base axis of the dataset. 'x' for vertical bars and 'y' for horizontal bars.
Type
'x' | 'y'Default
'x' |
||
labellabel |
A label for the chart, used for accessibility.
Type
string | nullDefault
null |
||
legendPositionlegend-position |
The position of the legend relative to the chart.
Type
LayoutPosition | 'start' | 'end'Default
'top' |
||
maxmax |
The maximum value for the value axis.
Type
number | nullDefault
null |
||
minmin |
The minimum value for the value axis.
Type
number | nullDefault
null |
||
pluginsplugins |
Additional Chart.js plugins to register for this chart instance.
Type
arrayDefault
[] |
||
stackedstacked |
Stacks datasets on top of each other along the value axis.
Type
booleanDefault
false |
||
typetype |
The type of chart to render. Valid types include
bar, line, pie, doughnut, polarArea, radar, scatter,
and bubble.Type
ChartTypeDefault
'polarArea' |
||
withoutAnimationwithout-animation |
Disables chart animations
Type
booleanDefault
false |
|
|
withoutLegendwithout-legend |
Hides the legend
Type
booleanDefault
false |
|
|
withoutTooltipwithout-tooltip |
Hides tooltips over data points
Type
booleanDefault
false |
|
|
xLabelxLabel |
A label for the x-axis.
Type
string | nullDefault
null |
||
yLabelyLabel |
A label for the y-axis.
Type
string | nullDefault
null |
CSS custom properties
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)
|