DevExtreme v23.2 is now available.

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

Your search did not match any results.

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
$(() => { const form = $('#form').dxForm({ colCount: 2, formData: employee, items: [ { itemType: 'group', items: [ { itemType: 'group', caption: 'Personal Data', items: ['FirstName', 'LastName', { itemType: 'simple', editorType: 'dxCheckBox', editorOptions: { text: 'Show Address', value: true, onValueChanged(e) { form.itemOption('HomeAddress', 'visible', e.value); }, }, }], }, { itemType: 'group', items: [{ itemType: 'group', name: 'HomeAddress', caption: 'Home Address', items: ['Address', 'City'], }], }, ], }, { itemType: 'group', caption: 'Phones', name: 'phones-container', items: [ { itemType: 'group', name: 'phones', items: getPhonesOptions(employee.Phones), }, { itemType: 'button', horizontalAlignment: 'left', cssClass: 'add-phone-button', buttonOptions: { icon: 'add', text: 'Add phone', onClick() { employee.Phones.push(''); form.itemOption('phones-container.phones', 'items', getPhonesOptions(employee.Phones)); }, }, }, ], }, ], }).dxForm('instance'); function getPhonesOptions(phones) { const options = []; for (let i = 0; i < phones.length; i += 1) { options.push(generateNewPhoneOptions(i)); } return options; } function generateNewPhoneOptions(index) { return { dataField: `Phones[${index}]`, editorType: 'dxTextBox', cssClass: 'phone-editor', label: { text: `Phone ${index + 1}`, }, editorOptions: { mask: '+1 (X00) 000-0000', maskRules: { X: /[01-9]/ }, buttons: [{ name: 'trash', location: 'after', options: { stylingMode: 'text', icon: 'trash', onClick() { employee.Phones.splice(index, 1); form.itemOption('phones-container.phones', 'items', getPhonesOptions(employee.Phones)); }, }, }], }, }; } });
<!DOCTYPE html> <html xmlns="http://www.w3.org/1999/xhtml"> <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" /> <script src="https://ajax.googleapis.com/ajax/libs/jquery/3.5.1/jquery.min.js"></script> <script>window.jQuery || document.write(decodeURIComponent('%3Cscript src="js/jquery.min.js"%3E%3C/script%3E'))</script> <link rel="stylesheet" type="text/css" href="https://cdn3.devexpress.com/jslib/23.2.5/css/dx.light.css" /> <script src="js/dx.all.js"></script> <script src="data.js"></script> <link rel="stylesheet" type="text/css" href="styles.css" /> <script src="index.js"></script> </head> <body class="dx-viewport"> <div class="demo-container"> <div class="long-title"><h3>Personal details</h3></div> <div id="form-container"> <div id="form"></div> </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'], };