MultiSelectComponent

Enables or disables the adaptive mode. By default the adaptive rendering is disabled.

Specifies whether the MultiSelect allows user-defined values that are not present in the dataset (more information and examples). Defaults to false.

The feature is not available when using adaptive mode.

Determines whether to close the options list of the MultiSelect after the item selection is finished (see example).

Specifies whether checkboxes will be rendered before each item in the popup list.

If set to true, renders a button on hovering over the component. Clicking this button resets the value of the component to an empty array and triggers the change event.

Sets the data of the MultiSelect.

The data has to be provided in an array-like list of items.

Sets the disabled state of the component. To learn how to disable the component in reactive forms, refer to the article on Forms Support.

Sets the fillMode of the component.

The possible values are:

• flat
• solid (default)
• outline
• none

Enables the filtering functionality of the MultiSelect.

Sets the HTML attributes of the inner focusable input element. Attributes which are essential for certain component functionalities cannot be changed.

Defines a Boolean function that is executed for each data item in the component (see examples). Determines whether the item will be disabled.

Sets the height of the options list in the popup. By default, listHeight is 200px.

The listHeight property affects only the list of options and not the whole popup container. To set the height of the popup container, use popupSettings.height.

When using adaptiveMode and the screen size is small or medium the listHeight property is set to null.

Sets and gets the loading state of the MultiSelect.

The hint which is displayed when the component is empty. When the values are selected, it disappears.

Configures the popup of the MultiSelect.

The available options are:

• animate: Boolean—Controls the popup animation. By default, the open and close animations are enabled.
• width: Number | String—Sets the width of the popup container. By default, the width of the host element is used. If set to auto, the component automatically adjusts the width of the popup and no item labels are wrapped. The auto mode is not supported when virtual scrolling is enabled.
• height: Number—Sets the height of the popup container.
• popupClass: String—Specifies a list of CSS classes that are used to style the popup.
• appendTo: "root" | "component" | ViewContainerRef—Specifies the component to which the popup will be appended.

Sets the read-only state of the component.

Sets the border radius of the component.

The possible values are:

• small
• medium (default)
• large
• full
• none

Shows or hides the current group sticky header when using grouped data. By default the sticky header is displayed (see example).

Sets the size of the component.

The possible values are:

• small
• medium (default)
• large
• none

Sets the subtitle of the ActionSheet that is rendered instead of the Popup when using small screen devices. By default the ActionSheet subtitle uses the text provided for the placeholder of the AutoComplete.

Specifies the tabindex of the component.

A user-defined callback function which receives an array of selected data items and maps them to an array of tags (see examples).

Sets the data item field that represents the item text. If the data contains only primitive values, do not define it.

The textField property can be set to point to a nested property value - e.g. category.name.

Sets the title of the ActionSheet that is rendered instead of the Popup when using small screen devices. By default the ActionSheet title uses the text provided for the label of the AutoComplete.

Sets the value of the MultiSelect. It can be either of the primitive (string, numbers) or of the complex (objects) type. To define the type, use the valuePrimitive option.

All selected values which are not present in the source are ignored.

Sets the data item field that represents the item value. If the data contains only primitive values, do not define it.

The valueField property can be set to point to a nested property value - e.g. category.id.

A user-defined callback function which returns normalized custom values. Typically used when the data items are different from type string.

Copy Codeimport { map } from 'rxjs/operators';

@Component({
selector: 'my-app',
template: `
  <kendo-multiselect
      [allowCustom]="true"
      [data]="listItems"
      textField="text"
      valueField="value"
      [valueNormalizer]="valueNormalizer"
      (valueChange)="onValueChange($event)"
  >
  </kendo-multiselect>
`
})

class AppComponent {
  public listItems: Array<{ text: string, value: number }> = [
      { text: "Small", value: 1 },
      { text: "Medium", value: 2 },
      { text: "Large", value: 3 }
  ];

  public onValueChange(value) {
      console.log("valueChange : ", value);
  }

  public valueNormalizer = (text$: Observable<string>) => text$.pipe(map((text: string) => {
     return {
        value: Math.floor(Math.random() * (1000 - 100) + 1000), //generate unique valueField
        text: text };
  }));

}

Specifies the type of the selected value. If set to true, the selected value has to be of the primitive type (more information and example).

Enables the virtualization functionality.