@devlukaszmichalak/mat-select-filter
TypeScript icon, indicating that this package has built-in type declarations

18.0.0 • Public • Published

IMPORTANT

This is a fork that will bring the library up to the latest angular version.

The versioning of this fork follows the angular versions, so for example, for any angular 13.x.x project use library version 13.x.x

https://github.com/devLukaszMichalak/mat-select-filter

mat-select-filter

Original Github

https://github.com/mdlivingston/mat-select-filter

Description

The mat-select-filter is a filterer for the material select drop-downs. They currently do not support this, so I decided to make my own.

Demo

https://stackblitz.com/edit/mat-select-filter

Install

npm

$ npm install @devlukaszmichalak/mat-select-filter

How to set up

NgModule

In module based app import the MatSelectFilterModule

import { MatSelectFilterModule } from '@devlukaszmichalak/mat-select-filter';

@NgModule({
  ...
  imports: [
    ...
    MatSelectFilterModule
  ],
  ...
})
export class AppModule {
}

Standalone (since library version 17.1.0)

In standalone components import the MatSelectFilterComponent in the imports array

import { MatSelectFilterComponent } from '@devlukaszmichalak/mat-select-filter';


@Component({
  ...
  standalone: true,
  imports: [
    ...
    MatSelectFilterComponent,
    ...
  ],
  ...
})
export class Component {

How to use

Add component to the desired material select:

<mat-form-field>
    <mat-select>
        <mat-select-filter [array]="variables" (filteredReturn)="filteredVariables = $event"></mat-select-filter>
        <mat-option *ngFor="let variable of filteredVariables">
            {{variable}}
        </mat-option>
    </mat-select>
</mat-form-field>

Send your desired filtered array using the [array]="variables" or [array]="['one', 'two', 'three']". It now accepts an array objects thanks to Sen Alexandru. To use an array of objects, specify the objects key value you want to filter using the [displayMember] input. For example:

var variables = [
  {
    id: 0,
    name: 'test1'
  },
  {
    id: 0,
    name: 'test1'
  }
]
<mat-form-field>
    <mat-select>
        <mat-select-filter [array]="variables" [displayMember]="'name'" (filteredReturn)="filteredVariables = $event"></mat-select-filter>
        <mat-option *ngFor="let variable of filteredVariables">
            {{variable}}
        </mat-option>
    </mat-select>
</mat-form-field>

mat-select-filter now supports option group support thanks to jenniferarce! Just input the [hasGroup] boolean to true and add you [groupArrayName] string!

The (filteredReturn) method returns the filtered results after every keyboard action while searching...

The [noResultsMessage] is the string you would like to display when you filter no results.

The [showSpinner] allows you to turn off whether you would like to show a loading spinner while filtering.

The [filterDebounceTime] allows you to set the debounceTime value on a filter input. Default is 0.

The placeholder text for the search box is accessed by [placeholder]. Default is 'Search...';

<mat-select-filter [placeholder]="'Search..'" [array]="variables" (filteredReturn)="filteredVariables = $event"></mat-select-filter>

To focus the search input on every click, you can do something like this:

<mat-form-field>
    <mat-select #select [value]="selectedVariableName" placeholder="{{ placeholder }}">
        <mat-select-filter *ngIf="select.focused" [array]="variables" (filteredReturn)="filteredVariables = $event"></mat-select-filter>
        <mat-option *ngFor="let variable of filteredVariables">
            {{variable}}
        </mat-option>
    </mat-select>
</mat-form-field>

otherwise, it will only focus once.

To add a colored background, do something like this:

 <mat-select-filter [color]="'purple'" [array]="variables" (filteredReturn)="filteredVariables = $event"></mat-select-filter>

You can also change the classes from a global css/scss file in your project by adding:

.mat-filter {
  background-color: purple !important;
}

.mat-filter-input {
  border: 1px solid black !important
}

Options

  • [array]
  • [color]
  • [placeholder]
  • [displayMember]
  • [noResultsMessage]
  • [showSpinner]
  • [hasGroup]
  • [groupArrayName]
  • [showSpinner]
  • [filterDebounceTime]
  • (filteredReturn)

Hope you enjoy!

Package Sidebar

Install

npm i @devlukaszmichalak/mat-select-filter

Weekly Downloads

261

Version

18.0.0

License

MIT

Unpacked Size

58.5 kB

Total Files

12

Last publish

Collaborators

  • devlukaszmichalak