How to use CrownControl with a UICollectionView?

CrownControl works with any UIScrollView subclass, so for UICollectionView, bind CrownAttributes to the collection view's scroll view property. Ensure you call spinToMatchScrollViewOffset in scrollViewDidScroll to sync scrolling, as shown in the Quick Usage example.

CrownControl vs native scroll indicators: which is better for UX?

CrownControl offers precise, thumb-friendly scrolling with haptic feedback and repositioning, ideal for long documents or lists. Native scroll indicators are simpler and more familiar but less customizable and require more thumb movement. Choose based on app complexity and user interaction needs.

Can CrownControl be customized for dark mode in iOS?

Yes, use the Style attributes to set background and foreground colors or gradients that adapt to dark mode. For example, configure backgroundStyle.content with dynamic colors from UIColor, but note that automatic dark mode switching isn't built-in—you must handle trait collection changes manually.

What's the performance impact of adding CrownControl?

CrownControl is lightweight and uses standard UIKit components, so performance overhead is minimal. However, excessive haptic feedback or complex gradients in the Feedback and Style sections could affect battery life on older devices.

How to make CrownControl accessible for VoiceOver?

The README doesn't cover accessibility, so you'll need to implement it manually. Set accessibility traits and labels on the crown view, and consider providing alternative scrolling methods, as CrownControl might not be fully accessible out-of-the-box.

Is CrownControl compatible with SwiftUI?

No, CrownControl is built with UIKit and requires UIViewControllers or UIViews. To use it in SwiftUI, wrap it in a UIViewRepresentable, but this adds complexity and may limit some interactive features like force touch.

Open-Awesome

CrownControl

MITSwift

A tiny iOS accessory view inspired by Apple Watch Digital Crown for scrolling content without lifting your thumb.

GitHub

110 stars12 forks0 contributors

What is CrownControl?

CrownControl is an iOS library that adds a Digital Crown-like circular control to scrollable views, allowing users to scroll content by spinning a visual indicator. It solves the problem of excessive thumb movement when navigating long lists, documents, or collections by providing a compact, repositionable scrolling accessory.

Target Audience

iOS developers building apps with extensive scrollable content like document viewers, contact lists, photo galleries, or any interface where precise scrolling improves UX.

Value Proposition

Developers choose CrownControl for its Apple Watch-inspired intuitive interaction, high customizability, and seamless UIScrollView integration without requiring major UI overhauls.

Overview

CrownControl is a tiny accessory that makes scrolling through scrollable content possible without lifting your thumb.

Use Cases

Best For

Adding alternative scrolling methods to PDF or web viewers
Enhancing navigation in long contact or list interfaces
Improving photo gallery browsing with precise scroll control
Building accessible interfaces with repositionable controls
Creating immersive reading experiences in document-based apps
Reducing thumb fatigue in scroll-heavy iOS applications

Not Ideal For

Apps targeting iOS versions below 9, as CrownControl requires iOS 9+
Projects with minimal scrolling needs or where touch-based scrolling suffices
Teams avoiding additional dependencies, since CrownControl relies on QuickLayout
Applications requiring simultaneous horizontal and vertical scrolling, as it's limited to a single scroll axis per instance

Pros & Cons

Pros

Customizable Positioning

CrownControl can be repositioned via force touch or long press and anchored to any view edge, allowing flexible placement without code changes, as detailed in the User Interaction section.

Configurable Gestures

Supports tap, double-tap, long-press, and force-touch gestures with customizable scroll actions, enabling fine-tuned interaction like scrolling forward or to edges, as shown in the Crown Attributes.

Flexible Styling

Background and foreground surfaces can be styled with gradients, borders, colors, and custom sizes, making it easy to match app design, demonstrated in the Style and Sizes sections.

Precise Scroll Control

Adjustable scroll relation lets developers define how many crown spins correspond to full scroll view traversal, enhancing precision for long content, as mentioned in the Sizes properties.

Cons

Dependency on QuickLayout

CrownControl leans heavily on QuickLayout, adding an extra third-party dependency that may increase project complexity or cause conflicts with other layout libraries.

Limited to Single Axis

Each instance is bound to a single scroll axis (horizontal or vertical), making it unsuitable for content that requires seamless multi-directional scrolling without multiple crowns.

Setup Complexity

Requires manual configuration with constraints and delegation in code, which is more involved than drop-in native components and may steepen the learning curve for quick integrations.

Frequently Asked Questions

Related Projects

SpreadsheetView

Full configurable spreadsheet view user interfaces for iOS applications. With this framework, you can easily create complex layouts like schedule, gantt chart or timetable as if you are using Excel.

Stars3,538

Forks476

Last commit2 years ago

VegaScroll

↕️ VegaScroll is a lightweight animation flowlayout for UICollectionView completely written in Swift 4, compatible with iOS 11 and Xcode 9.

Stars2,901

Forks175

Last commit3 years ago

SegementSlide

Multi-tier UIScrollView nested scrolling solution. 😋😋😋

Stars1,324

Forks167

Last commit5 years ago

UIScrollView-InfiniteScroll

UIScrollView ∞ scroll category

Stars1,052

Forks150

Last commit4 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