An Ember and Selectize integration, packaged as an Ember-cli addon.
MIT License
An Ember and Selectize integration, packaged as an Ember-cli addon. Check Selectize and Ember-cli!
Check (old demo): http://miguelcobain.github.io/ember-selectize
ember install ember-cli-selectize
This addon provides an ember-selectize
component.
Its usage should be very similar to Ember.Select
, but with additional features.
{{ember-selectize
content=controller.items
optionValuePath="content.id"
optionLabelPath="content.name"
selection=model.item
placeholder="Select an item" }}
ember-selectize also supports selectize's general options, excluding options
and items
(equivalent to content
and selection
respectively).
Ember is moving towards a paradigm that encourages the use of actions. With this in mind, ember selectize provides a set of actions. The goal is to not use two way data bindings, that is, you pass the data to your components, but the components send actions up to let you (and only you) change the data. Here are the actions the ember selectize supports:
Ember selectize supports both APIs.
More info:
We will folow Ember Select's approach, which is really flexible:
Ember-selectize supports two flavors of option grouping.
#1
optionGroupPathSet optionGroupPath
to a path for a property to group for.
Example:
[
{
id: 1,
category: 'Nature',
title: 'This title will appear on select'
},
{
id: 2,
category: 'Nature',
title: 'This title will appear on select'
},
{
id: 3,
category: 'Another category',
title: 'This title will appear on select'
},
//...
]
optionGroupPath
would be "content.category"
, which would group items according to that property automatically.
like
{{ember-selectize optionGroupPath="content.category"}}
#2
groupedContentIf you prefer you can group your items yourself and pass them to ember selectize.
Just set the property groupedContent
to an array with the following format:
[
{
label: 'Nature',
content: [
{
id: 1,
title: 'This title will appear on select'
},
{
id: 2,
title: 'This title will appear on select'
}
]
},
{
label: 'Another category',
content: [
//...
]
},
//...
]
and in your template
{{ember-selectize groupedContent=someArray}}
You can customize which theme to use in your Brocfile.
//your-app/Brocfile.js
var EmberApp = require('ember-cli/lib/broccoli/ember-app');
var app = new EmberApp({
'ember-cli-selectize': {
//valid values are `default`, `bootstrap2`, `bootstrap3` or false
'theme': 'bootstrap3'
}
});
module.exports = app.toTree();
If you want to use the default theme, you don't need to specify any option.
If you don't want to include any css at all for some reason, simply assign false
or any "falsy" value to the theme
option.
ember server
npm test
(Runs ember try:testall
to test your addon against multiple Ember versions)ember test
ember test --server
ember build
For more information on using ember-cli, visit https://ember-cli.com/.