-
AI-powered Extensions
-
Data Grid
-
Tree List
-
Chat
-
HTML Editor
-
Form
-
-
Data Grids / Data Management
-
Data Grid
- Overview
-
Data Binding
-
Filtering
- Sorting
-
Editing
-
Grouping
-
Selection
- Focused Row
- Paging
-
Scrolling
-
Columns
- AI Assistant
-
Master-Detail
-
Data Summaries
-
Drag & Drop
-
Export to PDF
-
Export to Excel
- Appearance
-
Customization
- State Persistence
-
Adaptability
-
Keyboard Navigation
- Right-To-Left Support
-
Tree List
- Overview
-
Data Binding
-
Filtering
- Sorting
-
Editing
-
Selection
- Focused Row
- Paging
-
Columns
- Drag & Drop
- State Persistence
- Adaptability
-
Keyboard Navigation
-
Card View
-
Pivot Grid
- Overview
-
Data Binding
-
Field Management
-
Data Summaries
- Drill Down
- Filtering
-
Scrolling
-
Export to Excel
- Chart Integration
- Customization
- State Persistence
-
Filter Builder
-
-
Data Visualization
-
Charts
- Overview
-
Data Binding
-
Common Concepts
-
Axis
-
Aggregation
-
Tooltips
-
Selection
-
Customization
-
Zooming
-
Export
-
-
Area Charts
-
Bar Charts
- Bullet Charts
-
Doughnut Charts
-
Financial Charts
-
Funnel and Pyramid Charts
-
Line Charts
- Pareto Chart
-
Pie Charts
-
Point Charts
-
Polar and Radar Charts
-
Range Charts
- Sankey Chart
-
Sparkline Charts
-
Tree Map
-
Gauges
- Overview
-
Runtime update
-
Bar Gauge
-
Circular Gauge
-
Linear Gauge
-
Diagram
- Overview
-
Data Binding
-
Featured Shapes
-
Custom Shapes
-
Document Capabilities
-
User Interaction
- UI Customization
- Adaptability
-
-
Scheduling / Planning
-
Scheduler
- Overview
-
Data Binding
-
Views
-
Appointments
-
Timetable
- Editing
-
Grouping
- Virtual Scrolling
- Drag & Drop
-
Customization
- Adaptability
-
Gantt
- Overview
- Data Binding
-
Filtering
- Sorting
- Strip Lines
- Export to PDF
- Validation
-
Customization
-
-
Messaging
-
WYSIWYG Editor
-
Forms
-
Data Editors
- Overview
-
Common Concepts
-
Calendar
- Check Box
- Color Box
-
Date Box
-
Date Range Box
-
Number Box
- Radio Group
-
Range Selector
- Range Slider
- Slider
- Switch
- Text Area
- Text Box
-
Drop-Downs
- Autocomplete
-
Drop Down Box
-
Select Box
-
Tag Box
-
Lookup
-
Buttons
-
File Upload / File Management
-
File Manager
- Overview
-
File System Types
-
Customization
-
File Uploader
-
-
Popup and Notifications
-
Navigation
- Overview
- Accordion
-
Action Sheet
-
Context Menu
-
Menu
- Multi View
-
Drawer
-
Tab Panel
-
Tabs
-
Toolbar
-
Stepper
- Pagination
-
List
-
Tree View
- Right-to-Left Support
-
Layout
-
Tile View
- Splitter
-
Gallery
- Scroll View
- Box
- Responsive Box
-
-
Interactive Wrappers
-
Sortable
- Resizable
-
-
Progress Indicators
-
Maps
- Overview
-
Map
-
Vector Map
-
Data Binding
- Multiple Layers
-
Markers
- Legend
-
Zooming and Panning
-
Customization
-
-
Localization
Related Demos:
Your search did not match any results.
React Form - Customize Fields at Runtime
The Form component allows you to add/remove items and specify item visibility at runtime. The Form only updates the affected items and does not re-render the entire form.
In this demo, the "Show Address" checkbox specifies the visibility of address-related fields. Review the component's code to see how to set the "HomeAddress" group's visible attribute.
Click the "Add phone" button to add a new phone editor. This action adds a new item to the items array of the "phones" group. Each phone editor contains a button that deletes it from the items array and the Form.
Backend API
import React, { useCallback, useMemo, useState } from 'react';
import 'devextreme-react/text-area';
import Form, {
GroupItem,
SimpleItem,
Label,
ButtonItem,
} from 'devextreme-react/form';
import type { CheckBoxTypes, ICheckBoxOptions } from 'devextreme-react/check-box';
import type { ITextBoxOptions } from 'devextreme-react/text-box';
import type { IButtonOptions } from 'devextreme-react/button';
import { employee } from './data.ts';
import type { Employee } from './types.ts';
const App = () => {
const [phones, setPhones] = useState<string[]>(employee.Phones);
const [isHomeAddressVisible, setIsHomeAddressVisible] = useState<CheckBoxTypes.Properties['value']>(true);
const formData = useMemo((): Employee => ({ ...employee, Phones: phones }), [phones]);
const CheckBoxOptions = useMemo((): ICheckBoxOptions => ({
text: 'Show Address',
value: isHomeAddressVisible,
onValueChanged: (e: CheckBoxTypes.ValueChangedEvent): void => {
setIsHomeAddressVisible(e.component.option('value'));
},
}), [isHomeAddressVisible]);
const generateNewPhoneOptions = useCallback((index: number): ITextBoxOptions => ({
mask: '(X00) 000-0000',
maskRules: { X: /[01-9]/ },
buttons: [{
name: 'trash',
location: 'after',
options: {
stylingMode: 'text',
icon: 'trash',
onClick: (): void => {
const newPhones = phones.slice(0, index).concat(phones.slice(index + 1));
setPhones(newPhones);
},
},
}],
}), [phones]);
const PhoneOptions = useMemo((): ITextBoxOptions[] => {
const options: ITextBoxOptions[] = [];
for (let i = 0; i < phones.length; i += 1) {
options.push(generateNewPhoneOptions(i));
}
return options;
}, [phones, generateNewPhoneOptions]);
const PhoneButtonOptions = useMemo((): IButtonOptions => ({
icon: 'add',
text: 'Add phone',
onClick: (): void => {
setPhones((prevPhones: string[]): string[] => [...prevPhones, '']);
},
}), []);
return (
<>
<div className="long-title"><h3>Personal details</h3></div>
<div className="form-container">
<Form
colCount={2}
id="form"
formData={formData}>
<GroupItem>
<GroupItem>
<GroupItem caption="Personal Data">
<SimpleItem dataField="FirstName" />
<SimpleItem dataField="LastName" />
<SimpleItem editorType="dxCheckBox" editorOptions={CheckBoxOptions} />
</GroupItem>
</GroupItem>
<GroupItem>
<GroupItem caption="Home Address"
name="HomeAddress"
visible={!!isHomeAddressVisible}>
<SimpleItem dataField="Address" />
<SimpleItem dataField="City" />
</GroupItem>
</GroupItem>
</GroupItem>
<GroupItem caption="Phones"
name="phones-container">
<GroupItem
name="phones">
{PhoneOptions.map((options: ITextBoxOptions, index: number) => <SimpleItem
key={`Phones${index}`}
dataField={`Phones[${index}]`}
editorOptions={options}>
<Label text={`Phone ${index + 1}`} />
</SimpleItem>)}
</GroupItem>
<ButtonItem
horizontalAlignment="left"
cssClass="add-phone-button"
buttonOptions={PhoneButtonOptions}>
</ButtonItem>
</GroupItem>
</Form>
</div>
</>
);
};
export default App;
import React, { useCallback, useMemo, useState } from 'react';
import 'devextreme-react/text-area';
import Form, {
GroupItem, SimpleItem, Label, ButtonItem,
} from 'devextreme-react/form';
import { employee } from './data.js';
const App = () => {
const [phones, setPhones] = useState(employee.Phones);
const [isHomeAddressVisible, setIsHomeAddressVisible] = useState(true);
const formData = useMemo(() => ({ ...employee, Phones: phones }), [phones]);
const CheckBoxOptions = useMemo(
() => ({
text: 'Show Address',
value: isHomeAddressVisible,
onValueChanged: (e) => {
setIsHomeAddressVisible(e.component.option('value'));
},
}),
[isHomeAddressVisible],
);
const generateNewPhoneOptions = useCallback(
(index) => ({
mask: '(X00) 000-0000',
maskRules: { X: /[01-9]/ },
buttons: [
{
name: 'trash',
location: 'after',
options: {
stylingMode: 'text',
icon: 'trash',
onClick: () => {
const newPhones = phones.slice(0, index).concat(phones.slice(index + 1));
setPhones(newPhones);
},
},
},
],
}),
[phones],
);
const PhoneOptions = useMemo(() => {
const options = [];
for (let i = 0; i < phones.length; i += 1) {
options.push(generateNewPhoneOptions(i));
}
return options;
}, [phones, generateNewPhoneOptions]);
const PhoneButtonOptions = useMemo(
() => ({
icon: 'add',
text: 'Add phone',
onClick: () => {
setPhones((prevPhones) => [...prevPhones, '']);
},
}),
[],
);
return (
<>
<div className="long-title">
<h3>Personal details</h3>
</div>
<div className="form-container">
<Form
colCount={2}
id="form"
formData={formData}
>
<GroupItem>
<GroupItem>
<GroupItem caption="Personal Data">
<SimpleItem dataField="FirstName" />
<SimpleItem dataField="LastName" />
<SimpleItem
editorType="dxCheckBox"
editorOptions={CheckBoxOptions}
/>
</GroupItem>
</GroupItem>
<GroupItem>
<GroupItem
caption="Home Address"
name="HomeAddress"
visible={!!isHomeAddressVisible}
>
<SimpleItem dataField="Address" />
<SimpleItem dataField="City" />
</GroupItem>
</GroupItem>
</GroupItem>
<GroupItem
caption="Phones"
name="phones-container"
>
<GroupItem name="phones">
{PhoneOptions.map((options, index) => (
<SimpleItem
key={`Phones${index}`}
dataField={`Phones[${index}]`}
editorOptions={options}
>
<Label text={`Phone ${index + 1}`} />
</SimpleItem>
))}
</GroupItem>
<ButtonItem
horizontalAlignment="left"
cssClass="add-phone-button"
buttonOptions={PhoneButtonOptions}
></ButtonItem>
</GroupItem>
</Form>
</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 type { Employee } from './types.ts';
export const employee: Employee = {
FirstName: 'John',
LastName: 'Heart',
Address: '351 S Hill St., Los Angeles, CA',
City: 'Atlanta',
Phones: ['8005552797', '8005953232'],
};
export type Employee = {
FirstName: string;
LastName: string;
Address: string;
City: string;
Phones: string[];
};
import React from 'react';
import ReactDOM from 'react-dom';
import App from './App.js';
ReactDOM.render(<App />, document.getElementById('app'));
export const employee = {
FirstName: 'John',
LastName: 'Heart',
Address: '351 S Hill St., Los Angeles, CA',
City: 'Atlanta',
Phones: ['8005552797', '8005953232'],
};
<!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="https://maxcdn.bootstrapcdn.com/font-awesome/4.6.3/css/font-awesome.min.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>
.form-container {
margin: 10px 10px 30px;
}
.long-title h3 {
font-family: 'Segoe UI Light', 'Helvetica Neue Light', 'Segoe UI', 'Helvetica Neue', 'Trebuchet MS', Verdana;
font-weight: 200;
font-size: 28px;
text-align: center;
margin-bottom: 20px;
}
.add-phone-button {
margin-top: 10px;
}