ember-fullcalendar brings the power of FullCalendar and FullCalendar Scheduler to Ember.
This addon works in Ember 1.13.9+ or 2.0+ with no deprecations.
To install it run:
ember install ember-fullcalendar
This addon currently supports every option and callback currently available for FullCalendar 3.0 and FullCalendar Scheduler 1.4.0. Please see the FullCalendar documentation for more information.
NOTE: By default, this addon installs and imports both FullCalendar and the FullCalendar Scheduler addon. You may opt out of importing the FullCalendar Scheduler addon if it's not needed.
A simple example:
let events = Ember.A([{
title: 'Event 1',
start: '2016-05-05T07:08:08',
end: '2016-05-05T09:08:08'
}, {
title: 'Event 2',
start: '2016-05-06T07:08:08',
end: '2016-05-07T09:08:08'
}, {
title: 'Event 3',
start: '2016-05-10T07:08:08',
end: '2016-05-10T09:48:08'
}, {
title: 'Event 4',
start: '2016-05-11T07:15:08',
end: '2016-05-11T09:08:08'
}]);
{{full-calendar events=events}}FullCalendar methods can be called like so:
// app/controllers/application.js
import Ember from 'ember';
export default Ember.Controller.extend({
actions: {
nextMonth(){
Ember.$('.full-calendar').fullCalendar('next');
}
}
});Where possible, this addon takes advantage of DDAU (Data Down, Actions Up) to allow your Ember app to interact with FullCalendar from outside of the component. Below are a list of properties that override default FullCalendar properties:
-
viewName(replacesdefaultView) - allows you to change the view mode from outside of the component. For example, when usingheader=false, you can use your own buttons to modify theviewNameproperty to change the view of the calendar. -
viewRange- can be used in conjunction withviewNameto simultaneously navigate to a new date when switching to a new view. See the docs. -
onViewChange- pass an action to be notified when the view changes. This is different than theviewRendercallback provided by FullCalendar as it is only triggered when the view changes and is not when any of the date navigation methods are called. -
date(replacesdefaultDate) - allows you to change the date from outside of the component.
All FullCalendar and FullCalendar Scheduler callbacks are supported and can be handled using Ember Actions. Here's a simple example:
Add the component to your template:
Add some events:
// app/routes/application.js
import Ember from 'ember';
export default Ember.Route.extend({
model: function() {
return {
events: Ember.A([{
title: 'Partayyyy', start: new Date()
}])
};
}
});Register the action in your controller or component:
// app/controllers/application.js
import Ember from 'ember';
export default Ember.Controller.extend({
actions: {
clicked(event, jsEvent, view){
this.showModal(event);
}
}
});By default, FullCalendar Scheduler is NOT imported. To include it, add the following to your application's config/environment.js:
var ENV = {
emberFullCalendar: {
includeScheduler: true
}
// Other options here, as needed.
});By default, only English locale is available. If you need to use other locales, you have to include them in config/environment.js like this:
var ENV = {
emberFullCalendar: {
includeLocales: ['fr', 'it']
}
// Other options here, as needed.
});Or, if you need ALL the locales, you can do the following:
var ENV = {
emberFullCalendar: {
includeLocales: 'all'
}
// Other options here, as needed.
});Then, you can set the fullcalendar language by using the locale option:
This addon now has minimal Fastboot support via #46.
By default, the addon uses the Free Trial License Key provided by FullCalendar. If you have a paid license key, you may set it by explicitly passing it into the component as schedulerLicenseKey or, the better option, is to set it in your config/environment.js file like so:
emberFullCalendar: {
schedulerLicenseKey: '<your license key>'
}