Product Promotion
0x5a.live
for different kinds of informations and explorations.
GitHub - younatics/ExpandableCell: ✨ Awesome expandable, collapsible tableview cell for iOS written in Swift 5
✨ Awesome expandable, collapsible tableview cell for iOS written in Swift 5 - younatics/ExpandableCell
Visit SiteGitHub - younatics/ExpandableCell: ✨ Awesome expandable, collapsible tableview cell for iOS written in Swift 5
✨ Awesome expandable, collapsible tableview cell for iOS written in Swift 5 - younatics/ExpandableCell
Powered by 0x5a.live 💗
ExpandableCell
Intoduction
Fully refactored YNExapnadableCell with more concise, bug free. Easiest usage of expandable & collapsible cell for iOS, written in Swift 5. You can customize expandable UITableViewCell
whatever you like. ExpandableCell
is made because insertRows
and deleteRows
is hard to use. Just inheirt ExpandableDelegate
Usage
Basic
import ExpandableCell
Make ExpandableTableView
in Storyboard or in code
@IBOutlet var tableView: ExpandableTableView!
Inherit ExpandableDelegate
class ViewController: UIViewController, ExpandableDelegate
Set delegate
tableView.expandableDelegate = self
Set required ExpandableDelegate
method.
Key two methods
Required ExpandableDelegate | Explanation |
---|---|
func expandableTableView(_ expandableTableView: ExpandableTableView, expandedCellsForRowAt indexPath: IndexPath) -> [UITableViewCell]? |
Key method to get expandable cells |
func expandableTableView(_ expandableTableView: ExpandableTableView, heightsForExpandedRowAt indexPath: IndexPath) -> [CGFloat]? |
Key method to get expandable cells's height |
Required UITableViewDelegate, UITableViewDataSource | Explanation |
---|---|
func expandableTableView(_ expandableTableView: ExpandableTableView, cellForRowAt indexPath: IndexPath) -> UITableViewCell |
- |
func expandableTableView(_ expandableTableView: ExpandableTableView, numberOfRowsInSection section: Int) -> Int |
- |
func expandableTableView(_ expandableTableView: ExpandableTableView, heightForRowAt indexPath: IndexPath) -> CGFloat |
- |
Advanced
ExpandableTableView property
Property | Type | Explanation |
---|---|---|
animation |
UITableViewRowAnimation |
Animation when open and close |
expansionStyle |
ExpandableTableView.ExpansionStyle |
Select expansion type:single - one row at a time;singlePerSection - one row at a time, per section;multi - any number of rows at a time |
autoRemoveSelection |
Bool |
autoRemoveSelection true means the cell will flicker selected, and autoRemoveSelection false means the default selection behaviour of the tableview will apply (single or multi selection) |
ExpandableTableView methods
Method | Explanation |
---|---|
openAll |
Open all that you set in func expandableTableView(_ expandableTableView: ExpandableTableView, expandedCellsForRowAt indexPath: IndexPath) -> [UITableViewCell]? |
closeAll |
Close all that you set in func expandableTableView(_ expandableTableView: ExpandableTableView, expandedCellsForRowAt indexPath: IndexPath) -> [UITableViewCell]? |
reloadData |
TableView reload data. Expanded cells will be work also |
open(at indexPath: IndexPath) |
Open specific indexPath |
Optional delegates
Optional ExpandableDelegate | Explanation |
---|---|
func expandableTableView(_ expandableTableView: ExpandableTableView, didSelectExpandedRowAt indexPath: IndexPath) |
Get indexpath in expanded row |
func expandableTableView(_ expandableTableView: ExpandableTableView, expandedCell: UITableViewCell, didSelectExpandedRowAt indexPath: IndexPath) |
Get expandedCell and indexPath |
Optional UITableViewDelegate, UITableViewDataSource | Explanation |
---|---|
func expandableTableView(_ expandableTableView: ExpandableTableView, didSelectRowAt indexPath: IndexPath) |
- |
func expandableTableView(_ expandableTableView: ExpandableTableView, titleForHeaderInSection section: Int) -> String? |
- |
func expandableTableView(_ expandableTableView: ExpandableTableView, heightForHeaderInSection section: Int) -> CGFloat |
- |
func expandableTableView(_ expandableTableView: ExpandableTableView, viewForHeaderInSection section: Int) -> UIView? |
- |
func numberOfSections(in expandableTableView: ExpandableTableView) -> Int |
- |
func expandableTableView(_ expandableTableView: ExpandableTableView, willDisplay cell: UITableViewCell, forRowAt indexPath: IndexPath) |
- |
func expandableTableView(_ expandableTableView: ExpandableTableView, willDisplayHeaderView view: UIView, forSection section: Int) |
- |
func expandableTableView(_ expandableTableView: ExpandableTableView, willDisplayFooterView view: UIView, forSection section: Int) |
- |
For arrow effect
Inherit ExpandableCell
when you need arrow effect or change arrow image
open class ExpandableCell: UITableViewCell {
open var arrowImageView: UIImageView!
}
For highlight animation
Inherit ExpandableCell
when you need disable or enable highlight animation
open class ExpandableCell: UITableViewCell {
open var highlightAnimation = HighlightAnimation.animated
}
Adding right margin to arrow icon
Inherit ExpandableCell
when you need right margin ( Default margin is 16 )
open class ExpandableCell: UITableViewCell {
open var rightMargin: CGFloat = 16
}
Set tableview insert animation
tableView.animation = .automatic
Make protocols in ExpandableDelegate
if you need or make pull request to me :)
ExpandableCell methods
ExpandableCell methods | Explanation |
---|---|
isExpanded() |
Check if cell is expanded or not |
isInitiallyExpanded() |
Make cell be open when the tableView content first appears in the view |
isSelectable() |
Make cell be selectable or not, regardless of tableView selectionStyle |
Requirements
ExpandableCell
written in Swift 5.0. Compatible with iOS 8.0+
Installation
Cocoapods
ExpandableCell is available through CocoaPods. To install it, simply add the following line to your Podfile:
pod 'ExpandableCell'
Carthage
github "younatics/ExpandableCell"
References
Please tell me or make pull request if you use this library in your application :)
Author
License
ExpandableCell is available under the MIT license. See the LICENSE file for more info.
Swift Resources
are all listed below.
Made with ❤️
to provide different kinds of informations and resources.