Vue Form - In Columns

Fixed and Floating Number of Columns

The Form UI component can have a fixed number of columns in the layout...

App.vue
  • <template>
  • <DxForm
  • :form-data="employee"
  • :col-count="3">
  • <DxSimpleItem data-field="firstName" />
  • <DxSimpleItem data-field="lastName" />
  • <DxSimpleItem data-field="position" />
  • </DxForm>
  • </template>
  •  
  • <script>
  • import 'devextreme/dist/css/dx.light.css';
  •  
  • import { DxForm, DxSimpleItem } from 'devextreme-vue/form';
  •  
  • export default {
  • components: {
  • DxForm,
  • DxSimpleItem
  • },
  • data() {
  • return {
  • employee: {
  • firstName: 'John',
  • lastName: 'Heart',
  • position: 'CEO'
  • }
  • }
  • }
  • }
  • </script>

... or it can vary the number of columns depending on the width of the container. To enable the latter mode, assign "auto" to the colCount property and specify the minimum column width using the minColWidth property. In this case, the maximum number of columns the layout can fit equals to floor(container_width / minColWidth). Note that groups and tabs can also have their own multi-column layouts inside.

App.vue
  • <template>
  • <DxForm
  • :form-data="employee"
  • col-count="auto"
  • :min-col-width="500">
  • <DxSimpleItem dataField="firstName" />
  • <DxSimpleItem dataField="lastName" />
  • <DxTabbedItem>
  • <DxTab
  • title="Info"
  • :col-count="3">
  • <DxSimpleItem dataField="position" />
  • <DxSimpleItem dataField="hireDate" />
  • <DxSimpleItem dataField="city" />
  • </DxTab>
  • <DxTab
  • title="Contacts"
  • :col-count="2">
  • <DxSimpleItem dataField="phone" />
  • <DxSimpleItem dataField="email" />
  • </DxTab>
  • </DxTabbedItem>
  • </DxForm>
  • </template>
  • <script>
  • import 'devextreme/dist/css/dx.light.css';
  •  
  • import { DxForm, DxTabbedItem, DxSimpleItem, DxTab } from 'devextreme-vue/form';
  •  
  • const employee = {
  • firstName: 'John',
  • lastName: 'Heart',
  • position: 'CEO',
  • hireDate: new Date(2012, 4, 13),
  • city: 'Los Angeles',
  • phone: '+1(213) 555-9392',
  • email: 'jheart@dx-email.com'
  • };
  •  
  • export default {
  • components: {
  • DxForm, DxTabbedItem, DxSimpleItem, DxTab
  • },
  • data() {
  • return {
  • employee
  • };
  • },
  • };
  • </script>

Span Columns

If an item should span more than one column, assign the required number to the colSpan property. Groups and tabs can also have individual colSpan values.

App.vue
  • <template>
  • <DxForm
  • :form-data="employee"
  • :col-count="2">
  • <DxSimpleItem data-field="firstName" />
  • <DxSimpleItem data-field="lastName" />
  • <DxSimpleItem data-field="notes" :col-span="2" />
  • <DxTabbedItem :col-span="2">
  • <DxTab title="Contacts">
  • <DxSimpleItem data-field="phone" />
  • <DxSimpleItem data-field="email" />
  • </DxTab>
  • </DxTabbedItem>
  • </DxForm>
  • </template>
  •  
  • <script>
  • import 'devextreme/dist/css/dx.light.css';
  •  
  • import { DxForm, DxSimpleItem, DxTabbedItem, DxTab } from 'devextreme-vue/form';
  •  
  • export default {
  • components: {
  • DxForm, DxSimpleItem, DxTabbedItem, DxTab
  • },
  • data() {
  • return {
  • employee: {
  • firstName: 'John',
  • lastName: 'Heart',
  • notes: 'John has been in the Audio/Video industry since 1990.',
  • phone: '+1(213) 555-9392',
  • email: 'jheart@dx-email.com'
  • }
  • }
  • }
  • }
  • </script>

Layout Depending on the Screen Width

The Form UI component enables you to specify different layouts for different screen widths. For this purpose, use the screenByWidth function and colCountByScreen property. The screenByWidth function returns a size qualifier depending on the screen width. The colCountByScreen property establishes the dependency between the size qualifier and the column count.

App.vue
  • <template>
  • <DxForm
  • :form-data="employee"
  • :col-count-by-screen="colCountByScreen"
  • :screen-by-width="screenByWidth" />
  • </template>
  • <script>
  • import 'devextreme/dist/css/dx.light.css';
  •  
  • import DxForm from 'devextreme-vue/form';
  •  
  • const employee = {
  • firstName: 'John',
  • lastName: 'Heart',
  • position: 'CEO',
  • hireDate: new Date(2012, 4, 13)
  • }
  •  
  • export default {
  • components: {
  • DxForm
  • },
  • data() {
  • return {
  • employee
  • };
  • },
  • computed: {
  • colCountByScreen() {
  • return {
  • xs: 1,
  • sm: 2,
  • md: 3
  • lg: 4
  • };
  • }
  • },
  • methods: {
  • screenByWidth(width) {
  • if (width < 768) return 'xs';
  • if (width < 992) return 'sm';
  • if (width < 1200) return 'md';
  • return 'lg';
  • }
  • }
  • };
  • </script>

View Demo

See Also