Like what you see here? Hire me! 👨💻
https://mattlewis92.github.io/angular-calendar/
A calendar component for Angular 5.0+ that can display events on a month, week or day view. The successor of angular-bootstrap-calendar.
First install through npm:
npm install --save angular-calendar
Next include the CSS file somewhere into your app:
node_modules/angular-calendar/css/angular-calendar.css
Finally import the calendar module into your apps module:
import { NgModule } from '@angular/core';
import { BrowserAnimationsModule } from '@angular/platform-browser/animations';
import { CalendarModule } from 'angular-calendar';
@NgModule({
imports: [
BrowserAnimationsModule,
CalendarModule.forRoot()
]
})
export class MyModule {}
In order to allow the most flexibility for all users there is a substantial amount of boilerplate required to get up and running. Please see the demos list for a series of comprehensive examples of how to use this library within your application.
Once you are up and running, to access a full list of options for each component, the individual APIs are documented here: mwl-calendar-month-view
, mwl-calendar-week-view
and mwl-calendar-day-view
.
You can find quick start examples for all common module bundlers in the build-tool-examples folder.
To see all available API options, take a look at the auto generated documentation. You may find it helpful to view the examples on the demo page.
Where possible this library will strictly adhere to semver and only introduce API breaking changes in 0.x releases or new major versions post 1.0. The only exception to this is if you are using custom templates or extending the base components to add additional functionality, whereby critical bug fixes may introduce breakages as the internal API changes.
Yes.
The last version of this library that supports 2.x is 0.9.1
. However the upgrade from angular 2.x to 4.x is just a matter of changing the dependencies in your package.json and adding the angular/animations
module
The last version of this library that supports 4.x is 0.22.3
.
See the examples list.
No component styles are included with each component to make it easier to override them (otherwise you’d have to use !important
on every rule that you customised). Thus you need to import the CSS file separately from node_modules/angular-calendar/css/angular-calendar.css
.
When building the calendar some parts were found to be reusable so they were split out into their own modules. Only the bare minimum that is required is included with the calendar, there is no extra code than if there were no dependencies. date-fns
especially only imports directly the functions it needs and not the entire library.
Build your own component to replace that view, and use it in place of the one this library provides. It’s impossible to provide a calendar component that meets everyones use cases, hopefully though at least some of the day / week / month view components provided can be customised with the calendars API enough to be of some use to most projects.
As there are so many events to show on each month, it doesn’t provide a lot of value and is just an extra burden to maintain. There is nothing to stop someone from building a new lib like angular-calendar-year-view
though ;)
This library is not optimised for mobile. Due to the complex nature of a calendar component, it is non trivial to build a calendar that has a great UX on both desktop and mobile. It is recommended to build your own calendar component for mobile that has a dedicated UX. You may be able to get some degree of mobile support by setting some custom CSS rules for smaller screens and including hammerjs but your mileage may vary.
All parts of this calendar can be customised via the use of an ng-template
. The recipe for applying one is as follows:
- Find the template you would like to customise for the month, week or day view component. You can find all available custom templates by reading the documentation for each component. For this example we will pick the
cellTemplate
from the month view. - Next find the corresponding child component that will render the template by viewing the source. For our example of the month view cell it is this component
- Now copy the template source for your chosen template into your own component and modify as your see fit.
- Finally pass the template to the components input:
<mwl-calendar-month-view [cellTemplate]="cellTemplateId" />
- You can see an e2e working example of this here
All browsers supported by angular, apart from IE9 as it doesn't support flexbox.
https://github.com/mattlewis92/angular-bootstrap-calendar
- Install Node.js and NPM (should come with)
- Install local dev dependencies:
npm install
while current directory is this repo
Run npm start
to start a development server on port 8000 with auto reload + tests.
Run npm test
to run tests once or npm run test:watch
to continually run tests.
- Bump the version in package.json (once the module hits 1.0 this will become automatic)
npm run release
MIT