React Charts - Palette

The PieChart, like other DevExtreme Data Visualization components, allows you to apply multiple predefined palettes. In this demo, you can use two drop-down menus under the PieChart to choose a palette and change the way it is extended when the number of colors is insufficient to paint each series point differently.

TS JS

Backend API

import React, { useCallback, useState } from 'react'; import PieChart, { Series, Legend, } from 'devextreme-react/pie-chart'; import SelectBox, { type SelectBoxTypes } from 'devextreme-react/select-box'; import { getPalette } from 'devextreme/viz/palette'; import { paletteCollection, paletteExtensionModes, dataSource, paletteLabel, paletteExtensionLabel, } from './data.ts'; function App() { const [palette, setPalette] = useState(paletteCollection[0]); const [extensionMode, setExtensionMode] = useState(paletteExtensionModes[1]); const handlePaletteChange = useCallback((e: SelectBoxTypes.ValueChangedEvent) => { setPalette(e.value); }, [setPalette]); const handleExtensionModeChange = useCallback((e: SelectBoxTypes.ValueChangedEvent) => { setExtensionMode(e.value); }, [setExtensionMode]); return ( <React.Fragment> <div className="flex-container"> <PieChart id="pie" dataSource={dataSource} palette={palette} paletteExtensionMode={extensionMode} > <Legend visible={false} /> <Series /> </PieChart> <div className="palette-container flex-block"> {getPalette(palette).simpleSet.map((color) => ( <div className="palette-item" style={{ backgroundColor: color }} key={color} /> ))} </div> </div> <div className="options"> <div className="caption">Options</div> <div className="options-container"> <div className="option"> <span>Palette </span> <SelectBox items={paletteCollection} inputAttr={paletteLabel} defaultValue={palette} onValueChanged={handlePaletteChange} /> </div> <div className="option"> <span>Palette Extension Mode </span> <SelectBox items={paletteExtensionModes} inputAttr={paletteExtensionLabel} defaultValue={extensionMode} onValueChanged={handleExtensionModeChange} /> </div> </div> </div> </React.Fragment> ); } export default App;

import React, { useCallback, useState } from 'react'; import PieChart, { Series, Legend } from 'devextreme-react/pie-chart'; import SelectBox from 'devextreme-react/select-box'; import { getPalette } from 'devextreme/viz/palette'; import { paletteCollection, paletteExtensionModes, dataSource, paletteLabel, paletteExtensionLabel, } from './data.js'; function App() { const [palette, setPalette] = useState(paletteCollection[0]); const [extensionMode, setExtensionMode] = useState(paletteExtensionModes[1]); const handlePaletteChange = useCallback( (e) => { setPalette(e.value); }, [setPalette], ); const handleExtensionModeChange = useCallback( (e) => { setExtensionMode(e.value); }, [setExtensionMode], ); return ( <React.Fragment> <div className="flex-container"> <PieChart id="pie" dataSource={dataSource} palette={palette} paletteExtensionMode={extensionMode} > <Legend visible={false} /> <Series /> </PieChart> <div className="palette-container flex-block"> {getPalette(palette).simpleSet.map((color) => ( <div className="palette-item" style={{ backgroundColor: color }} key={color} /> ))} </div> </div> <div className="options"> <div className="caption">Options</div> <div className="options-container"> <div className="option"> <span>Palette </span> <SelectBox items={paletteCollection} inputAttr={paletteLabel} defaultValue={palette} onValueChanged={handlePaletteChange} /> </div> <div className="option"> <span>Palette Extension Mode </span> <SelectBox items={paletteExtensionModes} inputAttr={paletteExtensionLabel} defaultValue={extensionMode} onValueChanged={handleExtensionModeChange} /> </div> </div> </div> </React.Fragment> ); } export default App;

import React from 'react'; import ReactDOM from 'react-dom'; import App from './App.tsx'; ReactDOM.render( <App />, document.getElementById('app'), );

import { Palette } from 'devextreme/viz/pie_chart'; import { PaletteExtensionMode } from 'devextreme/common/charts'; export const paletteCollection: Palette[] = ['Material', 'Soft Pastel', 'Harmony Light', 'Pastel', 'Bright', 'Soft', 'Ocean', 'Office', 'Vintage', 'Violet', 'Carmine', 'Dark Moon', 'Soft Blue', 'Dark Violet', 'Green Mist']; export const paletteExtensionModes: PaletteExtensionMode[] = ['alternate', 'blend', 'extrapolate']; const data: ({ arg: string; val: number; })[] = []; for (let i = 0; i < 20; i += 1) { data.push({ arg: `item${i}`, val: 1, }); } export const dataSource = data; export const paletteLabel = { 'aria-label': 'Palette' }; export const paletteExtensionLabel = { 'aria-label': 'Palette Extension Mode' };

import React from 'react'; import ReactDOM from 'react-dom'; import App from './App.js'; ReactDOM.render(<App />, document.getElementById('app'));

export const paletteCollection = [ 'Material', 'Soft Pastel', 'Harmony Light', 'Pastel', 'Bright', 'Soft', 'Ocean', 'Office', 'Vintage', 'Violet', 'Carmine', 'Dark Moon', 'Soft Blue', 'Dark Violet', 'Green Mist', ]; export const paletteExtensionModes = ['alternate', 'blend', 'extrapolate']; const data = []; for (let i = 0; i < 20; i += 1) { data.push({ arg: `item${i}`, val: 1, }); } export const dataSource = data; export const paletteLabel = { 'aria-label': 'Palette' }; export const paletteExtensionLabel = { 'aria-label': 'Palette Extension Mode' };

<!DOCTYPE html> <html lang="en"> <head> <title>DevExtreme Demo</title> <meta http-equiv="X-UA-Compatible" content="IE=edge" /> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> <meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=5.0" /> <link rel="stylesheet" type="text/css" href="https://cdn3.devexpress.com/jslib/25.1.6/css/dx.light.css" /> <link rel="stylesheet" type="text/css" href="styles.css" /> <script src="https://cdn.jsdelivr.net/npm/core-js@2.6.12/client/shim.min.js"></script> <script src="https://cdn.jsdelivr.net/npm/systemjs@0.21.3/dist/system.js"></script> <script type="text/javascript" src="config.js"></script> <script type="text/javascript"> System.import("./index.tsx"); </script> </head> <body class="dx-viewport"> <div class="demo-container"> <div id="app"></div> </div> </body> </html>

.flex-container { display: flex; justify-content: center; align-items: center; flex-direction: row; } #pie { height: 350px; width: 500px; margin: 20px; } .palette-container { float: left; } .palette-item { width: 40px; height: 40px; } .options { padding: 20px; background-color: rgba(191, 191, 191, 0.15); margin-top: 20px; } .caption { font-size: 18px; font-weight: 500; } .option { display: inline-block; min-width: 320px; margin-top: 5px; } .option > span { margin: 0 10px 0 0; } .option > .dx-widget { display: inline-block; vertical-align: middle; } .options-container { display: flex; align-items: center; } .options-container > .option { display: flex; align-items: baseline; }

Specify a Palette

A palette is a set of colors that mix well with each other. To apply the needed color scheme, you can assign it to the palette property. It accepts either the name of a predefined palette or an array of colors. In this demo, you can use the "Palette" selector to apply a new set of colors.

Extend a Palette

When the number of palette colors is less than the number of series points, you can use the paletteExtensionMode property to specify how to extend the palette. This property can accept one of the following values:

"blend"
Create a blend of two neighboring colors and insert it between these colors in the palette.
"alternate"
Repeat the full set of palette colors, alternating their normal, lightened, and darkened shades in that order.
"extrapolate"
Repeat the full set of palette colors, changing their shade gradually from dark to light.

In this demo, you can use the "Palette Extension Mode" selector to apply one of these modes.