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 theviewName
property to change the view of the calendar. -
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, the FullCalendar Scheduler addon is imported. To opt out, add the following to your application's ember-cli-build.js
:
var app = new EmberApp(defaults, {
emberFullCalendar: {
scheduler: false
}
// Other options here, as needed.
});
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>'
}
While not required by ember-fullcalendar
, you may find it helpful to be able to import moment via ES6. Install ember-cli-moment-shims
to enable:
import moment from 'moment';