React TagBox - Overview

The TagBox UI component is an editor that allows an end user to select multiple items from a drop-down list.

View Demo

The following code adds the TagBox to your page. The simplest configuration of the UI component requires only a dataSource to be specified. In addition, you can specify the placeholder to be displayed when the TagBox is empty.

  • import React from 'react';
  • import 'devextreme/dist/css/dx.common.css';
  • import 'devextreme/dist/css/dx.light.css';
  •  
  • import { TagBox } from 'devextreme-react/tag-box';
  •  
  • const dataSource = [
  • 'HD Video Player',
  • 'SuperHD Video Player',
  • 'SuperPlasma 50',
  • // ...
  • ];
  •  
  • class App extends React.Component {
  • render() {
  • return (
  • <TagBox
  • dataSource={dataSource}
  • placeholder="Select products..."
  • />
  • );
  • }
  • }
  •  
  • export default App;

If your data is an array of objects, specify:

  • valueExpr
    The data field whose value will be written into the value property.
  • displayExpr
    The data field whose value will be displayed in the drop-down list and in the input field of the UI component.
  • import React from 'react';
  • import 'devextreme/dist/css/dx.common.css';
  • import 'devextreme/dist/css/dx.light.css';
  •  
  • import { TagBox } from 'devextreme-react/tag-box';
  •  
  • const tagBoxData = [
  • { id: 1, country: 'Afghanistan' },
  • { id: 2, country: 'Albania' },
  • // ...
  • ];
  •  
  • class App extends React.Component {
  • render() {
  • return (
  • <TagBox
  • dataSource={tagBoxData}
  • valueExpr="id"
  • displayExpr="country"
  • />
  • );
  • }
  • }
  •  
  • export default App;
See Also