skyler-cs / ngx-select-dropdown

Custom Dropdown for Angular 4+ with multiple and single selection options

ngx-select-dropdown

ngx-select-dropdown Custom Dropdown component for Angular 4+ with multiple and single selection options

Features

• single select dropdown
• multi select dropdown
• search dropdown list
• arrows keys support
• limit number of items displayed in dropdown
• custom sort

Examples

• demo-page

Installation

• npm install ngx-select-dropdown

Using with webpack and tsc builds/ angular-cli builds

• import SelectDropDownModule into your app.module;

import { SelectDropDownModule } from 'ngx-select-dropdown'

• add SelectDropDownModule to the imports of your NgModule:

@NgModule({
  imports: [
    ...,
    SelectDropDownModule
  ],
  ...
})
class YourModule { ... }

• include css styles in you angular-cli.json.

 "styles": [
        "../node_modules/ngx-select-dropdown/dist/assets/style.css"
      ],

• use <ngx-select-dropdown></ngx-select-dropdown> in your templates to add the custom dropdown in your view like below

<ngx-select-dropdown (change)="selectionChanged($event)" [multiple]="true" [(value)]="dataModel" [config]="config" [options]="dropdownOptions"></ngx-select-dropdown>

Config

Input

• multiple: boolean - true/false beased if multiple selection required or not Defaults to false.
• options: Array - Array of string/objects that are to be the dropdown options.
• value: any - the model variable in which you want to save the selected options.
• config: Object - configuration object.

config = {
        displayKey:"description", //if objects array passed which key to be displayed defaults to description
        search:true //true/false for the search functionlity defaults to false,
        height: 'auto' //height of the list so that if there are more no of items it can show a scroll defaults to auto. With auto height scroll will never appear
        placeholder:'Select' // text to be displayed when no item is selected defaults to Select,
        customComparator: ()=>{} // a custom function using which user wants to sort the items. default is undefined and Array.sort() will be used in that case,
        limitTo: options.length // a number thats limits the no of options displayed in the UI similar to angular's limitTo pipe
      }

Output

• value: any - array of selected options
• change: Event - change event when user changes the selected options

Changelog

• v0.1.0

 Added a change event so that user can attach a change event handler.
 If multiselect the selected text will display first item and + count for eg. (Option 1 + 2 more) .

• v0.2.0

 Angular 4 and above support.
 Bug with search functionality fixed.

• v0.3.0

 Support for Observable data source for options and async pipe.
 IE bug with styling.
 Few other minor bug fixes.

• v0.4.0

 Use arrows keys and enter to select items from available options.
 Case insensitive search.
 Few other minor bug fixes.

• v0.5.0

 Support for scroll bar with too many list items.
 Few other minor bug fixes.

• v0.7.0

 Support for limito pipe to limit number of options displayed in case of too many options.
 Support for customComparator / custom sort function
 Few other minor bug fixes.

Help Improve

Found a bug or an issue with this? Open a new issue here on GitHub.

Contributing to this project

Anyone and everyone is welcome to contribute. Please take a moment to review the guidelines for contributing.

• Bug reports
• Feature requests
• Pull requests