DevExtreme v24.1 is now available.

Explore our newest features/capabilities and share your thoughts with us.

Your search did not match any results.

React Editors - Editor Appearance Variants

DevExtreme Editors include the following appearance customization properties:

  • stylingMode: "filled" | "outlined" | "underlined"
    Specifies the style used for text fields.

  • labelMode: "static" | "floating" | "hidden" | "outside"
    Specifies label display mode.

Backend API
import React, { useCallback, useState } from 'react'; import { EditorStyle, LabelMode } from 'devextreme-react/common'; import notify from 'devextreme/ui/notify'; import { SelectBox } from 'devextreme-react/select-box'; import { TextBox } from 'devextreme-react/text-box'; import { DateBox } from 'devextreme-react/date-box'; import { DateRangeBox } from 'devextreme-react/date-range-box'; import { TextArea } from 'devextreme-react/text-area'; import { Button, ButtonTypes } from 'devextreme-react/button'; import { Validator, RequiredRule } from 'devextreme-react/validator'; import { states, stylingModes, labelModes, notesLabel, birthDateLabel, hireDateLabel, nameLabel, addressLabel, phoneLabel, stateLabel, labelModeLabel, stylingModeLabel, } from './data.ts'; const phoneRules = { X: /[02-9]/, }; function validateClick({ validationGroup }: ButtonTypes.ClickEvent) { const result = validationGroup.validate(); if (result.isValid) { notify('The task was saved successfully.', 'success'); } else { notify('The task was not saved. Please check if all fields are valid.', 'error'); } } export default function App() { const defaultStylingMode = 'outlined'; const [stylingMode, setStylingMode] = useState<EditorStyle>(defaultStylingMode); const [labelMode, setLabelMode] = useState<LabelMode>('static'); const changeStylingMode = useCallback( ({ value }) => { setStylingMode(value); }, [setStylingMode], ); const labelModeChange = useCallback( ({ value }) => { setLabelMode(value); }, [setStylingMode], ); return ( <React.Fragment> <div className="options"> <div className="caption">Options</div> <div className="editors-modes"> <div className="option"> <SelectBox label="Styling Mode" labelMode="outside" stylingMode={defaultStylingMode} items={stylingModes} inputAttr={stylingModeLabel} value={stylingMode} onValueChanged={changeStylingMode} /> </div> <div className="option"> <SelectBox label="Label Mode" labelMode="outside" stylingMode={defaultStylingMode} items={labelModes} inputAttr={labelModeLabel} value={labelMode} onValueChanged={labelModeChange} /> </div> </div> </div> <div className="widgets-container"> <div className="title">Edit Profile</div> <TextBox id="name" stylingMode={stylingMode} defaultValue="Olivia Peyton" inputAttr={nameLabel} placeholder="Type..." label="Name" labelMode={labelMode} > <Validator> <RequiredRule /> </Validator> </TextBox> <TextBox id="address" stylingMode={stylingMode} placeholder="Type..." inputAttr={addressLabel} label="Address" labelMode={labelMode} > <Validator> <RequiredRule /> </Validator> </TextBox> <DateBox id="hire-date" stylingMode={stylingMode} placeholder="Select..." label="Hire Date" inputAttr={hireDateLabel} labelMode={labelMode} > <Validator> <RequiredRule /> </Validator> </DateBox> <DateBox id="birth-date" defaultValue="6/3/1981" stylingMode={stylingMode} placeholder="Birth Date" label="Birth Date" inputAttr={birthDateLabel} labelMode={labelMode} > <Validator> <RequiredRule /> </Validator> </DateBox> <SelectBox id="state" items={states} stylingMode={stylingMode} inputAttr={stateLabel} placeholder="Select..." label="State" labelMode={labelMode} validationMessagePosition="left" > <Validator> <RequiredRule /> </Validator> </SelectBox> <TextBox id="phone" stylingMode={stylingMode} mask="+1 (000) 000-0000" inputAttr={phoneLabel} maskRules={phoneRules} label="Phone" labelMode={labelMode} > <Validator> <RequiredRule /> </Validator> </TextBox> <DateRangeBox id="vacation-dates" startDate="6/3/2023" startDateLabel="Start Vacation Date" endDate="12/3/2023" endDateLabel="End Vacation Date" stylingMode={stylingMode} labelMode={labelMode} /> <TextArea id="notes" stylingMode={stylingMode} defaultValue="Olivia loves to sell. She has been selling DevAV products since 2012." placeholder="Type..." label="Notes" labelMode={labelMode} inputAttr={notesLabel} /> </div> <Button onClick={validateClick} text="Save" icon="save" type="default" id="validate" /> </React.Fragment> ); }
import React, { useCallback, useState } from 'react'; import notify from 'devextreme/ui/notify'; import { SelectBox } from 'devextreme-react/select-box'; import { TextBox } from 'devextreme-react/text-box'; import { DateBox } from 'devextreme-react/date-box'; import { DateRangeBox } from 'devextreme-react/date-range-box'; import { TextArea } from 'devextreme-react/text-area'; import { Button } from 'devextreme-react/button'; import { Validator, RequiredRule } from 'devextreme-react/validator'; import { states, stylingModes, labelModes, notesLabel, birthDateLabel, hireDateLabel, nameLabel, addressLabel, phoneLabel, stateLabel, labelModeLabel, stylingModeLabel, } from './data.js'; const phoneRules = { X: /[02-9]/, }; function validateClick({ validationGroup }) { const result = validationGroup.validate(); if (result.isValid) { notify('The task was saved successfully.', 'success'); } else { notify('The task was not saved. Please check if all fields are valid.', 'error'); } } export default function App() { const defaultStylingMode = 'outlined'; const [stylingMode, setStylingMode] = useState(defaultStylingMode); const [labelMode, setLabelMode] = useState('static'); const changeStylingMode = useCallback( ({ value }) => { setStylingMode(value); }, [setStylingMode], ); const labelModeChange = useCallback( ({ value }) => { setLabelMode(value); }, [setStylingMode], ); return ( <React.Fragment> <div className="options"> <div className="caption">Options</div> <div className="editors-modes"> <div className="option"> <SelectBox label="Styling Mode" labelMode="outside" stylingMode={defaultStylingMode} items={stylingModes} inputAttr={stylingModeLabel} value={stylingMode} onValueChanged={changeStylingMode} /> </div> <div className="option"> <SelectBox label="Label Mode" labelMode="outside" stylingMode={defaultStylingMode} items={labelModes} inputAttr={labelModeLabel} value={labelMode} onValueChanged={labelModeChange} /> </div> </div> </div> <div className="widgets-container"> <div className="title">Edit Profile</div> <TextBox id="name" stylingMode={stylingMode} defaultValue="Olivia Peyton" inputAttr={nameLabel} placeholder="Type..." label="Name" labelMode={labelMode} > <Validator> <RequiredRule /> </Validator> </TextBox> <TextBox id="address" stylingMode={stylingMode} placeholder="Type..." inputAttr={addressLabel} label="Address" labelMode={labelMode} > <Validator> <RequiredRule /> </Validator> </TextBox> <DateBox id="hire-date" stylingMode={stylingMode} placeholder="Select..." label="Hire Date" inputAttr={hireDateLabel} labelMode={labelMode} > <Validator> <RequiredRule /> </Validator> </DateBox> <DateBox id="birth-date" defaultValue="6/3/1981" stylingMode={stylingMode} placeholder="Birth Date" label="Birth Date" inputAttr={birthDateLabel} labelMode={labelMode} > <Validator> <RequiredRule /> </Validator> </DateBox> <SelectBox id="state" items={states} stylingMode={stylingMode} inputAttr={stateLabel} placeholder="Select..." label="State" labelMode={labelMode} validationMessagePosition="left" > <Validator> <RequiredRule /> </Validator> </SelectBox> <TextBox id="phone" stylingMode={stylingMode} mask="+1 (000) 000-0000" inputAttr={phoneLabel} maskRules={phoneRules} label="Phone" labelMode={labelMode} > <Validator> <RequiredRule /> </Validator> </TextBox> <DateRangeBox id="vacation-dates" startDate="6/3/2023" startDateLabel="Start Vacation Date" endDate="12/3/2023" endDateLabel="End Vacation Date" stylingMode={stylingMode} labelMode={labelMode} /> <TextArea id="notes" stylingMode={stylingMode} defaultValue="Olivia loves to sell. She has been selling DevAV products since 2012." placeholder="Type..." label="Notes" labelMode={labelMode} inputAttr={notesLabel} /> </div> <Button onClick={validateClick} text="Save" icon="save" type="default" id="validate" /> </React.Fragment> ); }
import React from 'react'; import ReactDOM from 'react-dom'; import App from './App.tsx'; ReactDOM.render(<App />, document.getElementById('app'));
export const states = ['AL', 'AK', 'AZ', 'AR', 'CA', 'CO', 'CT', 'DE', 'FL', 'GA', 'HI', 'ID', 'IL', 'IN', 'IA', 'KS', 'KY', 'LA', 'ME', 'MD', 'MA', 'MI', 'MN', 'MS', 'MO', 'MT', 'NE', 'NV', 'NH', 'NJ', 'NM', 'NY', 'NC', 'ND', 'OH', 'OK', 'OR', 'PA', 'RI', 'SC', 'SD', 'TN', 'TX', 'UT', 'VT', 'VA', 'WA', 'WV', 'WI', 'WY']; export const stylingModes = ['outlined', 'filled', 'underlined']; export const labelModes = ['static', 'floating', 'hidden', 'outside']; export const notesLabel = { 'aria-label': 'Notes' }; export const birthDateLabel = { 'aria-label': 'Birth Date' }; export const hireDateLabel = { 'aria-label': 'Hire Date' }; export const nameLabel = { 'aria-label': 'Name' }; export const addressLabel = { 'aria-label': 'Address' }; export const phoneLabel = { 'aria-label': 'Phone' }; export const stateLabel = { 'aria-label': 'State' }; export const labelModeLabel = { 'aria-label': 'Label Mode' }; export const stylingModeLabel = { 'aria-label': 'Styling Mode' };
window.exports = window.exports || {}; window.config = { transpiler: 'ts', typescriptOptions: { module: 'system', emitDecoratorMetadata: true, experimentalDecorators: true, jsx: 'react', }, meta: { 'react': { 'esModule': true, }, 'typescript': { 'exports': 'ts', }, 'devextreme/time_zone_utils.js': { 'esModule': true, }, 'devextreme/localization.js': { 'esModule': true, }, 'devextreme/viz/palette.js': { 'esModule': true, }, }, paths: { 'npm:': 'https://unpkg.com/', }, defaultExtension: 'js', map: { 'ts': 'npm:plugin-typescript@4.2.4/lib/plugin.js', 'typescript': 'npm:typescript@4.2.4/lib/typescript.js', 'react': 'npm:react@17.0.2/umd/react.development.js', 'react-dom': 'npm:react-dom@17.0.2/umd/react-dom.development.js', 'prop-types': 'npm:prop-types@15.8.1/prop-types.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.7/cjs', 'devextreme-react': 'npm:devextreme-react@24.1.7/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.13/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', 'devextreme-cldr-data': 'npm:devextreme-cldr-data@1.0.3', // SystemJS plugins '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': { defaultExtension: 'js', }, 'devextreme-react': { main: 'index.js', }, 'devextreme/events/utils': { main: 'index', }, 'devextreme/localization/messages': { format: 'json', defaultExtension: 'json', }, '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, react: true, }, }; System.config(window.config);
import React from 'react'; import ReactDOM from 'react-dom'; import App from './App.js'; ReactDOM.render(<App />, document.getElementById('app'));
export const states = [ 'AL', 'AK', 'AZ', 'AR', 'CA', 'CO', 'CT', 'DE', 'FL', 'GA', 'HI', 'ID', 'IL', 'IN', 'IA', 'KS', 'KY', 'LA', 'ME', 'MD', 'MA', 'MI', 'MN', 'MS', 'MO', 'MT', 'NE', 'NV', 'NH', 'NJ', 'NM', 'NY', 'NC', 'ND', 'OH', 'OK', 'OR', 'PA', 'RI', 'SC', 'SD', 'TN', 'TX', 'UT', 'VT', 'VA', 'WA', 'WV', 'WI', 'WY', ]; export const stylingModes = ['outlined', 'filled', 'underlined']; export const labelModes = ['static', 'floating', 'hidden', 'outside']; export const notesLabel = { 'aria-label': 'Notes' }; export const birthDateLabel = { 'aria-label': 'Birth Date' }; export const hireDateLabel = { 'aria-label': 'Hire Date' }; export const nameLabel = { 'aria-label': 'Name' }; export const addressLabel = { 'aria-label': 'Address' }; export const phoneLabel = { 'aria-label': 'Phone' }; export const stateLabel = { 'aria-label': 'State' }; export const labelModeLabel = { 'aria-label': 'Label Mode' }; export const stylingModeLabel = { 'aria-label': 'Styling Mode' };
<!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.7/css/dx.light.css" /> <link rel="stylesheet" type="text/css" href="styles.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.tsx"); </script> </head> <body class="dx-viewport"> <div class="demo-container"> <div id="app"></div> </div> </body> </html>
#app { height: 680px; } .widgets-container { display: grid; grid-template-areas: 'title title title title' 'name name birthDate birthDate ' 'address address state phone' 'hireDate hireDate range range' 'notes notes notes notes'; grid-template-columns: 1fr 1fr 1fr 1fr; gap: 20px; padding-left: 20px; padding-right: 20px; } .title { grid-area: title; font-size: 18px; font-weight: 500; } #name { grid-area: name; } #address { grid-area: address; } #birth-date { grid-area: birthDate; } #state { grid-area: state; } #phone { grid-area: phone; } #hire-date { grid-area: hireDate; } #notes { grid-area: notes; } #vacation-dates { grid-area: range; } #validate { float: right; margin-top: 20px; margin-right: 20px; width: 100px; } .options { grid-area: options; padding: 20px; margin-bottom: 40px; background-color: rgba(191, 191, 191, 0.15); } .caption { font-size: 18px; font-weight: 500; } .editors-modes { display: flex; } .option { padding-right: 20px; margin-top: 20px; }

To specify styles globally (as an alternative to stylingMode), set the editorStylingMode property instead (editorStylingMode applies the same style to all editors on the page).

In this demo, you can use the "Styling Mode/Label Mode" drop down box (in the Options section) to modify styling and label modes.