DevExtreme Accessibility Compliance
DevExtreme component libraries meet a variety of WCAG and Section 508 compliance standards. To assess this demo's accessibility level, click the Run AXE® Validation button to launch the AXE® web accessibility evaluation tool.
All trademarks or registered trademarks are property of their respective owners. AXE® Terms of Use
The overall accessibility level of your application depends on the TextBox features used.
Backend API
import React, { useCallback, useState } from 'react';
import TextBox from 'devextreme-react/text-box';
import type { TextBoxTypes } from 'devextreme-react/text-box';
const nameLabel = { 'aria-label': 'Name' };
const fullNameLabel = { 'aria-label': 'Full Name' };
const passwordLabel = { 'aria-label': 'Password' };
const maskLabel = { 'aria-label': 'Mask' };
const emailLabel = { 'aria-label': 'Email' };
const rules = { X: /[02-9]/ };
function App() {
const [emailValue, setEmailValue] = useState<string>('smith@corp.com');
const valueChanged = useCallback((data: TextBoxTypes.ValueChangedEvent): void => {
setEmailValue(`${data.value.replace(/\s/g, '').toLowerCase()}@corp.com`);
}, []);
return (
<div>
<div className="dx-fieldset">
<div className="dx-field">
<div className="dx-field-label">Default mode</div>
<div className="dx-field-value">
<TextBox
defaultValue="John Smith"
inputAttr={nameLabel}
/>
</div>
</div>
<div className="dx-field">
<div className="dx-field-label">With placeholder</div>
<div className="dx-field-value">
<TextBox
placeholder="Enter full name here..."
inputAttr={fullNameLabel}
/>
</div>
</div>
<div className="dx-field">
<div className="dx-field-label">With clear button</div>
<div className="dx-field-value">
<TextBox
defaultValue="John Smith"
inputAttr={nameLabel}
showClearButton={true}
/>
</div>
</div>
<div className="dx-field">
<div className="dx-field-label">Password mode</div>
<div className="dx-field-value">
<TextBox
mode="password"
inputAttr={passwordLabel}
placeholder="Enter password"
showClearButton={true}
defaultValue="f5lzKs0T"
/>
</div>
</div>
<div className="dx-field">
<div className="dx-field-label">Text mask</div>
<div className="dx-field-value">
<TextBox
mask="(X00) 000-0000"
inputAttr={maskLabel}
maskRules={rules}
/>
</div>
</div>
<div className="dx-field">
<div className="dx-field-label">Disabled</div>
<div className="dx-field-value">
<TextBox
defaultValue="John Smith"
inputAttr={nameLabel}
disabled={true}
/>
</div>
</div>
</div>
<div className="dx-fieldset">
<div className="dx-fieldset-header">Events and API</div>
<div className="dx-field">
<div className="dx-field-label">Full Name</div>
<div className="dx-field-value">
<TextBox
defaultValue="Smith"
inputAttr={fullNameLabel}
showClearButton={true}
placeholder="Enter full name"
valueChangeEvent="keyup"
onValueChanged={valueChanged}
/>
</div>
</div>
<div className="dx-field">
<div className="dx-field-label">Email (read only)</div>
<div className="dx-field-value">
<TextBox
readOnly={true}
inputAttr={emailLabel}
hoverStateEnabled={false}
value={emailValue}
/>
</div>
</div>
</div>
</div>
);
}
export default App;
import React, { useCallback, useState } from 'react';
import TextBox from 'devextreme-react/text-box';
const nameLabel = { 'aria-label': 'Name' };
const fullNameLabel = { 'aria-label': 'Full Name' };
const passwordLabel = { 'aria-label': 'Password' };
const maskLabel = { 'aria-label': 'Mask' };
const emailLabel = { 'aria-label': 'Email' };
const rules = { X: /[02-9]/ };
function App() {
const [emailValue, setEmailValue] = useState('smith@corp.com');
const valueChanged = useCallback((data) => {
setEmailValue(`${data.value.replace(/\s/g, '').toLowerCase()}@corp.com`);
}, []);
return (
<div>
<div className="dx-fieldset">
<div className="dx-field">
<div className="dx-field-label">Default mode</div>
<div className="dx-field-value">
<TextBox
defaultValue="John Smith"
inputAttr={nameLabel}
/>
</div>
</div>
<div className="dx-field">
<div className="dx-field-label">With placeholder</div>
<div className="dx-field-value">
<TextBox
placeholder="Enter full name here..."
inputAttr={fullNameLabel}
/>
</div>
</div>
<div className="dx-field">
<div className="dx-field-label">With clear button</div>
<div className="dx-field-value">
<TextBox
defaultValue="John Smith"
inputAttr={nameLabel}
showClearButton={true}
/>
</div>
</div>
<div className="dx-field">
<div className="dx-field-label">Password mode</div>
<div className="dx-field-value">
<TextBox
mode="password"
inputAttr={passwordLabel}
placeholder="Enter password"
showClearButton={true}
defaultValue="f5lzKs0T"
/>
</div>
</div>
<div className="dx-field">
<div className="dx-field-label">Text mask</div>
<div className="dx-field-value">
<TextBox
mask="(X00) 000-0000"
inputAttr={maskLabel}
maskRules={rules}
/>
</div>
</div>
<div className="dx-field">
<div className="dx-field-label">Disabled</div>
<div className="dx-field-value">
<TextBox
defaultValue="John Smith"
inputAttr={nameLabel}
disabled={true}
/>
</div>
</div>
</div>
<div className="dx-fieldset">
<div className="dx-fieldset-header">Events and API</div>
<div className="dx-field">
<div className="dx-field-label">Full Name</div>
<div className="dx-field-value">
<TextBox
defaultValue="Smith"
inputAttr={fullNameLabel}
showClearButton={true}
placeholder="Enter full name"
valueChangeEvent="keyup"
onValueChanged={valueChanged}
/>
</div>
</div>
<div className="dx-field">
<div className="dx-field-label">Email (read only)</div>
<div className="dx-field-value">
<TextBox
readOnly={true}
inputAttr={emailLabel}
hoverStateEnabled={false}
value={emailValue}
/>
</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'));
import React from 'react';
import ReactDOM from 'react-dom';
import App from './App.js';
ReactDOM.render(<App />, document.getElementById('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/26.1.5/css/dx.light.css" />
<link rel="stylesheet" type="text/css" href="styles.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>
This demo illustrates the following TextBox properties:
-
value
A value the TextBox displays. -
placeholder
An input prompt the TextBox displays when the value is not defined. -
showClearButton
Specifies whether to display the button that clears the TextBox value. -
mode
Affects a set of keyboard characters displayed on a mobile device when the TextBox gets focus and modifies the component's display style. In this example, the mode is set to "password" so that entered characters are obscured, and the password cannot be read. -
mask
An input mask. -
maskRules
Custom mask rules. -
disabled
Specifies whether the TextBox responds to user interaction. -
onValueChanged event handler
Use this function to perform an action when a user enters a new value. In this demo, this function uses the entered value to construct a dummy email address and assign it to another TextBox. -
valueChangeEvent
One or several DOM events that trigger the onValueChanged event handler. -
readOnly
Prevents users from changing the editor's value. -
hoverStateEnabled
Specifies whether the TextBox responds when users long press or hover the mouse pointer over it.