devextreme-vue

DevExtreme Vue UI and Visualization Components

This project allows you to use DevExtreme Widgets as Vue Components.

• Getting started
  • Prerequisites
  • Install DevExtreme
  • Use DevExtreme Components
  • API Reference
• Component Configuration
  • Set Component Option
  • Two-way Binding
  • Editors Value Binding
  • Custom templates
  • Components with Transcluded Content
  • Event Handling
• Type Checks
• DevExtreme Data Layer and Utils
• License
• Support & feedback

Getting Started

Prerequisites

Node.js and npm are required

Install DevExtreme

Install the devextreme and devextreme-vue npm packages:

npm install --save devextreme@18.1-unstable devextreme-vue

Import DevExtreme Modules and Themes

Import DevExtreme modules in a DevExtreme component's file.

import { DxButton } from 'devextreme-vue';

DevExtreme themes can be imported only once in your application's main file:

import 'devextreme/dist/css/dx.common.css';
import 'devextreme/dist/css/dx.light.compact.css';

See the Predefined Themes guide for more information on DevExtreme themes.

Use DevExtreme Components

You can use DevExtreme components in a single file component

<template>
    <dx-button :text='text'/>
</template>

<script>
import { DxButton } from 'devextreme-vue';
export default {
  name: 'HelloWorld',
  data() {
    return {
      text: 'Hello!'
    };
  },
  components: {
    DxButton
  }
};
</script>

... in a jsx render function

import Vue from 'vue';
import { DxButton } from 'devextreme-vue';


new Vue({
  el: '#app',
  data: function() {
    return {
      text: "Hello!"
    }
  },
  render: function(h) {
    return (
      <DxButton text={this.text} />
    )
  }
});

... or directly in a vue template

new Vue({
  el: '#app',
  components: { DxButton },
  template: '<dx-button :text="text" />',
  data() {
    return {
      text: 'Hello!'
    };
  }
});

API Reference

DevExtreme Vue components mirror DevExtreme JavaScript API but use Vue syntax for specifying widget options, subscribing to events and custom template declaration.

Component Configuration

Set Component Option

• A constant string value (for example, the Button text):

<dx-button text="Simple button" />

• A constant non-string value (for example, the CheckBox value):

<dx-check-box :value="true" />

• A value from a component data:

<dx-button :text="text" />

where : is a shorthand for v-bind directive.

Two-way Binding

Use the sync modifier to bind a bindingProperty to a widget option:

<dx-text-box :value.sync="bindingProperty" />

Editors Value Binding

The DevExtreme Vue editors also support v-model directive that creates two-way binding on the editor's value (for example, TextBox value):

<dx-text-box v-model="text" />

Custom templates

You can customize widget elements' appearance via the corresponding template properties.

To specify a DevExtreme Vue Component template, use a named slot to specify a template markup. You also should specify a slot scope to access the template element data.

For instance, you can specify the itemTemplate:

<div id="app">
    <dx-list :items="items">
        <template slot="item" slot-scope="data">
            <i>This is my template for {{data}}</i>
        </template>
    </dx-list>
</div>

import Vue from 'vue';
import { DxList } from 'devextreme-vue';

new Vue({
  el: '#app',
  components: { DxList },
  data() {
    return {
      items: [1, 2, 3, 4]
    };
  }
});

item is the default template name of the dxList widget's itemTemplate option. You can specify a custom name for the itemTemplate option and for your slot:

<div id="app">
    <dx-list :items="items" itemTemplate="my-template">
        <template slot="my-template" slot-scope="data">
            <i>This is my template for {{data}}</i>
        </template>
    </dx-list>
</div>

Note that in a single file component, you cannot use the <template> tag for a slot element (currently not allowed in Vue). Use <div> instead:

<template>
    <dx-list :items="items">
        <div slot="item" slot-scope="data">
            <i>This is my template for {{data}}</i>
        </div>
    </dx-list>
</template>

Components with Transcluded Content

In addition to using templates, you can put the following widgets' content directly into the markup: Resizable, ScrollView, ValidationGroup. For instance, you can specify the ScrollView widget's content as follows:

<dx-scroll-view>
    <div>Some scrollable content</div>
</dx-scroll-view>

Event Handling

You can subscribe to DevExtreme Component Events using the Vue's v-on directive (or @ shorthand)

<dx-text-box v-model="text" @focusIn="handleFocusIn'" />

data: function() {
  return {
    text: "text",
    handleFocusIn: () => {
      this.text = 'focused!';
    }
  };
}

You can find the full list of component events in each DevExtreme widget API Reference's Events section (for example, TextBox events).

Type Checks

DevExtreme Vue components provide Prop Validation and Type Checks, which means that you should specify proper values for the components' properties. Otherwise, Vue produces a console warning (if you are using the development build).

DevExtreme Data Layer and Utils

The DevExtreme includes a Data Layer and Utils that can be helpful in different scenarios.

License

DevExtreme Vue components are released as an MIT-licensed (free and open-source) add-on to DevExtreme.

Familiarize yourself with the DevExtreme License.

A free trial is available!

Support & Feedback

• Check the Vue Guide for general Vue questions
• For questions regarding DevExtreme libraries and widgets' APIs, use the DevExpress Support Center