Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/CleverPumpkin/CrispyCalendar
https://github.com/CleverPumpkin/CrispyCalendar
Last synced: 3 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/CleverPumpkin/CrispyCalendar
- Owner: CleverPumpkin
- License: mit
- Created: 2018-04-26T16:10:05.000Z (almost 7 years ago)
- Default Branch: master
- Last Pushed: 2024-03-27T14:27:25.000Z (10 months ago)
- Last Synced: 2024-09-18T21:40:35.167Z (4 months ago)
- Language: Swift
- Size: 955 KB
- Stars: 313
- Watchers: 17
- Forks: 6
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-swift - CrispyCalendar - CrispyCalendar is the calendar UI framework. (UI)
README
Whether you are writing yet another one task tracker or calendar app, or simply want to offer the users to skip the joy of using `UIDatePicker` and let them quickly and efficiently select dates — CrispyCalendar is **the** calendar UI framework you need.
[](https://cocoapods.org/pods/CrispyCalendar)
[](https://cleverpumpkin.github.io/CrispyCalendarDocs/public/)
[](https://github.com/ReSwift/ReSwift/blob/master/LICENSE.md)
## Features
* **Written with localization in mind.**
Specifically, many various (and even nonsensical) combinations of calendar types, locale identifiers
and writing directions were tested. Also, this framework does not contain a single translation error
simply because only standard Apple frameworks (hence, their translations) are being used and none of
third-party code.
* **Ease of integration, customization options and extensibility — you are free to choose any and all of those.**
The framework contains out-of-the-box components for the most common tasks; in many cases a single line of
code allows you to employ rich user interfaces, allowing you to concentrate on business logic implementation.
But at the same time, every such solution is thoroughly equipped with tuning possibilities and is designed
modularly, allowing you to freely reuse and combine basic blocks to suite your specific requests.
* **Optimized for performance.**
Even seasoned devices like iPhone 5 are rendering the calendar at the acceptable frame rate to say the least.
Minor sacrifices had to be made to achieve that, but the overall result is shining nonetheless.
* **Objective C support.**
Whether you are constrained by legacy code or just not ready for Swift in production-grade code yet, using
CrispyCalendar from Objective C is possible. Mostly, Swift-specific features only are missing, but blind
spots here and there are possible.
## Getting Started
* Common usage patterns and various examples of code can be found in [Demo project](CrispyCalendar.xcodeproj).
* [API Reference](https://cleverpumpkin.github.io/CrispyCalendarDocs/public/index.html) contains detailed
descriptions of the vast majority of `public` & `open` types and identifiers.
## Installation
### Cocoapods (preferred)
CocoaPods is a dependency manager for Swift and Objective-C Cocoa projects. It has over 53 thousand libraries and is used in over 3 million apps. More details and installation instructions may be found here: [Using Cocoapods](https://guides.cocoapods.org/using/getting-started.html).
To integrate CrispyCalendar into your Xcode project using CocoaPods, specify it in your Podfile:
```ruby
source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '10.3'
target 'TargetName' do
pod 'CrispyCalendar', '~> 1.0.2'
end
```
Then, run the following command:
```$ pod install```
### Manual
Open [Demo project](CrispyCalendar.xcodeproj) in Xcode and build `CrispyCalendar` framework target.
Then, embed it into your project and add it to `Linked Frameworks and Libraries` section of app target.
## Screenshots
### Appearance customization
All the fonts, colors and other appearance details are customizable via corresponding properties. [CPCCalendarView](https://cleverpumpkin.github.io/CrispyCalendarDocs/public/Classes/CPCCalendarView.html) does also support customization via [UIAppearance](https://developer.apple.com/documentation/uikit/uiappearance) for properties representable in Objective C.
DefaultBasic from Debt ControlInput view from Debt Control
### Simple selection
Prebuilt UI commonly uses [CPCMonthView](https://cleverpumpkin.github.io/CrispyCalendarDocs/public/Classes/CPCMonthView.html) capable of displaying single month. [CPCMultiMonthsView](https://cleverpumpkin.github.io/CrispyCalendarDocs/public/Classes/CPCMultiMonthsView.html) may be used as container for month views allowing shared selection handling and other functionality.
Single day selectionDays range selection
### Ordered & unordered selection
Selection process is fully controlled externally by corresponding view's delegate. Note that delegates for views inside containers are not supported.
Unordered selectionOrdered selection
### Custom draw handlers
[CPCMonthView](https://cleverpumpkin.github.io/CrispyCalendarDocs/public/Classes/CPCMonthView.html) does not comprise any real child views but is logically drawn from title "label" and "grid", consisting of "day cells". Custom day rendering is supported via custom [CPCDayCellRenderer](https://cleverpumpkin.github.io/CrispyCalendarDocs/public/Protocols/CPCDayCellRenderer.html)s.
Custom cell renderer example
### Localization
Locale used by any component cannot be set explicitly, but Calendar's locale is honored. The framework uses `[[[NSBundle mainBundle] preferredLocalizations] firstObject]` as default locale, including setting it for calendars without explicitly set locale.
Non-gregorian calendar rendering
### Other
Available dates limiting, RTL and landscape orientation are fully supported.
Dates limitingColumned mode
RTL layout
## Credits
CrispyCalendar is owned and maintained by the [Cleverpumpkin, Ltd](https://cleverpumpkin.ru).
CrispyCalendar was originally created by [Kirill Bystrov](https://github.com/byss) as a response to lack of quality calendar-rendering libraries. Android couterpart does exist (but neither API nor UX is similar), check it out here: [CrunchyCalendar](https://github.com/CleverPumpkin/CrunchyCalendar).
## License
CrispyCalendar is released under the MIT license. See [LICENSE](./LICENSE) for details.