How to make UICollectionView headers stay fixed using sectionHeadersPinToVisibleBounds

Paul Hudson    October 26th 2018    @twostraws

Since the earliest days of iOS, UITableView has had fixed headers: as you scrolled within a table section the header stayed still, only moving off when another section reached the top.

This same functionality was added for UICollectionView in iOS 9.0, although it’s not enabled by default and only available with UICollectionViewFlowLayout.

To use it yourself, first make sure your collection view’s collectionViewLayout property is an instance of UICollectionViewFlowLayout, then set that flow layout’s sectionHeadersPinToVisibleBounds property to true. For example, you might write this:

if let layout = collectionView.collectionViewLayout as? UICollectionViewFlowLayout {
    layout.sectionHeadersPinToVisibleBounds = true
}

There’s a similar property to make footers behave the same way: sectionFootersPinToVisibleBounds.

Available from iOS 9.0

Did this solution work for you? Please pass it on!

Tweet

Other people are reading…

• How set different widths for a UISegmentedControl's elements
• How to measure touch strength using 3D Touch
• How to add Retina and Retina HD graphics to your project
• How to add peek and pop to a UITableView
• How to use light text color in the status bar

About the Swift Knowledge Base

This is part of the Swift Knowledge Base, a free, searchable collection of solutions for common iOS questions.