DevExtreme jQuery - Customize Item Appearance

For a minor customization of tabs, you can use the default item template. This template defines the appearance of a tab depending on whether specific fields are present or absent from the tab's data object. For example, the following code generates three tabs: the first has an icon, the second has a badge, the third is disabled.

JavaScript
$(function() {
    $("#tabsContainer").dxTabs({
        items: [
            { text: "User", icon: 'user' },
            { text: "Comment", badge: "New" },
            { text: "Find", disabled: true }
        ]
    });
});

Using the default item template is the easiest way to customize a tab, but it lacks flexibility. Instead, you can define a custom template. For AngularJS and Knockout apps, DevExtreme provides a markup component called dxTemplate. The following code gives a simple example of how you can use dxTemplate to customize tabs.

AngularJS
HTML
JavaScript
<div ng-controller="DemoController">
    <div dx-tabs="{
        items: tabItems,
        itemTemplate: 'tab'
    }" dx-item-alias="itemObj">
        <div data-options="dxTemplate: { name: 'tab' } ">
            <p style="color:#6600cc;">{{ itemObj.text }}</p>
        </div>
    </div>
</div>
angular.module('DemoApp', ['dx'])
    .controller('DemoController', function ($scope) {
        $scope.tabItems = [
            { text: 'User' },
            { text: 'Comment' },
            { text: 'Find' },
            // . . .
        ];
    });
NOTE
The dx-item-alias directive specifies the variable that is used to access the item object.
Knockout
HTML
JavaScript
<div data-bind="dxTabs: {
    items: tabItems,
    itemTemplate: 'tab'
}">
    <div data-options="dxTemplate: { name: 'tab' } ">
        <p data-bind="text: text" style="color:#6600cc;"></p>
    </div>
</div>
var viewModel = {
    tabItems: [
        { text: 'User' },
        { text: 'Comment' },
        { text: 'Find' },
        // . . .
    ]
};

ko.applyBindings(viewModel);

If you use jQuery alone, combine the HTML markup for tabs manually with jQuery DOM manipulation methods. To apply this markup, use the itemTemplate callback function.

JavaScript
$(function() {
    $("#tabsContainer").dxTabs({
        items: [
            { text: "User" },
            { text: "Comment" },
            { text: "Find" }
        ],
        itemTemplate: function (itemData, itemIndex, itemElement) {
            itemElement.append("<p>" + itemData.text + "</p>");
        }
    });
});

You can also customize an individual tab. For this purpose, declare a template for this tab as a script and pass its id to the template option.

HTML
JavaScript
<script id="individualTabTemplate" type="text/html">
    <!-- ... -->
</script>
var tabs = [{
    title: "Contacts",
    text: 'This is Contacts Tab',
    template: $("#individualTabTemplate")
},
// ...
];

In addition, you can use a 3rd-party template engine to customize widget appearance. For more information, see the 3rd-Party Template Engines article.

See Also