cibernox/ember-power-select


The extensible select component built for ember.

http://www.ember-power-select.com

License: MIT

Language: JavaScript

Keywords: component, ember, select


Build Status Ember Observer Score Code Climate npm version dependencies

Ember-Power-Select

Ember Power Select is a select component written in Ember with a focus in flexibility and extensibility.

It is designed to work well with the way we build Ember apps, so it plays nicely with promises, ember-concurrency's tasks, ember-data collections and follows idiomatic patterns.

Installation

Ember Power Select 1.X works in Ember 2.3.1+, beta and canary with no deprecations whatsoever. Any deprecation will be considered a bug.

As any other ember-cli addon, run:

ember install ember-power-select

Ember Power Select 2.X requires Ember 2.10.0+.

Features overview

Ember Power Select wants to be as agnostic as possible about how you're going to use it, but it still provides some default implementations that will match 95% of your needs, and exposes actions to customize the other 5% of usages.

Features include:

  • Single select
  • Multiple select
  • HTML inside the options or the trigger.
  • Filter options sanitizing diacritics.
  • Custom matchers.
  • Asynchonous searches.
  • Theming
  • Fully promise-aware, with loading states.
  • Compatible with ember-concurrency task cancellation.
  • Compatibility with ember-data's ArrayProxies
  • Groups (with not deep limit), placeholders...
  • Clear the selection
  • Disable the component or individual options
  • CSS animations and transitions
  • ... and anything else you want. Just replace parts of the selects with your own components.

Usage

Check the full documentation with live examples at www.ember-power-select.com and please open an issue if something doesn't work or is not clear enough.

Good docs are important :)

Extensions

Ember-power-select's focus on flexibility enables the community to build richer and more tailor made components on top of it, focused in solving one particular problem, using composition.

Check the addons section to see some and if you create one that you want to open source open a PR to include it in the list.

Browser support

This component was just tested it in modern browsers but there is no technical reason it wouldn't work in IE9+. If you find any problem please file an issue.

Testing

In testing it requires phantomjs 2.0+. This component also provides some convenient test helpers to interact with the component in acceptance tests.

Contributing

Any contribution is welcome. Please read our guidelines. However, if your contribution involves adding a new feature, please open an issue before to share your plan and agree the details of the feature before starting implementing it.

Troubleshooting

If something doesn't work visit the Troubleshooting section of the docs first and if your problem persist open an issue, specify the version of the component, Ember and browser.

Project Statistics

Sourcerank 15
Repository Size 5 MB
Stars 504
Forks 283
Watchers 19
Open issues 126
Dependencies 2,437
Contributors 113
Tags 266
Created
Last updated
Last pushed

Top Contributors See all

Miguel Camba Miguel Andrade Alex Alvarez Scott Newcomer Kirill Korolyov Simon Ihmig Edward Faulkner Brian Gantzler Tyler David Pett Nathan Hammond Josemar Luedke Paulo Monteiro Luke Francesco Novy Michał Olejniczak Philipp Haidenbauer Will Raxworthy ssriera James Herdman

Packages Referencing this Repo

ember-power-select
The extensible select component built for ember
Latest release 4.0.0-beta.6 - Updated - 504 stars
eflex-ember-power-select
The extensible select component built for ember
Latest release 2.0.3 - Updated - 504 stars

Recent Tags See all

v3.0.6 December 30, 2019
v4.0.0-beta.6 December 03, 2019
v4.0.0-beta.5 November 30, 2019
v4.0.0-beta.4 November 27, 2019
v3.0.5 November 27, 2019
v4.0.0-beta.3 November 21, 2019
v4.0.0-beta.2 November 19, 2019
v4.0.0-beta.1 November 18, 2019
v3.0.4 August 17, 2019
v3.0.3 August 09, 2019
v3.0.2 July 20, 2019
v3.0.1 July 19, 2019
v3.0.0 July 12, 2019
v2.3.5 July 06, 2019
v3.0.0-beta.4 July 06, 2019

Interesting Forks See all

ef4/ember-power-select
The extensible select component built for ember.
JavaScript - Last pushed - 2 stars

Something wrong with this page? Make a suggestion

Last synced: 2019-04-29 20:54:24 UTC

Login to resync this repository