Overview
The Form component builds a data entry UI for an object assigned to the formData property. The component displays and aligns label-editor pairs for each field in the bound object.
You can use the editors on the right to modify the following properties:
-
labelMode: "outside" | "static" | "floating" | "hidden"
Specifies label display mode. -
labelLocation: "top" | "left" | "right"
Specifies whether to place outer labels above, to the left, or to the right of corresponding editors. The latter location is not demonstrated in this example. -
colCount
Specifies the number of columns in the layout. To build an adaptive layout where the column count depends on the container width, set this property's value to "auto". -
minColWidth
Specifies the minimum column width. Use this property when the colCount property's value is "auto". -
width
Specifies the Form component's width. -
readOnly
Makes the Form editors read-only. -
showColonAfterLabel
Specifies whether the Form displays a colon after a label.
To get started with the DevExtreme Form component, refer to the following tutorial for step-by-step instructions: Getting Started with 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.
$(() => {
const form = $('#form').dxForm({
labelMode: 'floating',
formData: companies[0],
readOnly: false,
showColonAfterLabel: true,
labelLocation: 'left',
minColWidth: 300,
colCount: 2,
}).dxForm('instance');
const companySelectorSelectBox = $('#select-company').dxSelectBox({
displayExpr: 'Name',
dataSource: companies,
labelMode: 'floating',
label: 'Select company',
value: companies[0],
onValueChanged(data) {
form.option('formData', data.value);
},
}).dxSelectBox('instance');
const companySelectorText = $('#select-company-text');
$('#label-mode').dxSelectBox({
items: ['outside', 'static', 'floating', 'hidden'],
value: 'floating',
onValueChanged(data) {
form.option('labelMode', data.value);
if (data.value === 'outside') {
companySelectorSelectBox.option('labelMode', 'hidden');
companySelectorText.show();
} else {
companySelectorSelectBox.option('labelMode', data.value);
companySelectorText.hide();
}
},
});
$('#label-location').dxSelectBox({
items: ['left', 'top'],
value: 'left',
onValueChanged(data) {
form.option('labelLocation', data.value);
},
});
$('#columns-count').dxSelectBox({
items: ['auto', 1, 2, 3],
value: 2,
onValueChanged(data) {
form.option('colCount', data.value);
},
});
$('#min-column-width').dxSelectBox({
items: [150, 200, 300],
value: 300,
onValueChanged(data) {
form.option('minColWidth', data.value);
},
});
$('#width').dxNumberBox({
value: undefined,
max: 550,
onValueChanged(data) {
form.option('width', data.value);
},
});
$('#read-only').dxCheckBox({
text: 'readOnly',
value: false,
onValueChanged(data) {
form.option('readOnly', data.value);
},
});
$('#show-colon').dxCheckBox({
text: 'showColonAfterLabel',
value: true,
onValueChanged(data) {
form.option('showColonAfterLabel', data.value);
},
});
});
<!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/22.1.3/css/dx.common.css" />
<link rel="stylesheet" type="text/css" href="https://cdn3.devexpress.com/jslib/22.1.3/css/dx.light.css" />
<script src="https://cdn3.devexpress.com/jslib/22.1.3/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 id="form-demo">
<div class="widget-container">
<div id="select-company-text">Select company:</div>
<div id="select-company"></div>
<div id="form"></div>
</div>
<div class="options">
<div class="caption">Options</div>
<div class="option">
<span>Label mode:</span>
<div id="label-mode"></div>
</div>
<div class="option">
<span>Label location:</span>
<div id="label-location"></div>
</div>
<div class="option">
<span>Columns count:</span>
<div id="columns-count"></div>
</div>
<div class="option">
<span>Min column width:</span>
<div id="min-column-width"></div>
</div>
<div class="option">
<span>Form width:</span>
<div id="width"></div>
</div>
<div class="option">
<div id="read-only"></div>
</div>
<div class="option">
<div id="show-colon"></div>
</div>
</div>
</div>
</div>
</body>
</html>
.widget-container {
margin-right: 320px;
padding: 20px;
max-width: 550px;
min-width: 300px;
}
#form {
margin-top: 25px;
}
#select-company-text {
display: none;
}
.options {
padding: 20px;
position: absolute;
bottom: 0;
right: 0;
width: 260px;
top: 0;
background-color: rgba(191, 191, 191, 0.15);
}
.caption {
font-size: 18px;
font-weight: 500;
}
.option {
margin-top: 10px;
}
const companies = [{
ID: 1,
Name: 'Super Mart of the West',
Address: '702 SW 8th Street',
City: 'Bentonville',
State: 'Arkansas',
ZipCode: 72716,
Phone: '(800) 555-2797',
Fax: '(800) 555-2171',
Website: '',
Active: true,
}, {
ID: 2,
Name: 'Electronics Depot',
Address: '2455 Paces Ferry Road NW',
City: 'Atlanta',
State: 'Georgia',
ZipCode: 30339,
Phone: '(800) 595-3232',
Fax: '(800) 595-3231',
Website: '',
Active: true,
}, {
ID: 3,
Name: 'K&S Music',
Address: '1000 Nicllet Mall',
City: 'Minneapolis',
State: 'Minnesota',
ZipCode: 55403,
Phone: '(612) 304-6073',
Fax: '(612) 304-6074',
Website: '',
Active: true,
}, {
ID: 4,
Name: "Tom's Club",
Address: '999 Lake Drive',
City: 'Issaquah',
State: 'Washington',
ZipCode: 98027,
Phone: '(800) 955-2292',
Fax: '(800) 955-2293',
Website: '',
Active: true,
}];