ng-select2-component

Select2

This Angular CLI module it's a fork of select2-component without Vue & React. For Vue or React, please use the original component.

Installation

npm i ng-select2-component --save

Requirements

• Angular 7.0.0 and more

Demo

See a demo.

Features

• select one
• options or groups
• scroll
• local search
• select by keyboard
• disabled option
• disabled component
• hide search box
• placeholder
• multiple selection
• material style
• form binding

Usage

example

import { Select2Module } from "ng-select2-component";

@NgModule({
    imports: [BrowserModule, FormsModule, Select2Module],
    declarations: [MainComponent],
    bootstrap: [MainComponent],
})
class MainModule { }

<select2 [data]="data"
    [value]="value"
    (update)="update($event)">
</select2>

properties and events of the component

name	type	status	default	description
data	Select2Data	required		the data of the select2
value	Select2Value			initial value
disabled	boolean			whether the component is disabled
minCountForSearch	number		6	hide search box if options.length < minCountForSearch
displaySearchStatus	'default' or 'hidden' or 'always'		'default'	display the search box (default : is based on minCountForSearch)
placeholder	string			the placeholder string if nothing selected
customSearchEnabled	boolean			will trigger search event, and disable inside filter
multiple	boolean			select multiple options
hideSelectedItems	boolean			for multiple, remove selected values
resultMaxHeight	string			change the height size of results
material	"" or true			enable material style
editPattern	(str: string) => string			use it for change the pattern of the filter search
ngModel/id/required/ disabled/readonly/tabIndex				just like a select control
(update)	(value: Select2UpdateValue) => void	event		triggered when user select an option
(open)	() => void	event		triggered when user open the options
(search)	(text: string) => void	event		triggered when search text changed

select2 data structure

type Select2Data = (Select2Group | Select2Option)[];

interface Select2Group = {
    label: string;
    options: Select2Option[];
    classes?: string;
};

interface Select2Option = {
    value: Select2Value;
    label: string;
    disabled?: boolean;
    component?: string | Function; // the component
    classes?: string;
};

type Select2Value = string | number | boolean;

type Select2UpdateValue = Select2Value | Select2Value[];

Publishing the library

npm run build:lib
cd dist/ng-select2-component
npm publish

Update Demo

npm run build:demo

License

Like Angular, this module is released under the permissive MIT license. Your contributions are always welcome.

Changelog

V7.0.7 (2020-04-17)

Changes

• add a new displaySearchStatus attribute
• edit minCountForSearch to make it dynamic and easier to use