Value Indicators API
Documentation
This demo shows how to use the API of the CircularGauge to change its value and subvalue indicators at runtime. To get and set the values of the indicators, the value and subvalues methods are utilized.
Feel free to share demo-related thoughts here.
If you have technical questions, please create a support ticket in the DevExpress Support Center.
If you have technical questions, please create a support ticket in the DevExpress Support Center.
Thank you!
We appreciate your feedback.
We appreciate your feedback.
<template>
<div>
<div id="gauge-demo">
<div class="widget-container">
<DxCircularGauge
id="gauge"
ref="gauge"
>
<DxScale
:start-value="10"
:end-value="40"
:tick-interval="5"
>
<DxLabel
:customize-text="customizeText"
/>
</DxScale>
<DxTooltip
:enabled="true"
/>
<DxTitle
text="Generators Voltage (kV)"
>
<DxFont
:size="28"
/>
</DxTitle>
</DxCircularGauge>
</div>
<div class="options">
<div class="caption">Options</div>
<div class="option">
<span>Main generator</span>
<DxNumberBox
id="main-generator"
v-model:value="mainGeneratorValue"
:min="10"
:max="40"
:width="100"
:show-spin-buttons="true"
:input-attr="{ 'aria-label': 'Main Generator' }"
/>
</div>
<div class="option">
<span>Additional generator 1</span>
<DxNumberBox
id="additional-generator-one"
v-model:value="additionalGenerator1Value"
:min="10"
:max="40"
:width="100"
:show-spin-buttons="true"
:input-attr="{ 'aria-label': 'Additional Generator One' }"
/>
</div>
<div class="option">
<span>Additional generator 2</span>
<DxNumberBox
id="additional-generator-two"
v-model:value="additionalGenerator2Value"
:min="10"
:max="40"
:width="100"
:show-spin-buttons="true"
:input-attr="{ 'aria-label': 'Additional Generator Two' }"
/>
</div>
<div class="option">
<DxButton
id="edit"
:width="100"
text="Apply"
@click="updateValues"
/>
</div>
</div>
</div>
</div>
</template>
<script>
import {
DxCircularGauge, DxScale, DxLabel, DxTooltip, DxTitle, DxFont,
} from 'devextreme-vue/circular-gauge';
import { DxNumberBox } from 'devextreme-vue/number-box';
import { DxButton } from 'devextreme-vue/button';
export default {
components: {
DxCircularGauge,
DxScale,
DxLabel,
DxTooltip,
DxTitle,
DxFont,
DxNumberBox,
DxButton,
},
data() {
return {
additionalGenerator1Value: 12,
additionalGenerator2Value: 23,
mainGeneratorValue: 34,
};
},
mounted() {
this.updateValues();
},
methods: {
customizeText({ valueText }) {
return `${valueText} kV`;
},
updateValues() {
this.$refs.gauge.instance.value(this.mainGeneratorValue);
this.$refs.gauge.instance.subvalues([
this.additionalGenerator1Value,
this.additionalGenerator2Value,
]);
},
},
};
</script>
<style scoped>
.widget-container {
margin-right: 320px;
}
.options {
padding: 20px;
background-color: rgba(191, 191, 191, 0.15);
position: absolute;
right: 0;
top: 0;
bottom: 0;
width: 260px;
}
.caption {
font-size: 18px;
font-weight: 500;
}
.option {
margin-top: 10px;
display: flex;
align-items: center;
justify-content: space-between;
}
#edit {
margin-left: auto;
}
</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="dx-theme" data-theme="generic.light" 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>
</div>
</body>
</html>
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.5/cjs',
'devextreme-vue': 'npm:devextreme-vue@23.1.5',
'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.1/dist/dx-diagram.js',
'devexpress-gantt': 'npm:devexpress-gantt@4.1.48/dist/dx-gantt.js',
'@devextreme/runtime': 'npm:@devextreme/runtime@3.0.11',
'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.11/inferno/package.json',
],
babelOptions: {
sourceMaps: false,
stage0: true,
},
};
System.config(window.config);