Customize Fields at Runtime
The Form widget 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 widget'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.
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.
import React from 'react';
import 'devextreme-react/text-area';
import Form, { GroupItem, SimpleItem, Label } from 'devextreme-react/form';
import service from './data.js';
class App extends React.Component {
constructor(props) {
super(props);
this.employee = service.getEmployee();
this.checkBoxOptions = {
text: 'Show Address',
value: true,
onValueChanged: (e) => {
this.setState({
isHomeAddressVisible: e.component.option('value')
});
}
};
this.addPhoneButtonOptions = {
icon: 'add',
text: 'Add phone',
onClick: () => {
this.employee.Phones.push('');
this.updatePhones();
}
};
this.state = {
phoneOptions: this.getPhonesOptions(),
isHomeAddressVisible: true
};
this.generateNewPhoneOptions = this.generateNewPhoneOptions.bind(this);
this.getPhonesOptions = this.getPhonesOptions.bind(this);
this.updatePhones = this.updatePhones.bind(this);
}
render() {
return (
<React.Fragment>
<div className="long-title"><h3>Personal details</h3></div>
<div className="form-container">
<Form
colCount={2}
id="form"
formData={this.employee}>
<GroupItem>
<GroupItem>
<GroupItem caption="Personal Data">
<SimpleItem dataField="FirstName" />
<SimpleItem dataField="LastName" />
<SimpleItem editorType="dxCheckBox" editorOptions={this.checkBoxOptions} />
</GroupItem>
</GroupItem>
<GroupItem>
<GroupItem caption="Home Address"
name="HomeAddress"
visible={this.state.isHomeAddressVisible}>
<SimpleItem dataField="Address" />
<SimpleItem dataField="City" />
</GroupItem>
</GroupItem>
</GroupItem>
<GroupItem caption="Phones"
name="phones-container">
<GroupItem
name="phones">
{ this.state.phoneOptions.map((phone, index) =>
<SimpleItem
key = {`Phones${ index}`}
dataField={`Phones[${index}]`}
editorOptions={phone}>
<Label text={`Phone ${ index + 1}`} />
</SimpleItem>
)}
</GroupItem>
<SimpleItem itemType="button"
horizontalAlignment="left"
cssClass="add-phone-button"
buttonOptions={this.addPhoneButtonOptions}>
</SimpleItem>
</GroupItem>
</Form>
</div>
</React.Fragment>
);
}
getPhonesOptions() {
var options = [];
for (var i = 0; i < this.employee.Phones.length; i++) {
options.push(this.generateNewPhoneOptions(i));
}
return options;
}
generateNewPhoneOptions(index) {
return {
mask: '+1 (X00) 000-0000',
maskRules: { 'X': /[01-9]/ },
buttons: [{
name: 'trash',
location: 'after',
options: {
stylingMode: 'text',
icon: 'trash',
onClick: () => {
this.employee.Phones.splice(index, 1);
this.updatePhones();
}
}
}]
};
}
updatePhones() {
this.setState({
phoneOptions: this.getPhonesOptions()
});
}
}
export default App;
import React from 'react';
import ReactDOM from 'react-dom';
import App from './App.js';
ReactDOM.render(
<App />,
document.getElementById('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="stylesheet" type="text/css" href="https://cdn3.devexpress.com/jslib/20.1.6/css/dx.common.css" />
<link rel="stylesheet" type="text/css" href="https://cdn3.devexpress.com/jslib/20.1.6/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="styles.css" />
<script src="https://unpkg.com/core-js@2.4.1/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>
.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;
}
const employee = {
FirstName: 'John',
LastName: 'Heart',
Address: '351 S Hill St., Los Angeles, CA',
City: 'Atlanta',
Phones: ['8005552797', '8005953232']
};
export default {
getEmployee() {
return employee;
}
};
System.config({
transpiler: 'plugin-babel',
meta: {
},
paths: {
'npm:': 'https://unpkg.com/'
},
defaultExtension: 'js',
map: {
'react': 'npm:react@16/umd/react.development.js',
'react-dom': 'npm:react-dom@16/umd/react-dom.development.js',
'prop-types': 'npm:prop-types/prop-types.js',
'devextreme': 'npm:devextreme@20.1',
'devextreme-react': 'npm:devextreme-react@20.1',
'jszip': 'npm:jszip@3.1.3/dist/jszip.min.js',
'quill': 'npm:quill@1.3.7/dist/quill.js',
'devexpress-diagram': 'npm:devexpress-diagram@1.0.9',
'devexpress-gantt': 'npm:devexpress-gantt@1.0.7',
// SystemJS plugins
'plugin-babel': 'npm:systemjs-plugin-babel@0/plugin-babel.js',
'systemjs-babel-build': 'npm:systemjs-plugin-babel@0/systemjs-babel-browser.js'
},
packages: {
'devextreme': {
defaultExtension: 'js'
},
'devextreme-react': {
main: 'index.js'
},
'devextreme/events/utils': {
main: 'index'
},
'devextreme/events': {
main: 'index'
},
},
babelOptions: {
sourceMaps: false,
stage0: true,
react: true
}
});