Collapse and expand UICollectionView sections with one method call.

Touchlane

Last update: Dec 26, 2022

Related tags

Collection View swift ios library awesome uicollectionview cocoapods collapsible expandable

Overview

This library provides a custom UICollectionView that allows to expand and collapse sections. Provides a simple API to manage collection view appearance.

Requirements

iOS 9.0+
Xcode 10.2+
Swift 5.0+

Installation

CocoaPods

CocoaPods is a dependency manager for Cocoa projects. You can install it with the following command:

$ gem install cocoapods

To integrate CampcotCollectionView into your Xcode project using CocoaPods, specify it in your Podfile:

source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '9.0'
use_frameworks!

target '<Your Target Name>' do
    pod 'CampcotCollectionView'
end

Then, run the following command:

$ pod install

Usage

Manual Setup

import CampcotCollectionView

Create CollectionView

let campcotCollectionView = CampcotCollectionView()

Add campcotCollectionView to view hierarchy.
Call toggle method on campcotCollectionView.

public func toggle(to section: Int,
                   offsetCorrection: CGFloat = default,
                   animated: Bool,
                   completion: ((Bool) -> Void)? = default)

Storyboard Setup

Add UICollectionView to your Storyboard.
In Identity Inspector set the Class property to CampcotCollectionView.
Open Attributes Inspector and set the Layout property to Custom. Set Class property to either ExpandedLayout or CollapsedLayout.
Create outlet for your collectionView.
Set datasource and delegate for collectionView.
Set the settings for collectionView in Attributes Inspector or manualy.

Documentation

CampcotCollectionView

A Boolean value that determines whether the sections are expanded.

public var isExpanded: Bool { get }

Expands all the sections. Pins a section at index section to the top of view bounds. offsetCorrection - the offset for pinned section from the top. Default value of offsetCorrection is 0. animated - if true expands sections with animation. completion - callback for animation.

public func expand(from section: Int,
                   offsetCorrection: CGFloat = default,
                   animated: Bool,
                   completion: ((Bool) -> Void)? = default)

Collapses all the sections. Pins a section at index section to the top of view bounds. offsetCorrection - the offset for pinned section from the top. Default value of offsetCorrection is 0. animated - if true collapses sections with animation. completion - callback for animation.

public func collapse(to section: Int,
                     offsetCorrection: CGFloat = default,
                     animated: Bool,
                     completion: ((Bool) -> Void)? = default)

Toggles current state from collapsed to expaned and vise versa. Pins a section at index section to the top of view bounds. offsetCorrection - the offset for pinned section from the top. Default value of offsetCorrection is 0. animated - if true toggles sections with animation. completion - callback for animation.

public func toggle(to section: Int,
                   offsetCorrection: CGFloat = default,
                   animated: Bool,
                   completion: ((Bool) -> Void)? = default)

Comments

Integrate SwiftFormat in CampcotCollectionView
Added script for formatting CampcotCollectionView and Example projects.

Added a Build phase for linter support.

Added .swiftformat configuration file.
opened by AlexYanski 2
Fix Fatal error: Division by zero in remainder operation

This fixes Thread 1: Fatal error: Division by zero in remainder operation when for some reasons prepare() method is called with zero contentWidth.

I was working on my custom fork where the collectionView should automatically calculate its size based on the Intrinsic content size. Then After awhile I was greeted by the mentioned error. Refer to the screenshot below.

I fixed the issue by preventing further calculations unless the columnsCount is greater than zero.
So I thought it will be a great addition if it doesn't break any of your calculations. (So far it doesn't break anything based on my use case).

opened by MussaCharles 1
Bug: state of self.isExpanded is incorrect on startup
Nice package and it mostly works fine but, Using this package causes the following

the collectionView starts as open despite calling view.collapse in ViewWillAppear

user needs to tap a header twice (only the first time) to collapse the collection. After the first collapse, the sections accordion appropriately with a single tap.

Finding: in calling the method "collapse" the first time, when app opens, the internal flag "isExpanded" is set to false despite the collection being defaulted to fully expanded.

I can not find where you initialize your isExpanded var, but you should probably have an optional init which passes the desired state.
opened by 224XS 1
Support storyboard
Hello, I tried to use the CampcotCollectionView in storyboard but couldn't. I ran into this error

required public init?(coder aDecoder: NSCoder) { fatalError("init(coder:) has not been implemented") }

Could you please help fix that. Thank you!
opened by tony-hoang999 1
Bottom inset correction

Add property contentSizeAdjustmentBehavior that allows to setup how contentSize will be calculated. It fixes problem when collection view has insets and content can be scrolled out of bounds.

opened by VadzimMarozau 1

Releases(0.0.8)

0.0.8(Nov 29, 2021)
Changelog for CampcotCollectionView 0.0.8

Added

Optional isExpanded parameter to CampcotCollectionView initializer.

Source code(tar.gz)
Source code(zip)
0.0.7(Feb 14, 2020)
Changelog for CampcotCollectionView 0.0.7

Fixed

Fixed crash with storyboard implementation.

Added

Storyboard support.

Properties in Attributes Inspector for CampcotCollectionView.

Example for storyboard implementation.

Source code(tar.gz)
Source code(zip)
0.0.6(Feb 13, 2020)
Changelog for CampcotCollectionView 0.0.6

Added

contentSizeAdjustmentBehavior property allows to manage content size calculation.

Source code(tar.gz)
Source code(zip)
0.0.5(Oct 18, 2019)
Changelog for CampcotCollectionView 0.0.5

Added

Layout supports more than 2 items in row.

Fixed

Fixed bug with pinned header position when contentInset.top is bigger than section height.

Source code(tar.gz)
Source code(zip)
0.0.4(Oct 9, 2019)
Changelog for CampcotCollectionView 0.0.4

Changed

Updates for Swift 5.0

Source code(tar.gz)
Source code(zip)
0.0.3(Mar 26, 2019)
Changelog for ExpandableLayout 0.0.3

Added support swift 4.2

Source code(tar.gz)
Source code(zip)
0.0.2(Feb 23, 2018)
Changelog for ExpandableLayout 0.0.2

Added

Example UI update.

Source code(tar.gz)
Source code(zip)
0.0.1(Feb 23, 2018)
Changelog for ExpandableLayout 0.0.1

Added

Initial setup.

Source code(tar.gz)
Source code(zip)

Owner

Touchlane

Making custom software for you

GitHub

An iOS drop-in UITableView, UICollectionView and UIScrollView superclass category for showing a customizable floating button on top of it.

MEVFloatingButton An iOS drop-in UITableView, UICollectionView, UIScrollView superclass category for showing a customizable floating button on top of

298 Jul 17, 2022

A Swift mixin for reusing views easily and in a type-safe way (UITableViewCells, UICollectionViewCells, custom UIViews, ViewControllers, Storyboards…)

Reusable A Swift mixin to use UITableViewCells, UICollectionViewCells and UIViewControllers in a type-safe way, without the need to manipulate their S

2.9k Jan 3, 2023

Collapse and expand UICollectionView sections with one method call.

Related tags

Overview

Requirements

Installation

CocoaPods

Usage

Manual Setup

Storyboard Setup

Documentation

CampcotCollectionView

Comments

Integrate SwiftFormat in CampcotCollectionView

Fix Fatal error: Division by zero in remainder operation

Bug: state of self.isExpanded is incorrect on startup

Support storyboard

Bottom inset correction

Releases(0.0.8)

0.0.8(Nov 29, 2021)

Changelog for CampcotCollectionView 0.0.8

Added

0.0.7(Feb 14, 2020)

Changelog for CampcotCollectionView 0.0.7

Fixed

Added

0.0.6(Feb 13, 2020)

Changelog for CampcotCollectionView 0.0.6

Added

0.0.5(Oct 18, 2019)

Changelog for CampcotCollectionView 0.0.5

Added

Fixed

0.0.4(Oct 9, 2019)

Changelog for CampcotCollectionView 0.0.4

Changed

0.0.3(Mar 26, 2019)

Changelog for ExpandableLayout 0.0.3

0.0.2(Feb 23, 2018)

Changelog for ExpandableLayout 0.0.2

Added

0.0.1(Feb 23, 2018)

Changelog for ExpandableLayout 0.0.1

Added

Owner

Touchlane

An iOS drop-in UITableView, UICollectionView and UIScrollView superclass category for showing a customizable floating button on top of it.

Automates prefetching of content in UITableView and UICollectionView

A data-driven UICollectionView framework for building fast and flexible lists.

Netflix and App Store like UITableView with UICollectionView, written in pure Swift 4.2

Incremental update tool to UITableView and UICollectionView

🚴 A declarative library for building component-based user interfaces in UITableView and UICollectionView.

Protocol-oriented UICollectionView management, powered by generics and associated types.

UICollectionView layout for presenting of the overlapping cells.

A generic small reusable components for data source implementation for UITableView/UICollectionView in Swift.

Reimagining UICollectionView

Conv smart represent UICollectionView data structure more than UIKit.

ZHTCView - UITableview & UICollectionView

CollectionView - UICollectionView using UICollectionViewCompositionalLayout

CollectionViewSegmentedControl - Scrollable UISegmentedControl built using a UICollectionView

Conv smart represent UICollectionView data structure more than UIKit.

A modest attempt to port UICollectionView to SwiftUI.

Easy and type-safe iOS table and collection views in Swift.

A SwiftUI collection view with support for custom layouts, preloading, and more.

A Swift mixin for reusing views easily and in a type-safe way (UITableViewCells, UICollectionViewCells, custom UIViews, ViewControllers, Storyboards…)