https://github.com/badchoice/rvcalendarweekview
Simple but powerful Calendar Week View for iOS
https://github.com/badchoice/rvcalendarweekview
Last synced: about 1 year ago
JSON representation
Simple but powerful Calendar Week View for iOS
- Host: GitHub
- URL: https://github.com/badchoice/rvcalendarweekview
- Owner: BadChoice
- License: mit
- Created: 2016-08-22T19:24:10.000Z (almost 10 years ago)
- Default Branch: master
- Last Pushed: 2019-05-06T14:22:44.000Z (about 7 years ago)
- Last Synced: 2025-03-23T08:51:12.458Z (over 1 year ago)
- Language: Objective-C
- Size: 3.46 MB
- Stars: 101
- Watchers: 7
- Forks: 24
- Open Issues: 20
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# RVCalendarWeekView
Simple but powerful Calendar Week View for iOS With dragable events, infinte scroll and pinchable hours size
Following the work from [MSCollectionView](https://github.com/erichoracek/MSCollectionViewCalendarLayout)
I created this library simplifing its usage and adding some interesting features
### Installation
`pod 'RVCalendarWeekView'`
or just copy the files inside the `lib` folder by now
### Usage
you can now use storyboard to create a simple UIView extending the MSWeekView and then just do this:
```
-(void)viewDidLoad{
MSEvent* event1 = [MSEvent make:NSDate.now
title:@"Title"
location:@"Central perk"];
MSEvent* event2 = [MSEvent make:[NSDate.now addMinutes:10] //AddMinutes comes from EasyDate pod
duration:60*3
title:@"Title 2"
location:@"Central perk"];
_weekView.events = @[event1,event2];
}
```
Easy right?
### Features
To add features to the WeekView I'm using a decorator pattern, this way we can extend the `weekView` with diferent features without the need of multiple inhertance and to have a expressive modular design
However, this adds the need to have a `strong` reference to the `decorator` that will hold the features.
So we can add features to the `weekView` with the following code:
```
self.decoratedWeekView = [MSWeekViewDecoratorFactory make:self.weekView
features:(MSDragableEventFeature|MSNewEventFeature|MSInfiniteFeature|MSChangeDurationFeature)
andDelegate:self];
```
This is the fast way where the delegate should have all the methods for each feature delegate (see below).
The long way is something more like the standard `decorator` pattern in case you need more flexibility.
```
MSWeekView* decoratedView = baseView;
decoratedView = [MSWeekViewDecoratorInfinite makeWith:decoratedView andDelegate:infiniteDelegate];
decoratedView = [MSWeekViewDecoratorNewEvent makeWith:decoratedView andDelegate:newEventDelegate];
decoratedView = [MSWeekViewDecoratorDragable makeWith:decoratedView andDelegate:dragableDelegate];
decoratedView = [MSWeekViewDecoratorChangeDuration makeWith:decoratedView andDelegate:durationDelegate];
```
There is a function to easily set the minutes precision to all decorators in case you need something diferent than the default 5 minutes.
```
[MSWeekViewDecoratorFactory setMinutesPrecisionToAllDecorators:decoratedView minutesPrecision:15];
```
#### Drag and drop
You can get the feature to change the event duration with `MSDragableEventFeature`
It will fire the following functions on your `dragDelegate`
```
-(BOOL)weekView:(MSWeekView*)weekView canMoveEvent:(MSEvent*)event to:(NSDate*)date;
-(void)weekView:(MSWeekView*)weekView event:(MSEvent*)event moved:(NSDate*)date;
```
#### Change duration
You can get the feature to change the event duration with `MSChangeDurationFeature`
```
-(BOOL)weekView:(MSWeekView*)weekView canChangeDuration:(MSEvent*)event startDate:(NSDate*)startDate endDate:(NSDate*)endDate;
-(void)weekView:(MSWeekView*)weekView event:(MSEvent*)event durationChanged:(NSDate*)startDate endDate:(NSDate*)endDate;
```
#### Create new event on long press
it will fire the following functions on your `createEventDelegate`
```
-(void)weekView:(MSWeekView*)weekView onLongPressAt:(NSDate*)date
```
#### Infinite scroll
It will fire the following functions on your `infiniteDelegate`
```
-(BOOL)weekView:(MSWeekView*)weekView newDaysLoaded:(NSDate*)startDate to:(NSDate*)endDate;
```
#### Unavailable Hours
The standard `weekView` comes with an optional delegate function to display unavailable hours in gray (customizable class of course)
just do something like this:
```
//This one is optional
-(NSArray*)weekView:(id)sender unavailableHoursPeriods:(NSDate*)date{
if(!unavailableHours){
unavailableHours = @[
[MSHourPerdiod make:@"00:00" end:@"09:00"],
[MSHourPerdiod make:@"18:30" end:@"21:00"],
];
}
return unavailableHours;
}
```
#### Pinchable
**This doesn't work really well yet**
You just need to add the `MSPinchableFeature` in the `[MSWeekViewDecoratorFactory make:...]`
#### Options
You can even customize some options (they all have defaults values so you just need to modify them if you want to work differently)
```
_weekView.weekFlowLayout.show24Hours = YES; //Show All hours or just the min to cover all events
_weekView.weekFlowLayout.hourHeight = 50; //Define the hour height
_weekView.daysToShowOnScreen = 7; //How many days visible at the same time
_weekView.daysToShow = 31; //How many days to display (Ininite scroll feature pending)
_weekView.weekFlowLayout.hourGridDivisionValue = MSHourGridDivision_15_Minutes; // Show hour division lines (at lower alpha) each X minutes, by default its NONE so they are not shown.
```
This is a complex example on how you can customize it.
- In this one we are displaying just one day, with each employee as worker.
- Unavailable hours class with pattern image background.
- Custom Event Cell.
- Custom header section view
- Custom header background
### Issues
Feel free to report any issue you find in github issues
#### Masonry pod error
looks like this can solve it in your pods file
```
#To fix the masonry preprocessor definition
post_install do |installer|
installer.pods_project.targets.each do |target|
target.build_configurations.each do |config|
config.build_settings['GCC_PREPROCESSOR_DEFINITIONS'] ||= ['$(inherited)']
config.build_settings['GCC_PREPROCESSOR_DEFINITIONS'] << 'MAS_SHORTHAND=1'
end
end
end
```
### Contributors
· Jordi Puigdellívol - https://github.com/badchoice
· Eric Horacek - https://github.com/erichoracek
· Kyle Fleming - https://github.com/kylefleming