Backend API
import React, { useCallback, useState } from 'react';
import NumberBox, { type NumberBoxTypes } from 'devextreme-react/number-box';
import {
Chart,
CommonSeriesSettings,
Series,
Point,
ArgumentAxis,
ValueAxis,
Legend,
} from 'devextreme-react/chart';
import { generateDataSource, customPositionLabel, offsetLabel } from './data.ts';
const dataSource = generateDataSource();
const defaultVisualRange = [-20, 20];
function App() {
const [argumentCustomPosition, setArgumentCustomPosition] = useState(0);
const [argumentOffset, setArgumentOffset] = useState(0);
const [valueCustomPosition, setValueCustomPosition] = useState(0);
const [valueOffset, setValueOffset] = useState(0);
const changeArgumentPosition = useCallback((e: NumberBoxTypes.ValueChangedEvent) => {
setArgumentCustomPosition(e.value);
}, [setArgumentCustomPosition]);
const changeArgumentOffset = useCallback((e: NumberBoxTypes.ValueChangedEvent) => {
setArgumentOffset(e.value);
}, [setArgumentOffset]);
const changeValuePosition = useCallback((e: NumberBoxTypes.ValueChangedEvent) => {
setValueCustomPosition(e.value);
}, [setValueCustomPosition]);
const changeValueOffset = useCallback((e: NumberBoxTypes.ValueChangedEvent) => {
setValueOffset(e.value);
}, [setValueOffset]);
return (
<div>
<Chart id="chart" dataSource={dataSource}>
<CommonSeriesSettings type='scatter' />
<Series argumentField='x1' valueField='y1' />
<Series argumentField='x2' valueField='y2'>
<Point symbol='triangleDown' />
</Series>
<ArgumentAxis
defaultVisualRange={defaultVisualRange}
customPosition={argumentCustomPosition}
offset={argumentOffset}
/>
<ValueAxis
defaultVisualRange={defaultVisualRange}
customPosition={valueCustomPosition}
offset={valueOffset}
endOnTick={false}
/>
<Legend visible={false} />
</Chart>
<div className='options'>
<div className='caption'>Options</div>
<div className="common">
<div className='block left'>
<span>Argument Axis</span>
<div className='option'>
<span>Custom position:</span>
<NumberBox
value={argumentCustomPosition}
showSpinButtons={true}
inputAttr={customPositionLabel}
onValueChanged={changeArgumentPosition} />
</div>
<div className='option'>
<span>Offset:</span>
<NumberBox
value={argumentOffset}
showSpinButtons={true}
inputAttr={offsetLabel}
onValueChanged={changeArgumentOffset} />
</div>
</div>
<div className='block right'>
<span>Value Axis</span>
<div className='option'>
<span>Custom position:</span>
<NumberBox
value={valueCustomPosition}
showSpinButtons={true}
inputAttr={customPositionLabel}
onValueChanged={changeValuePosition} />
</div>
<div className='option'>
<span>Offset:</span>
<NumberBox
value={valueOffset}
showSpinButtons={true}
inputAttr={offsetLabel}
onValueChanged={changeValueOffset} />
</div>
</div>
</div>
</div>
</div>
);
}
export default App;
import React, { useCallback, useState } from 'react';
import NumberBox from 'devextreme-react/number-box';
import {
Chart,
CommonSeriesSettings,
Series,
Point,
ArgumentAxis,
ValueAxis,
Legend,
} from 'devextreme-react/chart';
import { generateDataSource, customPositionLabel, offsetLabel } from './data.js';
const dataSource = generateDataSource();
const defaultVisualRange = [-20, 20];
function App() {
const [argumentCustomPosition, setArgumentCustomPosition] = useState(0);
const [argumentOffset, setArgumentOffset] = useState(0);
const [valueCustomPosition, setValueCustomPosition] = useState(0);
const [valueOffset, setValueOffset] = useState(0);
const changeArgumentPosition = useCallback(
(e) => {
setArgumentCustomPosition(e.value);
},
[setArgumentCustomPosition],
);
const changeArgumentOffset = useCallback(
(e) => {
setArgumentOffset(e.value);
},
[setArgumentOffset],
);
const changeValuePosition = useCallback(
(e) => {
setValueCustomPosition(e.value);
},
[setValueCustomPosition],
);
const changeValueOffset = useCallback(
(e) => {
setValueOffset(e.value);
},
[setValueOffset],
);
return (
<div>
<Chart
id="chart"
dataSource={dataSource}
>
<CommonSeriesSettings type="scatter" />
<Series
argumentField="x1"
valueField="y1"
/>
<Series
argumentField="x2"
valueField="y2"
>
<Point symbol="triangleDown" />
</Series>
<ArgumentAxis
defaultVisualRange={defaultVisualRange}
customPosition={argumentCustomPosition}
offset={argumentOffset}
/>
<ValueAxis
defaultVisualRange={defaultVisualRange}
customPosition={valueCustomPosition}
offset={valueOffset}
endOnTick={false}
/>
<Legend visible={false} />
</Chart>
<div className="options">
<div className="caption">Options</div>
<div className="common">
<div className="block left">
<span>Argument Axis</span>
<div className="option">
<span>Custom position:</span>
<NumberBox
value={argumentCustomPosition}
showSpinButtons={true}
inputAttr={customPositionLabel}
onValueChanged={changeArgumentPosition}
/>
</div>
<div className="option">
<span>Offset:</span>
<NumberBox
value={argumentOffset}
showSpinButtons={true}
inputAttr={offsetLabel}
onValueChanged={changeArgumentOffset}
/>
</div>
</div>
<div className="block right">
<span>Value Axis</span>
<div className="option">
<span>Custom position:</span>
<NumberBox
value={valueCustomPosition}
showSpinButtons={true}
inputAttr={customPositionLabel}
onValueChanged={changeValuePosition}
/>
</div>
<div className="option">
<span>Offset:</span>
<NumberBox
value={valueOffset}
showSpinButtons={true}
inputAttr={offsetLabel}
onValueChanged={changeValueOffset}
/>
</div>
</div>
</div>
</div>
</div>
);
}
export default App;
import React from 'react';
import ReactDOM from 'react-dom';
import App from './App.tsx';
ReactDOM.render(
<App />,
document.getElementById('app'),
);
export function generateDataSource() {
let x1; let x2; let y1; let y2; let
i;
const ds = [];
for (i = 0; i < 20; i += 1) {
x1 = random(5, 15);
y1 = random(5, 15);
ds.push({
x1, y1, x2, y2,
});
}
for (i = 0; i < 20; i += 1) {
x2 = random(5, 15);
y2 = random(-15, -5);
ds.push({
x1, y1, x2, y2,
});
}
for (i = 0; i < 20; i += 1) {
x2 = random(-15, -5);
y2 = random(5, 15);
ds.push({
x1, y1, x2, y2,
});
}
for (i = 0; i < 20; i += 1) {
x1 = random(-15, -5);
y1 = random(-15, -5);
ds.push({
x1, y1, x2, y2,
});
}
return ds;
}
function random(min: number, max: number) {
return Math.floor(Math.random() * (max - min + 1)) + min;
}
export const customPositionLabel = { 'aria-label': 'Custom Position' };
export const offsetLabel = { 'aria-label': 'Offset' };
import React from 'react';
import ReactDOM from 'react-dom';
import App from './App.js';
ReactDOM.render(<App />, document.getElementById('app'));
export function generateDataSource() {
let x1;
let x2;
let y1;
let y2;
let i;
const ds = [];
for (i = 0; i < 20; i += 1) {
x1 = random(5, 15);
y1 = random(5, 15);
ds.push({
x1,
y1,
x2,
y2,
});
}
for (i = 0; i < 20; i += 1) {
x2 = random(5, 15);
y2 = random(-15, -5);
ds.push({
x1,
y1,
x2,
y2,
});
}
for (i = 0; i < 20; i += 1) {
x2 = random(-15, -5);
y2 = random(5, 15);
ds.push({
x1,
y1,
x2,
y2,
});
}
for (i = 0; i < 20; i += 1) {
x1 = random(-15, -5);
y1 = random(-15, -5);
ds.push({
x1,
y1,
x2,
y2,
});
}
return ds;
}
function random(min, max) {
return Math.floor(Math.random() * (max - min + 1)) + min;
}
export const customPositionLabel = { 'aria-label': 'Custom Position' };
export const offsetLabel = { 'aria-label': 'Offset' };
<!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/26.1.5/css/dx.light.css" />
<link rel="stylesheet" type="text/css" href="./bundle.css" />
</head>
<body class="dx-viewport">
<div class="demo-container">
<div id="app"></div>
</div>
<script src="bundles/vendor/react.vendor.js"></script>
<script src="./bundle.js"></script>
</body>
</html>
.options {
padding: 20px;
margin-top: 20px;
background-color: rgba(191, 191, 191, 0.15);
}
.option {
margin-top: 10px;
display: flex;
align-items: center;
justify-content: space-between;
}
.option > span {
margin-right: 20px;
}
.caption {
font-size: 18px;
font-weight: 700;
}
.option > .dx-numberbox {
width: 90px;
margin-left: auto;
}
.common {
width: 488px;
}
.block {
vertical-align: middle;
margin-top: 10px;
}
.left {
display: inline-block;
}
.right {
float: right;
}
.block > span {
font-size: 18px;
font-weight: 500;
}
Regardless of which automatic axis layout type you use, the Chart Control allows you to apply manual offsets. Specify the offset property in pixels to keep the axis position unchanged when users scroll or zoom the Chart data. The offset property shifts the axis from the specified position as follows:
-
If the axis is horizontal, a negative offset shifts the axis to the top, a positive offset shifts it to the bottom.
-
If the axis is vertical, a negative offset shifts the axis to the left, a positive offset shifts it to the right.
In this demo, you can use controls under the Chart to change the customPosition and offset properties for both axes.