Overview
Documentation
The Form widget allows you to visually represent and edit data stored in an object. The widget binds each layout item to a specific field in an existing data object. To display a simple form, you can assign the required object to the formData option. With the Form widget, you can specify the location of labels against corresponding editors and number of columns used in the form layout. Optionally, the widget can determine the column count based on current form width (adaptive rendering).
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.
<div id="form-demo">
<div class="widget-container">
<div>Select company:</div>
<dx-select-box #company
displayExpr="Name"
[(dataSource)]="companies"
[value]="companies[0]"></dx-select-box>
<dx-form id="form"
[(formData)]="company.value"
[readOnly]="readOnly"
[showColonAfterLabel]="showColon"
[labelLocation]="labelLocation"
[minColWidth]="minColWidth"
[colCount]="colCount"
[width]="width"></dx-form>
</div>
<div class="options">
<div class="caption">Options</div>
<div class="option">
<span>Label location:</span>
<dx-select-box
[items]="['left', 'top']"
[(value)]="labelLocation"></dx-select-box>
</div>
<div class="option">
<span>Columns count:</span>
<dx-select-box
[items]="['auto', 1, 2, 3]"
[(value)]="colCount"></dx-select-box>
</div>
<div class="option">
<span>Min column width:</span>
<dx-select-box
[items]="[150, 200, 300]"
[(value)]="minColWidth"></dx-select-box>
</div>
<div class="option">
<span>Form width:</span>
<dx-number-box
[max]="550"
[(value)]="width"></dx-number-box>
</div>
<div class="option">
<dx-check-box
text="readOnly"
[(value)]="readOnly"></dx-check-box>
</div>
<div class="option">
<dx-check-box
text="showColonAfterLabel"
[(value)]="showColon"></dx-check-box>
</div>
</div>
</div>
import { NgModule, Component, enableProdMode } from '@angular/core';
import { BrowserModule } from '@angular/platform-browser';
import { platformBrowserDynamic } from '@angular/platform-browser-dynamic';
import { DxCheckBoxModule,
DxSelectBoxModule,
DxNumberBoxModule,
DxFormModule } from 'devextreme-angular';
import { Company, Service } from './app.service';
if(!/localhost/.test(document.location.host)) {
enableProdMode();
}
@Component({
selector: 'demo-app',
providers: [ Service ],
templateUrl: 'app/app.component.html',
styleUrls: ['app/app.component.css']
})
export class AppComponent {
companies: Company[];
labelLocation: string;
readOnly: boolean;
showColon: boolean;
minColWidth: number;
colCount: number;
width: any;
constructor( service: Service ) {
this.labelLocation = "top";
this.readOnly = false;
this.showColon = true;
this.minColWidth = 300;
this.colCount = 2;
this.companies = service.getCompanies();
}
}
@NgModule({
imports: [
BrowserModule,
DxCheckBoxModule,
DxSelectBoxModule,
DxNumberBoxModule,
DxFormModule
],
declarations: [AppComponent],
bootstrap: [AppComponent]
})
export class AppModule { }
platformBrowserDynamic().bootstrapModule(AppModule);
::ng-deep .widget-container {
margin-right: 320px;
padding: 20px;
max-width: 550px;
min-width: 300px;
}
::ng-deep #form {
margin-top: 25px;
}
::ng-deep .options {
padding: 20px;
position: absolute;
bottom: 0;
right: 0;
width: 260px;
top: 0;
background-color: rgba(191, 191, 191, 0.15);
}
::ng-deep .caption {
font-size: 18px;
font-weight: 500;
}
::ng-deep.option {
margin-top: 10px;
}
import { Injectable } from '@angular/core';
export class Company {
ID: number;
Name: string;
Address: string;
City: string;
State: string;
ZipCode: number;
Phone: string;
Fax: string;
Website: string;
}
let companies: Company[] = [{
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"
}];
@Injectable()
export class Service {
getCompanies() : Company[] {
return companies;
}
}
// In real applications, you should not transpile code in the browser. You can see how to create your own application with Angular and DevExtreme here:
// https://js.devexpress.com/Documentation/Guide/Angular_Components/Getting_Started/Create_a_DevExtreme_Application/
System.config({
transpiler: 'ts',
typescriptOptions: {
module: "system",
emitDecoratorMetadata: true,
experimentalDecorators: true
},
meta: {
'typescript': {
"exports": "ts"
},
'devextreme/localization.js': {
"esModule": true
}
},
paths: {
'npm:': 'https://unpkg.com/'
},
map: {
'ts': 'npm:plugin-typescript@8.0.0/lib/plugin.js',
'typescript': 'npm:typescript@3.5.3/lib/typescript.js',
'@angular': 'npm:@angular',
'tslib': 'npm:tslib@2.0.3/tslib.js',
'rxjs': 'npm:rxjs@6.3.3',
'rrule': 'npm:rrule@2.6.6/dist/es5/rrule.js',
'luxon': 'npm:luxon@1.25.0/build/global/luxon.min.js',
'es6-object-assign': 'npm:es6-object-assign@1.1.0',
'devextreme': 'npm:devextreme@20.2.3',
'jszip': 'npm:jszip@3.5.0/dist/jszip.min.js',
'devextreme-quill': 'npm:devextreme-quill@0.9.5/dist/dx-quill.min.js',
'devexpress-diagram': 'npm:devexpress-diagram@2.0.0',
'devexpress-gantt': 'npm:devexpress-gantt@2.0.0',
'devextreme-angular': 'npm:devextreme-angular@20.2.3',
'preact': 'npm:preact@10.5.5/dist/preact.js',
'preact/hooks': 'npm:preact@10.5.5/hooks/dist/hooks.js'
},
packages: {
'app': {
main: './app.component.ts',
defaultExtension: 'ts'
},
'devextreme': {
defaultExtension: 'js'
},
'devextreme/events/utils': {
main: 'index'
},
'devextreme/events': {
main: 'index'
},
'es6-object-assign': {
main: './index.js',
defaultExtension: 'js'
}
},
packageConfigPaths: [
"npm:@angular/*/package.json",
"npm:@angular/common/*/package.json",
"npm:rxjs/package.json",
"npm:rxjs/operators/package.json",
"npm:devextreme-angular/*/package.json",
"npm:devextreme-angular/ui/*/package.json",
"npm:devextreme-angular/package.json",
"npm:devexpress-diagram/package.json",
"npm:devexpress-gantt/package.json",
]
});
<!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" />
<link rel="stylesheet" type="text/css" href="https://cdn3.devexpress.com/jslib/20.2.3/css/dx.common.css" />
<link rel="stylesheet" type="text/css" href="https://cdn3.devexpress.com/jslib/20.2.3/css/dx.light.css" />
<script src="https://unpkg.com/core-js@2.4.1/client/shim.min.js"></script>
<script src="https://unpkg.com/zone.js@0.10.2/dist/zone.js"></script>
<script src="https://unpkg.com/reflect-metadata@0.1.3/Reflect.js"></script>
<script src="https://unpkg.com/systemjs@0.21.3/dist/system.js"></script>
<script src="config.js"></script>
<script>
System.import('app').catch(console.error.bind(console));
</script>
</head>
<body class="dx-viewport">
<div class="demo-container">
<demo-app>Loading...</demo-app>
</div>
</body>
</html>