ember-power-datepicker
v1.0.3
Published
An extensible datepicker for Ember
Downloads
13,221
Readme
Ember Power Datepicker
This addon it's the last member of the Ember Power Project family and it combines ember-basic-dropdown and ember-power-calendar into a single datepicker component that exposes the public APIs of both components as one.
As the components this one is born from, it aims to be flexible and customizable so you can taylor your perfect datepicker. For that it extrictly follows DDAU approach and all its subcomponents can be omitted or replaced by your own.
Compatibility
- Ember.js v3.28 or above
- Ember CLI v3.28 or above
- Node.js v18 or above
Installation
ember install ember-basic-dropdown ember-power-calendar ember-power-datepicker
Setup
If you are using sass, you can import the styles in your app.scss
@import "ember-power-datepicker";
This component doesn't has any style of itself, so the only thing this import is doing is in turn importing the styles of ember-basic-dropdown and ember-power-calendar, so this is just a convenience. If you already use and import the styles of those addons yourself, you don't have to import these.
Usage
The API of the component will remind you the APIs of its both parents. It leverages contextual components and most of the options you can pass to the original components are accepted by this addon.
Let's see a basic example:
<PowerDatepicker @selected={{this.selected}} @onSelect={{this.onSelect}} as |dp|>
<dp.Trigger tabindex="-1">
<input type="text" class="my-input-class" readonly value={{moment-format selected}}>
</dp.Trigger>
<dp.Content class="demo-datepicker-small">
<dp.Nav />
<dp.Days />
</dp.Content>
</PowerDatepicker>
The {{dp.trigger}}
and {{dp.content}}
come from ember-basic-dropdown.
You can learn more about them here: https://www.ember-basic-dropdown.com/docs/how-to-use-it
The {{dp.nav}}
and dp.days
components along with the selected
and onSelect
properties
come from ember-power-calendar.
You can learm more about them it here: http://www.ember-power-calendar.com/docs/action-handling
The selected
and onSelect
are the only mandatory options. You can omit them, but if
you do and you don't allow users to select a date, what do you want a datepicker for?