GridView
GridView can tile the view while reusing it. It has an API like UIKit that works fast. Even when device rotates it smoothly relayout.
Appetize's Demo
You Can
- Scroll like paging
- Scroll infinitely
- Scale the view
- Call API like the
UITableView
Requirements
- Swift 5.0
- iOS 9.0 or later
How to Install
CocoaPods
Add the following to your Podfile:
pod "G3GridView"
⚠️ WARNING : If you want to install fromCocoaPods, must addG3GridViewto Podfile because there is aGridViewdifferent from thisGridView.
Carthage
Add the following to your Cartfile:
github "KyoheiG3/GridView"
Over View
GridView can scroll in any direction while reusing Cell like UITableView. Also it is based UIScrollView and paging and scaling are possible. If necessary, it is possible to repeat the left and right scroll infinitely.
GridView is one UIScrollView, but the range which Cell is viewed depends on Superview. Cell reuse is also done within the range which Superview is viewed, so its size is very important.
On the other hand, scaling and paging depend to position and size of GridView. 'bounds' is important for paging, 'frame' is important in scaling. The same is true for offset of content.
The following image is a visual explanation of the view hierarchy.
You can use it like the UITableView APIs. However, there is concept of Column. The following functions are delegate APIs of 'GridView'.
func gridView(_ gridView: GridView, numberOfRowsInColumn column: Int) -> Int
func gridView(_ gridView: GridView, cellForRowAt indexPath: IndexPath) -> GridViewCell
@objc optional func numberOfColumns(in gridView: GridView) -> Int
You can see that must return the count.
Examples
This project is including two examples that is timetable and paging. Those can change on Interface Builder for following:
Try the two examples.
| timetable | paging |
|---|---|
 |
 |
Usage
Variables
Infinite Loop
A horizontal loop is possible.
open var isInfinitable: Bool
- Default is
true. - Set
falseif you don't need to loop of view.
gridView.isInfinitable = true
Scaling
Content is done relayout rather than scaling like 'UIScrollView'.
open var minimumScale: Scale
open var maximumScale: Scale
- Default for x and y are 1.
- Set the vertical and horizontal scales.
public var currentScale: Scale { get }
- Get current vertical and horizontal scales.
gridView.minimumScale = Scale(x: 0.5, y: 0.5)
gridView.maximumScale = Scale(x: 1.5, y: 1.5)
Fill for Cell
It is possible to decide the placement of Cell at relayout.
open var layoutWithoutFillForCell: Bool
- Default is
false. - Set
trueif need to improved view layout performance.
| false | true |
|---|---|
 |
 |
gridView.layoutWithoutFillForCell = true
Content Offset
If isInfinitable is true, contentOffset depends on the content size including size to loop. It is possible to take content offset that actually visible.
open var actualContentOffset: CGPoint { get }
Delegate
Set the delegate destination. This delegate property is UIScrollViewDelegate but, actually set the GridViewDelegate.
weak open var dataSource: GridViewDataSource?
open var delegate: UIScrollViewDelegate?
Functions
State
Get the view state.
public func visibleCells<T>() -> [T]
public func cellForRow(at indexPath: IndexPath) -> GridViewCell?
public func rectForRow(at indexPath: IndexPath) -> CGRect
public func indexPathsForSelectedRows() -> [IndexPath]
public func indexPathForRow(at position: CGPoint) -> IndexPath
Operation
Operate the view.
public func contentScale(_ scale: CGFloat)
public func reloadData()
public func invalidateContentSize()
public func invalidateLayout(horizontally: Bool = default)
public func deselectRow(at indexPath: IndexPath)
override open func setContentOffset(_ contentOffset: CGPoint, animated: Bool)
public func scrollToRow(at indexPath: IndexPath, at scrollPosition: GridViewScrollPosition = default, animated: Bool = default)
LICENSE
Under the MIT license. See LICENSE file for details.
100 Jun 5, 2022
1.3k Jan 5, 2023
3 Nov 8, 2022
3 Nov 27, 2022
630 Dec 13, 2022
551 Dec 28, 2022
14 Oct 21, 2022
0 Nov 21, 2022
4 Nov 28, 2022
316 Nov 17, 2022
45 Jun 28, 2022
0 Jun 11, 2022
171 Oct 11, 2022
1 Sep 1, 2022
8 Nov 24, 2022
8 Dec 15, 2022
280 Sep 29, 2022
44 Dec 27, 2022
18k Jan 5, 2023