nicklockwood/iCarousel
ICarousel
iCarousel is a data-driven UI library for macOS and iOS used to build interactive three-dimensional scrolling experiences. It functions as a customizable view controller that renders paged content using cylindrical or cover-flow 3D effects.
The component is distinguished by its programmable perspective and visual transformation hooks, which allow for the definition of custom 3D styles and bespoke animation effects. Users can adjust viewpoint distance, alpha fading, and foreshortening to control how the vanishing point and depth appear during navigation.
The library manages high-performance view recycling by loading necessary item views on demand from a data source. It covers broad capability areas including interactive content navigation, coordinate-based item detection for touch events, and the management of dynamic item insertion and deletion.
Features
- Carousel Transition Effects - Renders paged content using cylindrical and cover-flow 3D effects for a fluid scrolling experience.
- Content Carousels - Renders paged content using cylindrical or wheel layouts to create interactive 3D scrolling experiences.
- Dynamic Depth Simulations - Simulates a 3D vanishing point by adjusting the z-axis and foreshortening based on viewpoint distance.
- 3D Viewport Configurations - Configures viewpoint and foreshortening to control the vanishing point and 3D depth.
- 3D UI Components - Provides 3D scrolling galleries and carousels for iOS and macOS apps with visual depth.
- Carousel Components - A data-driven Swift component that renders paged content using cylindrical or cover-flow 3D effects.
- Transform Calculators - Calculates dynamic 3D rotations, scaling, and transparency based on an item's relative offset from the center.
- Customizable UI Components - Offers programmable perspective, alpha fading, and transformation hooks for custom animations.
- Data-Driven View Controllers - Acts as a scrolling container that manages view recycling and dynamic loading from a data source.
- Offset Calculators - Determines the offset of items from the center to apply custom transforms and transparency.
- Interaction Handling - Detects taps and gestures on individual items through delegate methods to trigger application logic.
- Dynamic View Loading - Loads item views and placeholders on demand as the user scrolls to optimize memory.
- Navigation & Scrolling Tools - Implements custom paging and scrolling behaviors combined with 3D transforms for content browsing.
- Collection View Optimizers - Limits the number of active views to maintain smooth performance when handling large datasets.
- Cylindrical Projections - Implements cylindrical projection mapping to create the visual effect of a rotating 3D wheel.
- Scrolling Carousels - Controls scrolling, paging, and bounce physics to determine how users navigate 3D content.
- Data-Driven Layouts - Manages large sets of paged content using a data source to efficiently render and recycle views.
- View Recycling Systems - Implements high-performance view recycling to maintain smooth scrolling through large datasets.
- View Recycling - Optimizes memory and frame rates by recycling complex views and loading only necessary elements.
- Custom Animation Effects - Provides hooks to define bespoke visual transformations and custom 3D animation effects.
- iOS UI Components - Provides a set of 3D layout tools designed specifically for the iOS and macOS platforms.
- Animation Engines - Provides a programmable engine to handle autoscrolling and precise item centering using calculated offsets.
- Behavior Configurations - Allows adjustment of visual properties like perspective, alpha fading, and paging constraints.
- Data Refresh Mechanisms - Includes a mechanism to reload all views from the data source to update the current display.
- Collection Item Controllers - Supports dynamic removal of items with automatic sliding animations to fill gaps.
- Collection Managers - Handles the dynamic insertion and deletion of items to update the carousel content list.
- Transform Styles - Implements unique 3D effects by applying visual transformations to items based on their offset.
- Distance-Based Transitions - Adjusts spacing, tilt, and fade-out thresholds of items based on their distance from the center.
- UI Components - Highly customizable 3D carousel for data-driven views.
