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.
Feel free to share demo-related thoughts here.
If you have technical questions, please create a support ticket in the DevExpress Support Center.
Thank you for the feedback!
If you have technical questions, please create a support ticket in the DevExpress Support Center.
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>
import {
DxChart, DxSeries, DxCommonSeriesSettings, DxLabel, DxArgumentAxis,
} from 'devextreme-vue/chart';
import { dataSource } from './data.js';
import LabelTemplate from './LabelTemplate.vue';
export default {
components: {
DxChart,
DxSeries,
DxCommonSeriesSettings,
DxLabel,
DxArgumentAxis,
LabelTemplate,
},
data() {
return {
dataSource,
};
},
};
</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>
export default {
props: {
data: {
type: Object,
default: () => {},
},
},
methods: {
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>
import { createApp } from 'vue';
import App from './App.vue';
createApp(App).mount('#app');
<!DOCTYPE html>
<html>
<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=1.0" />
<link rel="stylesheet" type="text/css" href="https://cdn3.devexpress.com/jslib/23.1.5/css/dx.light.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.js");
</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>
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: 'plugin-babel',
meta: {
'*.vue': {
loader: 'vue-loader',
},
'*.ts': {
loader: 'demo-ts-loader',
},
'*.svg': {
loader: 'svg-loader',
},
'devextreme/localization.js': {
'esModule': true,
},
},
paths: {
'root:': '../../../../../',
'npm:': 'https://unpkg.com/',
},
map: {
'vue': 'npm:vue@3.3.4/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@23.1.6/cjs',
'devextreme-vue': 'npm:devextreme-vue@23.1.6',
'jszip': 'npm:jszip@3.7.1/dist/jszip.min.js',
'devextreme-quill': 'npm:devextreme-quill@1.6.2/dist/dx-quill.min.js',
'devexpress-diagram': 'npm:devexpress-diagram@2.2.2/dist/dx-diagram.js',
'devexpress-gantt': 'npm:devexpress-gantt@4.1.49/dist/dx-gantt.js',
'@devextreme/runtime': 'npm:@devextreme/runtime@3.0.12',
'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.4/standalone.js',
'prettier/parser-html': 'npm:prettier@2.8.4/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.12/inferno/package.json',
],
babelOptions: {
sourceMaps: false,
stage0: true,
},
};
System.config(window.config);