Please use alternative libraries (there are plenty out there) as I do not have the time nor desire to continue maintaining this repo.
Search Select is a simple Angular directive for turning pesky dropdowns into something much more user friendly. More specifically, it adds a search bar right into the input, allowing your users to narrow down a dropdown list by typing in key words or letters.
Examples can be found here.
- ngModel - An object variable for storing the selected option.
- options - An array containing all of the selectable option objects.
- idKey (default: 'id') - A string with the attribute to id the option objects by. Use an attribute that has unique values between options unless you want to have a bad time.
- labelKeys - A string with the name of the attributes on the option object to be used as a display name. You can specify multiple keys (space-separate them) if you want them concatenated as one display name.
- placeholderText - A string with the placeholder text for the search select input.
- fontAwesomeIcon (optional) - A string with the class name of the font-awesome icon to be displayed on the right side of the search select input.
- ngChange (optional) - An expression to be evaluated when the user selects an option.
- disabled (optional) - A boolean expression which represents whether the searchselect is disabled or not.
- required (optional) - A boolean expression which represents whether the searchselect is required or not (for form validity).
SearchSelect is available through Bower. Simply run the following command from your terminal:
$ bower install --save search-select
- Examples can be found here.
- You can scroll through the options with a mouse or via the arrow keys.
- Select an option by clicking or hitting enter/ Close out of the dropdown by clicking away or hitting escape.
- Narrow down the option list by typing into the input.
- angular 1.6.0
- angular-animate 1.6.0, if you want animation when you make your first selection.
- angular-sanitize 1.6.0
Done for now. Open to any requests or concerns.