DevExtreme v24.1 is now available.

Explore our newest features/capabilities and share your thoughts with us.

Your search did not match any results.

Axis Label Templates

Axis labels display values for major axis ticks.

To configure labels for individual axes, specify label settings in the valueAxis.label and argumentAxis.label objects. To configure labels for all axes, use the commonAxisSettings.label object. Individual settings take precedence over common settings.

This demo illustrates how you can display custom content for axis labels. To replicate this demo, declare SVG markup within the template property. You can access a label's original and formatted values from template code.

Backend API
import React from 'react'; import { Chart, Series, ArgumentAxis, Label, CommonSeriesSettings, } from 'devextreme-react/chart'; import { dataSource } from './data.ts'; import { LabelTemplate } from './LabelTemplate.tsx'; function App() { return ( <Chart id="chart" title="Ice Hockey World Championship Gold Medal Winners" dataSource={dataSource}> <CommonSeriesSettings type="bar" argumentField="country"> <Label visible></Label> </CommonSeriesSettings> <Series name="Gold" valueField="gold" color="#ffd700" /> <Series name="Silver" valueField="silver" color="#c0c0c0" /> <Series name="Bronze" valueField="bronze" color="#cd7f32" /> <ArgumentAxis> <Label render={LabelTemplate}></Label> </ArgumentAxis> </Chart> ); } export default App;
import React from 'react'; import { Chart, Series, ArgumentAxis, Label, CommonSeriesSettings, } from 'devextreme-react/chart'; import { dataSource } from './data.js'; import { LabelTemplate } from './LabelTemplate.js'; function App() { return ( <Chart id="chart" title="Ice Hockey World Championship Gold Medal Winners" dataSource={dataSource} > <CommonSeriesSettings type="bar" argumentField="country" > <Label visible></Label> </CommonSeriesSettings> <Series name="Gold" valueField="gold" color="#ffd700" /> <Series name="Silver" valueField="silver" color="#c0c0c0" /> <Series name="Bronze" valueField="bronze" color="#cd7f32" /> <ArgumentAxis> <Label render={LabelTemplate}></Label> </ArgumentAxis> </Chart> ); } export default App;
import React from 'react'; export function LabelTemplate(data: { valueText: string; }) { return (<svg overflow="visible"><image filter="url(#DevExpress_shadow_filter)" y="0" width="60" height="40" href={getFilePath(data.valueText)}></image> <text className="template-text" x="30" y="59" textAnchor="middle">{data.valueText}</text></svg>); } function getFilePath(text: string) { return `../../../../images/flags/3x2/${text.toLowerCase().replace(' ', '')}.svg`; }
import React from 'react'; import ReactDOM from 'react-dom'; import App from './App.tsx'; ReactDOM.render( <App />, document.getElementById('app'), );
export const dataSource = [{ country: 'Russia', gold: 27, silver: 10, bronze: 10, }, { country: 'Canada', gold: 26, silver: 15, bronze: 9, }, { country: 'Czech Republic', gold: 12, silver: 13, bronze: 21, }, { country: 'Sweden', gold: 11, silver: 19, bronze: 17, }, { country: 'Finland', gold: 3, silver: 8, bronze: 3, }];
window.exports = window.exports || {}; window.config = { transpiler: 'ts', typescriptOptions: { module: 'system', emitDecoratorMetadata: true, experimentalDecorators: true, jsx: 'react', }, meta: { 'react': { 'esModule': true, }, 'typescript': { 'exports': 'ts', }, 'devextreme/time_zone_utils.js': { 'esModule': true, }, 'devextreme/localization.js': { 'esModule': true, }, 'devextreme/viz/palette.js': { 'esModule': true, }, }, paths: { 'npm:': 'https://unpkg.com/', }, defaultExtension: 'js', map: { 'ts': 'npm:plugin-typescript@4.2.4/lib/plugin.js', 'typescript': 'npm:typescript@4.2.4/lib/typescript.js', 'react': 'npm:react@17.0.2/umd/react.development.js', 'react-dom': 'npm:react-dom@17.0.2/umd/react-dom.development.js', 'prop-types': 'npm:prop-types@15.8.1/prop-types.js', 'rrule': 'npm:rrule@2.6.4/dist/es5/rrule.js', 'luxon': 'npm:luxon@1.28.1/build/global/luxon.min.js', 'es6-object-assign': 'npm:es6-object-assign@1.1.0', 'devextreme': 'npm:devextreme@24.1.3/cjs', 'devextreme-react': 'npm:devextreme-react@24.1.3/cjs', 'jszip': 'npm:jszip@3.10.1/dist/jszip.min.js', 'devextreme-quill': 'npm:devextreme-quill@1.7.1/dist/dx-quill.min.js', 'devexpress-diagram': 'npm:devexpress-diagram@2.2.8/dist/dx-diagram.js', 'devexpress-gantt': 'npm:devexpress-gantt@4.1.56/dist/dx-gantt.js', '@devextreme/runtime': 'npm:@devextreme/runtime@3.0.13', 'inferno': 'npm:inferno@7.4.11/dist/inferno.min.js', 'inferno-compat': 'npm:inferno-compat/dist/inferno-compat.min.js', 'inferno-create-element': 'npm:inferno-create-element@7.4.11/dist/inferno-create-element.min.js', 'inferno-dom': 'npm:inferno-dom/dist/inferno-dom.min.js', 'inferno-hydrate': 'npm:inferno-hydrate@7.4.11/dist/inferno-hydrate.min.js', 'inferno-clone-vnode': 'npm:inferno-clone-vnode/dist/inferno-clone-vnode.min.js', 'inferno-create-class': 'npm:inferno-create-class/dist/inferno-create-class.min.js', 'inferno-extras': 'npm:inferno-extras/dist/inferno-extras.min.js', 'devextreme-cldr-data': 'npm:devextreme-cldr-data@1.0.3', // SystemJS plugins 'plugin-babel': 'npm:systemjs-plugin-babel@0.0.25/plugin-babel.js', 'systemjs-babel-build': 'npm:systemjs-plugin-babel@0.0.25/systemjs-babel-browser.js', // Prettier 'prettier/standalone': 'npm:prettier@2.8.8/standalone.js', 'prettier/parser-html': 'npm:prettier@2.8.8/parser-html.js', }, packages: { 'devextreme': { defaultExtension: 'js', }, 'devextreme-react': { main: 'index.js', }, 'devextreme/events/utils': { main: 'index', }, 'devextreme/localization/messages': { format: 'json', defaultExtension: 'json', }, 'devextreme/events': { main: 'index', }, 'es6-object-assign': { main: './index.js', defaultExtension: 'js', }, }, packageConfigPaths: [ 'npm:@devextreme/*/package.json', 'npm:@devextreme/runtime@3.0.13/inferno/package.json', ], babelOptions: { sourceMaps: false, stage0: true, react: true, }, }; System.config(window.config);
import React from 'react'; export function LabelTemplate(data) { return ( <svg overflow="visible"> <image filter="url(#DevExpress_shadow_filter)" y="0" width="60" height="40" href={getFilePath(data.valueText)} ></image> <text className="template-text" x="30" y="59" textAnchor="middle" > {data.valueText} </text> </svg> ); } function getFilePath(text) { return `../../../../images/flags/3x2/${text.toLowerCase().replace(' ', '')}.svg`; }
import React from 'react'; import ReactDOM from 'react-dom'; import App from './App.js'; ReactDOM.render(<App />, document.getElementById('app'));
export const dataSource = [ { country: 'Russia', gold: 27, silver: 10, bronze: 10, }, { country: 'Canada', gold: 26, silver: 15, bronze: 9, }, { country: 'Czech Republic', gold: 12, silver: 13, bronze: 21, }, { country: 'Sweden', gold: 11, silver: 19, bronze: 17, }, { country: 'Finland', gold: 3, silver: 8, bronze: 3, }, ];
<!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/24.1.3/css/dx.light.css" /> <link rel="stylesheet" type="text/css" href="styles.css" /> <script src="https://unpkg.com/core-js@2.6.12/client/shim.min.js"></script> <script src="https://unpkg.com/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> <svg width="0" height="0"> <defs> <filter id="DevExpress_shadow_filter" x="-50%" y="-50%" width="200%" height="200%" transform="translate(0,0)"> <fegaussianblur in="SourceGraphic" result="gaussianBlurResult" stdDeviation="3"></fegaussianblur> <feoffset in="gaussianBlurResult" result="offsetResult" dx="0" dy="1"></feoffset> <feflood result="floodResult" flood-color="#000000" flood-opacity="0.3"></feflood> <fecomposite in="floodResult" in2="offsetResult" operator="in" result="compositeResult"></fecomposite> <fecomposite in="SourceGraphic" in2="compositeResult" operator="over"></fecomposite> </filter> </defs> </svg> </div> </body> </html>
#chart { height: 440px; } .template-text { fill: #767676; font-family: "Segoe UI", "Helvetica Neue", "Trebuchet MS", Verdana, sans-serif; font-weight: 400; font-size: 13px; }