Parchment
adheres to Semantic Versioning.
1.6.0 - 2018-03-03
- Forward appearance methods from EMPageViewController #306
- Fix indicator insets with only one item #307
- Add method for reloading menu #312
1.5.0 - 2018-11-18
- Include vertical insets for indicator view #271
- Remove development team from Parchment target #280
- Update indicator and border views when changing options #245
- Fix issue with width delegate not being called #244
- Fix issue with invalidating collection view layout #240
1.4.1 - 2018-08-15
- Fix issue with reloadData causing a crash #230
1.4.0 - 2018-08-11
- Upgrade to Swift 4.2 #228
- Add option for registering cells from NIB #227
1.3.0 - 2018-05-19
- Add version checks to support Swift >=3.2 #190, #184
- Fix issue with indicator/border class was not registered #191
- Fix issue with reloading data when view controllers did not change #201
1.2.0 - 2018-04-15
- Upgrade to Swift 4.1 #171
- Prevent unnecessary view controller initializations #160
- Fix issues with reloading data #157
- Fix issue with clearing all items in page view controller (a5759ba)
- Fix issue where willScrollToItem delegate was not called #173
- Fix layout bug with cell heights when using width delegate #155
1.1.0 - 2018-03-25
- Add method for reloading data without passing initial item (8ebd931)
- Add option for selected font #143
- Fix issue with reloading data when using PagingViewControllerDataSource (07641e2)
- Fix integer overflow causing crash in UnplashExample #140
1.0.3 - 2018-03-01
- Fix issue where size delegate was not called #135
1.0.2 - 2018-02-22
- Update default background color for menu items #131
1.0.1 - 2018-02-03
- Fix issue with selecting items programatically #125
- Fix wrong color on collection view background #126
- Fix issue with menu items being clipped #127
1.0.0 - 2018-01-29
This release introduces a lot of breaking changes, a bunch of new features and a couple of bug fixes. Here are the most notable changes, with a full list of changes below.
All configuration is now moved into properties on the PagingViewController
class. You no longer have to initialize a PagingViewController
with an instance conforming to the PagingOptions
protocol. This reduces the boilerplate of having to create a separate options struct when you just need to override a single value. It also means you can change the options after the PagingViewController
has been initialized. All the properties on the PagingTheme
protocol has also moved into separate properties on PagingViewController
.
Before:
struct Theme: PagingTheme {
let textColor: UIColor = .red
}
struct Options: PagingOptions {
let theme: PagingTheme = Theme()
let menuItemSize: PagingMenuItemSize = .fixed(width: 100, height: 40)
}
let pagingViewController = PagingViewController(options: Options())
After:
let pagingViewController = PagingViewController()
pagingViewController.menuItemSize = .fixed(width: 100, height: 40)
pagingViewController.textColor = .red
The current data source protocol has been renamed to PagingViewControllerInfiniteDataSource
and moved into the property called infiniteDataSource
.
A new PagingViewControllerDataSource
protocol has been added that makes it easier to set up a custom data source if you have a fixed number of view controllers. To use the new data source, you only need to return the total number of
view controllers as well as the view controller and PagingItem
for a given index. The new data source replaces the existing dataSource
property.
Example:
extension ViewController: PagingViewControllerDataSource {
func numberOfViewControllers<T>(in: PagingViewController<T>) -> Int {
return items.count
}
func pagingViewController<T>(_ pagingViewController: PagingViewController<T>, viewControllerForIndex index: Int) -> UIViewController {
return ItemViewController(item: items[index])
}
func pagingViewController<T>(_ pagingViewController: PagingViewController<T>, pagingItemForIndex index: Int) -> T {
return items[index] as! T
}
}
...
pagingViewController.dataSource = self
Three new delegate methods have been added to the PagingViewControllerDelegate
protocol. You can now be notified before, during and after the user navigates to another view controller:
protocol PagingViewControllerDelegate: class {
func pagingViewController<T>(
_ pagingViewController: PagingViewController<T>,
isScrollingFromItem currentPagingItem: T,
toItem upcomingPagingItem: T?,
startingViewController: UIViewController,
destinationViewController: UIViewController?,
progress: CGFloat)
func pagingViewController<T>(
_ pagingViewController: PagingViewController<T>,
willScrollToItem pagingItem: T,
startingViewController: UIViewController,
destinationViewController: UIViewController)
func pagingViewController<T>(
_ pagingViewController: PagingViewController<T>,
didScrollToItem pagingItem: T,
startingViewController: UIViewController?,
destinationViewController: UIViewController,
transitionSuccessful: Bool)
func pagingViewController<T>(
_ pagingViewController: PagingViewController<T>,
widthForPagingItem pagingItem: T,
isSelected: Bool) -> CGFloat?
}
The widthForPagingItem:
delegate has been changed to return CGFloat?
instead of CGFloat
(See: #100). The default implementation will return nil.
The FixedPagingViewControllerDelegate
protocol is replaced by the PagingViewControllerDelegate
protocol. The new delegate does not include the index for the paging items, but you can get the current index from the PagingIndexItem
like this:
extension ViewController: PagingViewControllerDelegate {
func pagingViewController<T>(_ pagingViewController: PagingViewController<T>, didScrollToItem pagingItem: T, startingViewController: UIViewController?, destinationViewController: UIViewController, transitionSuccessful: Bool) {
if let indexItem = pagingItem as? PagingIndexItem {
print("index: ", indexItem.index)
}
}
}
- Add option to always center selected menu item #101
- Allow subclassing the collection view layout #104
- Add empty implementations of collection view delegate methods (4840483)
- Add option to disable content interaction #113
- Add option for selected background color #114
- Add method for selecting paging items based on index #117
- Rename selectPagingItem to select(pagingItem:) #105
- Make PagingState property public #107
- Make PagingItems struct public #108
- Make PagingState extension properties public (f842a7b)
- Make indicator layout attributes open to allow subclassing (7c35acc)
- Change collection view delegate methods to open (68b125b)
- Replace PagingTheme with PagingOptions #111
- Rename
headerBackgroundColor
tomenuBackgroundColor
#116
- Fix performance issue with updating content offset #106
- Set background color for paging cell based on options (1a70bd6)
- Fix layout calculation when using transforms #102
- Account for menu spacing when generating items #103
- Fix bug with animation when selecting items (73913f)
0.9.0 - 2017-12-25
- Add method for reloading data #94
- Allow setting different width for selected cell #85
0.8.0 - 2017-11-19
- Fix selecting paging items before view appears #79
- Fix issues with safe area insets #81
0.7.0 - 2017-11-07
- Change access for EMPageViewController delegate method #72
- Improve performance by using manual frames for menu cells #68
- Add option to customize indicator and border view #67
- Update documentation #60
0.6.0 - 2017-09-25
- Upgrade to Swift 4.0 #54
- Fix bug where selecting items was not working #55
0.5.0 - 2017-08-22
- Add support for scrolling in header #48
- Require
PagingItem
to conform toHashable
andComparable
: fbd7aff - Use custom collection view layout instead of using
UICollectionViewFlowLayout
c6f78b4
0.4.0 - 2017-05-04
- Add delegate for selected items in FixedPagingViewController #46
- Fix issue with delayed rendering #45
0.3.0 - 2017-03-12
- Allow selectPagingItem to be called before viewDidAppear #32
- Move collection view above paging view #31
- Fixes for EMPageViewController #36
- Fix calculation for transition distance #33
- Fix background color on header view #41
0.2.0 - 2017-02-19
- Add progress value to menu items: #20
- Scroll menu items alongside content: #22
- Option to add spacing to indicator: #27
- Add new icons example project
- Add example for loading view controllers from storyboard
0.1.2 - 2016-12-08
- Update to Swift 3.0 #11
- Update public accessors 1f057a9
- Account for menuInsets when using sizeToFit #8
- Add support for centering fixed width menu items #10
0.1.1 - 2016-05-22
- Add MIT license #4
0.1.0 - 2016-05-22
- Inital release