Your search did not match any results.
Tag Box

Grouped Items

Documentation

The TagBox widget allows you to group items within the drop-down list. This demo illustrates how to enable grouping and how to define a custom template for groups.

Copy to CodeSandBox
Apply
Reset
import React from 'react'; import { TagBox } from 'devextreme-react/tag-box'; import DataSource from 'devextreme/data/data_source'; import Group from './Group.js'; import productsData from './data.js'; class App extends React.Component { constructor() { super(); this.products = new DataSource({ store: productsData, key: 'ID', group: 'Category' }); } render() { return ( <div className={'dx-fieldset'}> <div className={'dx-field'}> <div className={'dx-field-label'}>Grouped items</div> <div className={'dx-field-value'}> <TagBox dataSource={this.products} valueExpr={'ID'} defaultValue={[17, 19]} grouped={true} displayExpr={'Name'} /> </div> </div> <div className={'dx-field'}> <div className={'dx-field-label'}>Grouped items with search enabled</div> <div className={'dx-field-value'}> <TagBox dataSource={this.products} valueExpr={'ID'} defaultValue={[17, 19]} searchEnabled={true} grouped={true} displayExpr={'Name'} /> </div> </div> <div className={'dx-field'}> <div className={'dx-field-label'}>Grouped items with a custom group template</div> <div className={'dx-field-value'}> <TagBox dataSource={this.products} valueExpr={'ID'} defaultValue={[18]} grouped={true} displayExpr={'Name'} groupRender={Group} /> </div> </div> </div> ); } } export default App;
import React from 'react'; export default function Group({ key }) { return ( <div className={'custom-icon'}> <span className={'dx-icon-box icon'}></span>{' '} {key} </div> ); }
import React from 'react'; import ReactDOM from 'react-dom'; import App from './App.js'; ReactDOM.render( <App />, document.getElementById('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/19.1.5/css/dx.common.css" /> <link rel="stylesheet" type="text/css" href="https://cdn3.devexpress.com/jslib/19.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" /> <link rel="stylesheet" type="text/css" href="styles.css" /> <script src="https://unpkg.com/core-js@2.4.1/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>
.custom-icon .icon { font-size: 17px; color: #f05b41; margin-right: 2px; } .dx-field { margin-bottom: 50px; }
export default [{ 'ID': 1, 'Name': 'HD Video Player', 'Category': 'Video Players' }, { 'ID': 2, 'Name': 'SuperHD Player', 'Category': 'Video Players' }, { 'ID': 3, 'Name': 'SuperPlasma 50', 'Category': 'Televisions' }, { 'ID': 4, 'Name': 'SuperLED 50', 'Category': 'Televisions' }, { 'ID': 5, 'Name': 'SuperLED 42', 'Category': 'Televisions' }, { 'ID': 6, 'Name': 'SuperLCD 55', 'Category': 'Televisions' }, { 'ID': 7, 'Name': 'SuperLCD 42', 'Category': 'Televisions' }, { 'ID': 8, 'Name': 'SuperPlasma 65', 'Category': 'Televisions' }, { 'ID': 9, 'Name': 'SuperLCD 70', 'Category': 'Televisions' }, { 'ID': 10, 'Name': 'DesktopLED 21', 'Category': 'Monitors' }, { 'ID': 11, 'Name': 'DesktopLED 19', 'Category': 'Monitors' }, { 'ID': 12, 'Name': 'DesktopLCD 21', 'Category': 'Monitors' }, { 'ID': 13, 'Name': 'DesktopLCD 19', 'Category': 'Monitors' }, { 'ID': 14, 'Name': 'Projector Plus', 'Category': 'Projectors' }, { 'ID': 15, 'Name': 'Projector PlusHD', 'Category': 'Projectors' }, { 'ID': 16, 'Name': 'Projector PlusHT', 'Category': 'Projectors' }, { 'ID': 17, 'Name': 'ExcelRemote IR', 'Category': 'Automation' }, { 'ID': 18, 'Name': 'ExcelRemote BT', 'Category': 'Automation' }, { 'ID': 19, 'Name': 'ExcelRemote IP', 'Category': 'Automation' }];
System.config({ transpiler: 'plugin-babel', paths: { 'npm:': 'https://unpkg.com/' }, defaultExtension: 'js', map: { 'react': 'npm:react@16/umd/react.development.js', 'react-dom': 'npm:react-dom@16/umd/react-dom.development.js', 'prop-types': 'npm:prop-types/prop-types.js', 'devextreme': 'npm:devextreme@19.1', 'devextreme-react': 'npm:devextreme-react@19.1', 'jszip': 'npm:jszip@3.1.3/dist/jszip.min.js', 'quill': 'npm:quill@1.3.6/dist/quill.js', 'devexpress-diagram': 'npm:devexpress-diagram', // SystemJS plugins 'plugin-babel': 'npm:systemjs-plugin-babel@0/plugin-babel.js', 'systemjs-babel-build': 'npm:systemjs-plugin-babel@0/systemjs-babel-browser.js' }, packages: { 'devextreme': { defaultExtension: 'js' }, 'devextreme-react': { main: 'index.js' } }, babelOptions: { sourceMaps: false, stage0: true, react: true } });