How do I create a custom animation in CRRefresh?

To create a custom animation, conform to the CRRefreshProtocol by implementing methods like refreshBegin and refreshEnd, and define properties such as view and trigger heights. This allows full control over the animation behavior, as detailed in the README's customization section.

CRRefresh vs MJRefresh: which is better for iOS?

CRRefresh offers a Swift-native, protocol-based approach for deep customization, while MJRefresh is a popular Objective-C library with more built-in styles. Choose CRRefresh if you prefer Swift and want flexible customization; MJRefresh might be better for quick, pre-styled solutions in mixed codebases.

How to remove the refresh control in CRRefresh?

Use the removeHeader() or removeFooter() methods on the scroll view's cr property, such as tableView.cr.removeHeader(), to cleanly detach the refresh components, as shown in the README's removal section.

Does CRRefresh work with SwiftUI?

No, CRRefresh is built for UIKit and does not support SwiftUI out of the box. You would need to wrap it in a UIViewRepresentable or consider alternative libraries designed for SwiftUI's declarative approach.

What's the best CRRefresh animator for a chat app?

For a chat app, FastAnimator or SlackLoadingAnimator might be suitable due to their subtle, modern designs. FastAnimator provides a quick spinning indicator, while SlackLoadingAnimator mimics Slack's loading style, both fitting chat interfaces well based on the GIF examples.

How to handle infinite scrolling with CRRefresh?

Add foot refresh using tableView.cr.addFootRefresh with an animator, and control the loading state with methods like endLoadingMore and noticeNoMoreData to handle pagination logic, as demonstrated in the usage code for load-more functionality.

Open-Awesome

CRRefresh

MITSwift

A Swift library for adding customizable pull-to-refresh and infinite scrolling animations to iOS scroll views.

GitHub

960 stars113 forks0 contributors

What is CRRefresh?

CRRefresh is a Swift library for iOS that provides an easy way to add pull-to-refresh and infinite scrolling functionality to scrollable views. It solves the problem of implementing smooth, customizable refresh animations in UITableView, UICollectionView, and other UIScrollView subclasses with minimal code.

Target Audience

iOS developers building apps that require refresh functionality in table views, collection views, or text views, particularly those who want customizable animation styles beyond the system defaults.

Value Proposition

Developers choose CRRefresh for its clean protocol-based architecture that makes customization straightforward, its support for multiple scroll view types, and its collection of pre-built, visually appealing animators that work out of the box.

Overview

An easy way to use pull-to-refresh

Use Cases

Best For

Adding pull-to-refresh to UITableView in Swift iOS apps
Implementing infinite scrolling in UICollectionView
Creating custom refresh animations with unique visual styles
Building iOS apps that need consistent refresh behavior across different scroll view types
Quickly prototyping refresh functionality with pre-built animators
Maintaining clean refresh code through a standardized protocol

Not Ideal For

Apps built entirely with SwiftUI that require native refresh components
Projects needing out-of-the-box, no-code animation customization without protocol implementation
Teams prioritizing frequent library updates with new built-in animations
Large-scale apps with complex state management where integrated solutions like RxSwift bindings are preferred

Pros & Cons

Pros

Protocol-Based Customization

The CRRefreshProtocol allows developers to create fully custom animations by implementing methods like refreshBegin and refreshEnd, enabling unique refresh experiences beyond pre-built options.

Multi-View Compatibility

Supports UIScrollView and all its subclasses including UITableView, UICollectionView, and UITextView, as stated in the README, making it versatile for different iOS interfaces.

Pre-Built Animators

Includes several ready-to-use animators like NormalAnimator and RamotionAnimator, shown in screenshots, which can be added with minimal code for quick prototyping.

Simple API

Methods like addHeadRefresh and endHeaderRefresh provide an intuitive interface for managing refresh states, demonstrated in the usage examples with clear Swift code.

Cons

Limited SwiftUI Support

CRRefresh is designed for UIKit and does not natively integrate with SwiftUI, limiting its use in modern iOS development trends without additional wrapping effort.

Infrequent Updates

The README admits that new dynamic effects are not regularly added, which may leave users wanting fresh animations without investing in custom protocol implementation.

Customization Overhead

Creating custom animators requires fully conforming to the CRRefreshProtocol, which can be more complex than using drop-in components with simple configuration options.

Frequently Asked Questions

Related Projects

MJRefresh

An easy way to use pull-to-refresh.

Stars13,824

Forks3,530

Last commit5 months ago

SVPullToRefresh

Give pull-to-refresh & infinite scrolling to any UIScrollView with 1 line of code.

Stars4,787

Forks1,077

Last commit2 years ago

CBStoreHouseRefreshControl

Fully customizable pull-to-refresh control inspired by Storehouse iOS app

Stars3,896

Forks468

Last commit6 years ago

DGElasticPullToRefresh

Elastic pull to refresh for iOS developed in Swift

Stars3,750

Forks436

Last commit3 years ago

Community-curated · Updated weekly · 100% open source

Found a gem we're missing?

Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.

Submit a project Star on GitHub