# ez-multi-selection-list



<!-- Auto Generated Below -->


## Properties

| Property             | Attribute              | Description                                                                                                                                                                                                                                                               | Type                            | Default     |
| -------------------- | ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------- | ----------- |
| `columnName`         | `column-name`          | Nome da coluna onde serão aplicadas as opções selecionadas.                                                                                                                                                                                                               | `string`                        | `undefined` |
| `dataSource`         | --                     | Classe que implementa o método fetchData, responsável por realizar a pesquisa dos dados, com base no termo informado pelo usuário.                                                                                                                                        | `IMultiSelectionListDataSource` | `undefined` |
| `isTextSearch`       | `is-text-search`       | Informa se a pesquisa é do tipo texto ou numérico.                                                                                                                                                                                                                        | `boolean`                       | `false`     |
| `options`            | --                     | Opções de filtros a serem exibidas na listagem.                                                                                                                                                                                                                           | `IMultiSelectionOption[]`       | `undefined` |
| `orderSelectedFirst` | `order-selected-first` | Define se as opções marcadas devem ser reordenadas para o topo da lista (e ordenadas alfabeticamente/pelo datasource). Quando `false`, a ordem original das opções é preservada — inclusive ao marcar/desmarcar itens. Padrão: `true` (mantém o comportamento histórico). | `boolean`                       | `true`      |
| `useOptions`         | `use-options`          | Indica se deve ser exibida lista de opções do atributo options (true), ou se deve utilizar o datasource (false)                                                                                                                                                           | `boolean`                       | `false`     |


## Events

| Event                   | Description                                                             | Type                                   |
| ----------------------- | ----------------------------------------------------------------------- | -------------------------------------- |
| `changeFilteredOptions` | Evento que informa que a lista de opções selecionadas sofreu alteração. | `CustomEvent<IMultiSelectionOption[]>` |


## Methods

### `clearFilteredOptions() => Promise<void>`



#### Returns

Type: `Promise<void>`

---

### `clearSelection() => Promise<void>`



#### Returns

Type: `Promise<void>`




## Dependencies

### Used by

 - [ez-multi-select-input](../ez-multi-select-input)
 - [filter-column](../ez-grid/subcomponents)

### Depends on

- [ez-check](../ez-check)
- [ez-list](../ez-list)
- [ez-icon](../ez-icon)
- [multi-selection-box-message](subcomponents)
- [ez-filter-input](../ez-filter-input)
- [ez-search](../ez-search)

### Graph
```mermaid
graph TD;
  ez-multi-selection-list --> ez-check
  ez-multi-selection-list --> ez-list
  ez-multi-selection-list --> ez-icon
  ez-multi-selection-list --> multi-selection-box-message
  ez-multi-selection-list --> ez-filter-input
  ez-multi-selection-list --> ez-search
  ez-list --> ez-check
  ez-filter-input --> ez-text-input
  ez-filter-input --> ez-icon
  ez-text-input --> ez-tooltip
  ez-text-input --> ez-icon
  ez-search --> ez-text-input
  ez-search --> ez-icon
  ez-search --> ez-popover-plus
  ez-search --> search-list
  ez-popover-plus --> ez-popover-core
  search-list --> ez-card-item
  ez-multi-select-input --> ez-multi-selection-list
  filter-column --> ez-multi-selection-list
  style ez-multi-selection-list fill:#f9f,stroke:#333,stroke-width:4px
```

----------------------------------------------