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:
-
labelLocation
Specifies whether to display labels above or to the left of corresponding editors. -
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.
window.onload = function () {
const showColon = ko.observable(true);
const formData = ko.observable(companies[0]);
const readOnly = ko.observable(false);
const labelLocation = ko.observable('top');
const minColWidth = ko.observable(300);
const colCount = ko.observable(2);
const widthValue = ko.observable(undefined);
const viewModel = {
formOptions: {
formData,
readOnly,
showColonAfterLabel: showColon,
labelLocation,
minColWidth,
colCount,
width: widthValue,
},
selectCompanyOptions: {
displayExpr: 'Name',
dataSource: companies,
value: formData,
},
readOnlyOptions: {
value: readOnly,
text: 'readOnly',
},
showColonOptions: {
value: showColon,
text: 'showColonAfterLabel',
},
labelLocationOptions: {
items: ['left', 'top'],
value: labelLocation,
},
minColWidthOptions: {
items: [150, 200, 300],
value: minColWidth,
},
colCountOptions: {
items: ['auto', 1, 2, 3],
value: colCount,
},
widthOptions: {
max: 550,
value: widthValue,
},
};
ko.applyBindings(viewModel, document.getElementById('form-demo'));
};
<!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>
<script src="https://cdnjs.cloudflare.com/ajax/libs/knockout/3.4.2/knockout-min.js"></script>
<link rel="stylesheet" type="text/css" href="https://cdn3.devexpress.com/jslib/21.2.3/css/dx.common.css" />
<link rel="stylesheet" type="text/css" href="https://cdn3.devexpress.com/jslib/21.2.3/css/dx.light.css" />
<script src="https://cdn3.devexpress.com/jslib/21.2.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>Select company:</div>
<div data-bind="dxSelectBox: selectCompanyOptions"></div>
<div id="form" data-bind="dxForm: formOptions"></div>
</div>
<div class="options">
<div class="caption">Options</div>
<div class="option">
<span>Label location:</span>
<div data-bind="dxSelectBox: labelLocationOptions"></div>
</div>
<div class="option">
<span>Columns count:</span>
<div data-bind="dxSelectBox: colCountOptions"></div>
</div>
<div class="option">
<span>Min column width:</span>
<div data-bind="dxSelectBox: minColWidthOptions"></div>
</div>
<div class="option">
<span>Form width:</span>
<div data-bind="dxNumberBox: widthOptions"></div>
</div>
<div class="option">
<div data-bind="dxCheckBox: readOnlyOptions"></div>
</div>
<div class="option">
<div data-bind="dxCheckBox: showColonOptions"></div>
</div>
</div>
</div>
</div>
</body>
</html>
.widget-container {
margin-right: 320px;
padding: 20px;
max-width: 550px;
min-width: 300px;
}
#form {
margin-top: 25px;
}
.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: 'http://www.nowebsitesupermart.com',
}, {
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: 'http://www.nowebsitedepot.com',
}, {
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: 'http://www.nowebsitemusic.com',
}, {
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: 'http://www.nowebsitetomsclub.com',
}];