# Blazor ChipList Overview

The <a href="https://www.telerik.com/blazor-ui/chiplist" target="_blank">Blazor ChipList component</a> shows pieces of information in a compact form. The individual chips can be [selected](https://www.telerik.com/blazor-ui/documentation/components/chiplist/selection), removed, or disabled. You can respond to various user interactions through the exposed [events](https://www.telerik.com/blazor-ui/documentation/components/chiplist/events), customize the [appearance](https://www.telerik.com/blazor-ui/documentation/components/chiplist/appearance) of the chips, or define custom content for the chip with the [ItemTemplate](https://www.telerik.com/blazor-ui/documentation/components/chiplist/templates).

## Creating Blazor ChipList

1. Add the `TelerikChipList` tag
2. Set the `Data` parameter to a collection of models that will be rendered as chips.
3. Set the `TextField` parameter to point to the corresponding name in the model that holds the text that will be rendered in the individual chip. Read the [Data Binding article](https://www.telerik.com/blazor-ui/documentation/components/chiplist/data-bind) for more information on other binding options.

> caption Basic ChipList for Blazor

<demo metaUrl="client/chiplist/overview/" height="250"></demo>

## Data Binding

The Blazor ChipList requires a data source so that it can display items to the user. To provide a data source, use the `Data` property. Some properties of the ChipList model can enhance the behavior and appearance of each chip. [Read more about the Blazor ChipList data binding](https://www.telerik.com/blazor-ui/documentation/components/chiplist/data-bind).

## Selection

The Blazor ChipList supports single and multiple selection of chips. [Read more about the Blazor ChipList selection...](https://www.telerik.com/blazor-ui/documentation/components/chiplist/selection)

## Templates

You can use the functionality of the built-in templates and customize the default rendering of the component. [Read more about the Blazor ChipList templates...](https://www.telerik.com/blazor-ui/documentation/components/chiplist/templates)

## Events

You can use the built-in events of the Blazor ChipList to react to chip selection and removal. [Read more about the Blazor ChipList events...](https://www.telerik.com/blazor-ui/documentation/components/chiplist/events)

## Appearance

You can customize the [appearance of the Blazor ChipList](https://www.telerik.com/blazor-ui/documentation/components/chiplist/appearance) via a variety of built-in customization options. Also see how to set [`ThemeColor`](https://www.telerik.com/blazor-ui/documentation/components/chip/appearance#themecolor) and [`FillMode`](https://www.telerik.com/blazor-ui/documentation/components/chip/appearance#fillmode) separately for each [chip in the ChipList](https://www.telerik.com/blazor-ui/documentation/components/chiplist/data-bind).

## ChipList Parameters

The table below lists the ChipList parameters. Also check the [ChipList API Reference](https://www.telerik.com/blazor-ui/documentation/api/telerik.blazor.components.telerikchiplist-1) for all parameters, methods and events.

<style>
    .article table {
        table-layout: auto;
        word-break: normal;
    }
</style>

| Parameter           | Type and Default Value | Description                                                                                                                                                                                                                       |
| ------------------- | ---------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `AriaLabel`         | `string`               | Maps to the `aria-label` attribute. Use  this parameter if the text that labels the component is not visible.                                                                                                                     |
| `AriaLabelledBy`    | `string`               | Maps to the `area-labelledby` attribute. Use this parameter to reference another element to define its accessible name.                                                                                                           |
| `Class`             | `string`               | An additional CSS class for the `<div class="k-chip-list">` element. Use it to [customize the component styles and override the theme](https://www.telerik.com/blazor-ui/documentation/styling-and-themes/override-theme-styles). |
| `Data`              | `IEnumerable<TItem>`   | The collection of the items that will be rendered as chips.                                                                                                                                                                       |
| `Removable`         | `bool`                 | Specifies if the chips can be removed by the user. If set to `true` a remove icon will be rendered on each available chip.                                                                                                        |
| `RemoveIcon`        | `object`               | Defines the icon that will be rendered if the `Removable` parameter is set to `true`.                                                                                                                                             |
| `RemoveIconVariant` | `string`               | Selects the [SVG icon variant](https://www.telerik.com/blazor-ui/documentation/common-features/icons#use-svg-icon-variants) of the remove icon.                                                                                   |

## Next Steps

* [Binding the ChipList to Data](https://www.telerik.com/blazor-ui/documentation/components/chiplist/data-bind)
* [Handle the ChipList events](https://www.telerik.com/blazor-ui/documentation/components/chiplist/events)
* [Handle Chip Selection](https://www.telerik.com/blazor-ui/documentation/components/chiplist/selection)

## See Also

* [Live Demo: ChipList Overview](https://demos.telerik.com/blazor-ui/chiplist/overview)
* [ChipList API Reference](https://www.telerik.com/blazor-ui/documentation/api/telerik.blazor.components.telerikchiplist-1)
