Giter Club home page Giter Club logo

expandablecell's Introduction

ExpandableCell

Awesome Version Carthage Compatible License: MIT Platform Swift 4.0 iOS 8.0+

Find someone who want to make this project better than before :) Currently, I don't have enough time to resolve issues :(

Intoduction

Fully refactored YNExapnadableCell with more concise, bug free. Easiest usage of expandable & collapsible cell for iOS, written in Swift 3. You can customize expandable UITableViewCell whatever you like. ExpandableCell is made because insertRows and deleteRows is hard to use. Just inheirt ExpandableDelegate

demo

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

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!
}

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

Requirements

ExpandableCell written in Swift 3. 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

younatics Twitter

License

ExpandableCell is available under the MIT license. See the LICENSE file for more info.

expandablecell's People

Contributors

bagage avatar ezefranca avatar hadiidbouk avatar kennydust avatar kwongius avatar tokijh avatar younatics avatar

Watchers

 avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.