Customize Item

You can use the items[] array to configure all form items. This array can contain strings (formData field names) and objects (item configurations).

Use a string to create a simple item with default configuration as shown for the Email item.

To change the default settings, declare an item configuration object. Use the dataField property to bind an item to a field in the formData object. Use the editorType property to specify an item's data editor or configure the editor in the editorOptions object. You can also specify any other properties described in the SimpleItem section.

To customize item labels, use the label.template property. The demo uses this property to add icons to the labels. Refer to the Additional Notes item's implementation for instructions on how to add an icon with a tooltip to the label.

This demo shows how to specify editorOptions, editorType, validationRules, and colSpan properties for simple items in a Form component.

Prev Demo

Next Demo

Was this demo helpful?

Thank you!

Feel free to share demo-related thoughts here.
If you have technical questions, please create a support ticket in the DevExpress Support Center.

Thank you for the feedback!

Backend API

<template> <DxForm :on-content-ready="validateForm" :form-data="employee" > <DxGroupItem :col-count="2" caption="Employee Details" > <DxItem :editor-options="nameEditorOptions" data-field="FirstName" > <DxLabel template="nameLabel"/> </DxItem> <DxItem :editor-options="positionEditorOptions" :validation-rules="validationRules.position" data-field="Position" editor-type="dxSelectBox" > <DxLabel template="positionLabel"/> </DxItem> <DxItem :editor-options="nameEditorOptions" data-field="LastName" > <DxLabel template="nameLabel"/> </DxItem> <DxItem :editor-options="hireDateEditorOptions" :validation-rules="validationRules.hireDate" data-field="HireDate" editor-type="dxDateBox" > <DxLabel template="dateLabel"/> </DxItem> <DxItem :editor-options="birthDateEditorOptions" data-field="BirthDate" editor-type="dxDateBox" > <DxLabel template="dateLabel"/> </DxItem> <DxItem data-field="Address" > <DxLabel template="addressLabel"/> </DxItem> <DxItem :col-span="2" :editor-options="notesEditorOptions" data-field="Notes" editor-type="dxTextArea" > <DxLabel template="notesLabel"/> </DxItem> <DxItem :editor-options="phoneEditorOptions" data-field="Phone" > <DxLabel template="phoneLabel"/> </DxItem> <DxItem data-field="Email" > <DxLabel template="emailLabel"/> </DxItem> </DxGroupItem> <template #nameLabel="{ data }"> <LabelTemplate :data="data" icon="user" /> </template> <template #positionLabel="{ data }"> <LabelTemplate :data="data" icon="info" /> </template> <template #dateLabel="{ data }"> <LabelTemplate :data="data" icon="event" /> </template> <template #addressLabel="{ data }"> <LabelTemplate :data="data" icon="home" /> </template> <template #notesLabel="{ data }"> <LabelNotesTemplate :data="data" /> </template> <template #phoneLabel="{ data }"> <LabelTemplate :data="data" icon="tel" /> </template> <template #emailLabel="{ data }"> <LabelTemplate :data="data" icon="email" /> </template> </DxForm> </template> <script> import { DxForm, DxItem, DxLabel, DxGroupItem, } from 'devextreme-vue/form'; import { DxTooltip } from 'devextreme-vue/tooltip'; import service from './data.js'; import 'devextreme-vue/text-area'; import LabelTemplate from './LabelTemplate.vue'; import LabelNotesTemplate from './LabelNotesTemplate.vue'; export default { components: { DxForm, DxItem, DxLabel, DxTooltip, DxGroupItem, LabelTemplate, LabelNotesTemplate, }, data() { const employee = service.getEmployee(); const positions = service.getPositions(); return { employee, positions, validationRules: { position: [ { type: 'required', message: 'Position is required.' }, ], hireDate: [ { type: 'required', message: 'Hire Date is required.' }, ], }, nameEditorOptions: { disabled: true }, positionEditorOptions: { items: positions, searchEnabled: true, value: '' }, hireDateEditorOptions: { width: '100%', value: null }, birthDateEditorOptions: { width: '100%', disabled: true }, notesEditorOptions: { height: 90, maxLength: 200 }, phoneEditorOptions: { mask: '+1 (X00) 000-0000', maskRules: { X: /[02-9]/ } }, }; }, methods: { validateForm(e) { e.component.validate(); }, }, }; </script>

<template> <div id="template-content"> <i id="helpedInfo" class="dx-icon dx-icon-info" /> Additional <br> {{ data.text }} <DxTooltip target="#helpedInfo" show-event="mouseenter" hide-event="mouseleave" > <template #content> <div id="tooltip-content">This field must not exceed 200 characters</div> </template> </DxTooltip> </div> </template> <script> import { DxTooltip } from 'devextreme-vue/tooltip'; export default { components: { DxTooltip, }, props: { data: { type: Object, default: () => {}, }, }, }; </script> <style scoped> #helpedInfo { color: #42a5f5; } #tooltip-content { font-size: 14px; font-weight: bold; } #template-content { display: inline-flex; } </style>

<template> <div> <i :class="iconClass"/>{{ data.text }} </div> </template> <script> export default { props: { data: { type: Object, default: () => {}, }, icon: { type: String, default: 'info', }, }, data() { return { iconClass: `dx-icon dx-icon-${this.icon}`, }; }, }; </script>

import { createApp } from 'vue'; import App from './App.vue'; createApp(App).mount('#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/23.1.5/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" /> <script src="https://unpkg.com/core-js@2.6.12/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>