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
<template> <DxChart id="chart" title="Ice Hockey World Championship Gold Medal Winners" :data-source="dataSource" > <DxCommonSeriesSettings type="bar" argument-field="country" > <DxLabel :visible="true"/> </DxCommonSeriesSettings> <DxSeries name="Gold" value-field="gold" color="#ffd700" /> <DxSeries name="Silver" value-field="silver" color="#c0c0c0" /> <DxSeries name="Bronze" value-field="bronze" color="#cd7f32" /> <DxArgumentAxis> <DxLabel template="labelTemplate"/> </DxArgumentAxis> <template #labelTemplate="{ data }"> <LabelTemplate :data="data"/> </template> </DxChart> </template> <script setup lang="ts"> import { DxChart, DxSeries, DxCommonSeriesSettings, DxLabel, DxArgumentAxis, } from 'devextreme-vue/chart'; import { dataSource } from './data.ts'; import LabelTemplate from './LabelTemplate.vue'; </script> <style> #chart { height: 440px; } </style>
<template> <svg overflow="visible"> <image filter="url(#DevExpress_shadow_filter)" y="0" width="60" height="40" :href="getFilePath(data.valueText)" /> <text class="template-text" x="30" y="59" text-anchor="middle" > {{ data.valueText }} </text> </svg> </template> <script setup lang="ts"> withDefaults(defineProps<{ data?: Record<string, any> }>(), { data: () => ({}), }); const getFilePath = (text) => `../../../../images/flags/3x2/${text.toLowerCase().replace(' ', '')}.svg`; </script> <style scoped> .template-text { fill: #767676; font-family: "Segoe UI", "Helvetica Neue", "Trebuchet MS", Verdana, sans-serif; font-weight: 400; font-size: 13px; } </style>
window.exports = window.exports || {}; window.config = { transpiler: 'plugin-babel', meta: { '*.vue': { loader: 'vue-loader', }, '*.ts': { loader: 'demo-ts-loader', }, '*.svg': { loader: 'svg-loader', }, 'devextreme/time_zone_utils.js': { 'esModule': true, }, 'devextreme/localization.js': { 'esModule': true, }, 'devextreme/viz/palette.js': { 'esModule': true, }, }, paths: { 'root:': '../../../../', 'npm:': 'https://unpkg.com/', }, map: { 'vue': 'npm:vue@3.2.47/dist/vue.esm-browser.js', 'vue-loader': 'npm:dx-systemjs-vue-browser@1.1.1/index.js', 'demo-ts-loader': 'root:utils/demo-ts-loader.js', 'svg-loader': 'root:utils/svg-loader.js', 'mitt': 'npm:mitt/dist/mitt.umd.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-vue': 'npm:devextreme-vue@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', '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-vue': { main: 'index.js', }, 'devextreme': { defaultExtension: 'js', }, 'devextreme/events/utils': { main: 'index', }, '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, }, }; System.config(window.config);
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, }];
import { createApp } from 'vue'; import App from './App.vue'; createApp(App).mount('#app');
<!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" /> <script src="https://unpkg.com/typescript@4.9.5/lib/typescript.js"></script> <script type="module"> import * as vueCompilerSFC from "https://unpkg.com/@vue/compiler-sfc@3.4.16/dist/compiler-sfc.esm-browser.js"; window.vueCompilerSFC = vueCompilerSFC; </script> <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.ts"); </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>