JavaScript/jQuery ButtonGroup - items
Type:
The items array can contain:
- Objects with fields described in this section
- Objects with any other fields. In this case, specify the buttonTemplate.
If you need to update the UI component items, reassign the entire items[] array as shown in the following example:
JavaScript
buttonGroupInstance.option('items', newItems);
See Also
elementAttr
Specifies the global attributes to be attached to the button group item's container element.
Type:
jQuery
$(function(){ $("#buttonGroup").dxButtonGroup({ items: [{ // ... elementAttr: { class: "class-name" } }, // ... ] }); });
Angular
app.component.html
app.component.ts
app.module.ts
<dx-button-group ... [items]="buttonGroupItems> </dx-button-group>
import { Component } from '@angular/core'; @Component({ selector: 'app-root', templateUrl: './app.component.html', styleUrls: ['./app.component.css'] }) export class AppComponent { buttonGroupItems = [{ // ... elementAttr: { class: "class-name" } }, // ... ] }
import { BrowserModule } from '@angular/platform-browser'; import { NgModule } from '@angular/core'; import { AppComponent } from './app.component'; import { DxButtonGroupModule } from 'devextreme-angular'; @NgModule({ declarations: [ AppComponent ], imports: [ BrowserModule, DxButtonGroupModule ], providers: [ ], bootstrap: [AppComponent] }) export class AppModule { }
Vue
App.vue
<template> <DxButtonGroup ... :items="buttonGroupItems" /> </template> <script> import DxButtonGroup from 'devextreme-vue/button-group'; const buttonGroupItems = [{ // ... elementAttr: { class: "class-name" } }, // ... ]; export default { components: { DxButtonGroup, }, data() { return { buttonGroupItems } } } </script>
React
App.js
import React from 'react'; import 'devextreme/dist/css/dx.light.css'; import ButtonGroup from 'devextreme-react/button-group'; const buttonGroupItems = [{ // ... elementAttr: { class: "class-name" } }, // ... ]; export default function App() { return ( <ButtonGroup ... items={buttonGroupItems} /> ); }
icon
Type:
This property accepts one of the following:
- The icon's URL
- The icon's name if the icon is from the DevExtreme icon library
- The icon's CSS class if the icon is from an external icon library (see External Icon Libraries)
- The icon in the Base64 format
- The icon in the SVG format. Ensure that the source is reliable.
template
Type:
The following types of the specified value are available.
- Assign a string containing the name of the required template.
- Assign a jQuery object of the template's container.
- Assign a DOM Node of the template's container.
- Assign a function that returns the jQuery object or a DOM Node of the template's container.
The following example adds a custom item to the component. Note that Angular and Vue use custom templates instead of the template property. In React, specify the render property.
jQuery
index.js
$(function() { $("#buttonGroupContainer").dxButtonGroup({ // ... items: [ { // ... template: '<div>Custom Item</div>' } ] }); });
Angular
app.component.html
app.component.ts
app.module.ts
<dx-button-group ... > <dxi-item ... > <div *dxTemplate> <div>Custom Item</div> </div> </dxi-item> </dx-button-group>
import { Component } from '@angular/core'; @Component({ selector: 'app-root', templateUrl: './app.component.html', styleUrls: ['./app.component.css'] }) export class AppComponent { // ... }
import { BrowserModule } from '@angular/platform-browser'; import { NgModule } from '@angular/core'; import { AppComponent } from './app.component'; import { DxButtonGroupModule } from 'devextreme-angular'; @NgModule({ declarations: [ AppComponent ], imports: [ BrowserModule, DxButtonGroupModule ], providers: [ ], bootstrap: [AppComponent] }) export class AppModule { }
Vue
App.vue
<template> <DxButtonGroup ... > <dxItem ... > <div>Custom Item</div> </dxItem> </DxButtonGroup> </template> <script> import DxButtonGroup, { DxItem } from 'devextreme-vue/button-group'; export default { components: { DxButtonGroup, DxItem }, // ... } </script>
React
App.js
import React from 'react'; import ButtonGroup, { Item } from 'devextreme-react/button-group'; const renderCustomItem = () => { return <div>Custom Item</div>; } class App extends React.Component { render() { return ( <ButtonGroup ... > <Item ... render={renderCustomItem} > </Item> </ButtonGroup> ); } } export default App;
See Also
type
Type:
Default Value: 'normal'
Accepted Values: 'back' | 'danger' | 'default' | 'normal' | 'success'
Feedback