How do I install FoldingCell using Swift Package Manager?

Add the dependency to your Package.swift file with .package(url: 'https://github.com/Ramotion/folding-cell.git', from: '5.0.2'). This integrates seamlessly with modern Xcode projects and handles version management automatically.

Can FoldingCell be used with UICollectionView?

No, FoldingCell is specifically designed for UITableView and relies on its cell lifecycle and height management. For UICollectionView, you would need to adapt the code significantly or find an alternative library.

How to change the folding animation speed in FoldingCell?

Override the animationDuration method in your custom cell class to return custom time intervals for each fold stage, as shown in the example with durations array. This allows fine-tuning of the animation timing.

FoldingCell or standard iOS expandable cell: which is better?

FoldingCell offers a unique, polished animation that standard cells lack, making it ideal for visually rich apps. However, it requires more setup and is less flexible for simple expand/collapse without custom animations.

How to use FoldingCell without storyboards?

Create foregroundView and containerView programmatically by adding constraints in code, as demonstrated in the linked example 'Folding-cell-programmatically'. This approach avoids Interface Builder but still requires careful layout management.

Is FoldingCell compatible with the latest iOS versions?

The library supports iOS 8.0+ and Swift 5.0, so it should work on recent iOS versions. However, it may not leverage newer iOS APIs or Swift features, and maintenance updates are infrequent.

How to handle multiple open cells in a table with FoldingCell?

Manage a cellHeights array in your table view controller to track open/close states, and use the provided animation methods to control transitions. You can modify the code to allow only one cell open at a time or support multiple expands.

Open-Awesome

folding-cell

MITSwift5.0.2

An iOS UITableViewCell subclass that expands and collapses with a folding paper card animation.

Visit Website GitHub

10.2k stars1.1k forks0 contributors

What is folding-cell?

FoldingCell is an open-source iOS library that provides a custom UITableViewCell with a folding animation. It allows developers to create expanding content cells that mimic the folding of a paper card, adding a polished, interactive element to lists and tables. It solves the need for engaging, non-standard cell animations without requiring complex custom animation code.

Target Audience

iOS developers building apps with UITableViews who want to add sophisticated, material-design inspired animations to their user interfaces. It's particularly useful for those creating apps where visual feedback and smooth transitions are a priority.

Value Proposition

Developers choose FoldingCell because it offers a production-ready, highly visual animation component that is easy to integrate via multiple dependency managers. Its design is inspired by material design principles, and it handles the complex animation and layout logic internally, saving significant development time.

Overview

:octocat: 📃 FoldingCell is an expanding content cell with animation made by @Ramotion

Use Cases

Best For

Adding animated expandable sections to a settings or FAQ screen
Creating interactive list items that reveal detailed content on tap
Implementing material-design folding animations in iOS apps
Enhancing UITableView with custom cell transitions
Building apps that require a polished, visually distinctive UI
Prototyping interactive list interfaces quickly

Not Ideal For

Apps built with SwiftUI that require modern declarative UI frameworks
Projects using UICollectionView or custom scroll views instead of UITableView
Teams needing drop-in, pre-styled components without manual constraint configuration
Applications where animation performance is critical and minimal overhead is desired

Pros & Cons

Pros

Visually Striking Animation

The folding effect mimics paper material design, providing a smooth, multi-stage transition that enhances user engagement, as demonstrated in the GIF and tutorial.

Flexible Integration Options

Supports installation via CocoaPods, Carthage, Swift Package Manager, and manual drag-and-drop, with both Storyboard IBInspectable properties and code-based setup.

Configurable Folding Stages

Allows setting the itemCount property to control the number of folds, enabling different animation depths beyond the default two stages.

Built-in UITableView Compatibility

Includes helpers for dynamically animating cell heights, simplifying the integration with standard iOS table view controllers.

Cons

UIKit and UITableView Lock-in

Exclusively designed for UIKit's UITableView, making it unsuitable for SwiftUI projects or apps using other view controllers like UICollectionView.

Manual Constraint Configuration

Requires precise setup of foregroundView and containerView with specific constraints, which can be complex and error-prone, as outlined in the tutorial steps.

Limited Animation Customization

While fold counts are adjustable, the animation style is fixed to the folding effect, with no built-in support for other transition types like sliding or fading.

Frequently Asked Questions

Related Projects

SwipeCellKit

Swipeable UITableViewCell/UICollectionViewCell based on the stock Mail.app, implemented in Swift.

Stars6,289

Forks812

Last commit1 year ago

expanding-collection

:octocat: ExpandingCollection is an animated material design UI card peek/pop controller. iOS library made by @Ramotion

Stars5,523

Forks522

Last commit6 years ago

DGElasticPullToRefresh

Elastic pull to refresh for iOS developed in Swift

Stars3,752

Forks436

Last commit3 years ago

Persei

Animated top menu for UITableView / UICollectionView / UIScrollView written in Swift

Stars3,436

Forks312