https://github.com/partho-maple/PBTreeView
An UITreeView implementation from UITableView that Apple missed in its UIKit framework. And it is in pure Swift.
https://github.com/partho-maple/PBTreeView
dynamic ios ios-component ios-swift swift swift5 tree-structure treeview ui-components uikit uikit-framework uitableview uitableview-subclass uitreeview
Last synced: 7 days ago
JSON representation
An UITreeView implementation from UITableView that Apple missed in its UIKit framework. And it is in pure Swift.
- Host: GitHub
- URL: https://github.com/partho-maple/PBTreeView
- Owner: partho-maple
- Created: 2017-04-10T14:51:05.000Z (about 9 years ago)
- Default Branch: master
- Last Pushed: 2019-07-02T01:31:50.000Z (almost 7 years ago)
- Last Synced: 2024-12-19T14:22:11.064Z (over 1 year ago)
- Topics: dynamic, ios, ios-component, ios-swift, swift, swift5, tree-structure, treeview, ui-components, uikit, uikit-framework, uitableview, uitableview-subclass, uitreeview
- Language: Swift
- Homepage:
- Size: 6.22 MB
- Stars: 138
- Watchers: 3
- Forks: 11
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-bangladeshi-foss - PBTreeView - Swift UITreeView built on UITableView for displaying hierarchical data. (Developer Tools & Libraries / 🚀 How to contribute)
README
# PBTreeView
----------
An UITreeView implementation from UITableView that Apple missed in its UIKit framework. And it is in pure Swift.
★★ Star our github repository to help us! ★★
Created by Partho Biswas (@ParthoBiswas007)
## What's in it
- [x] An UITreeView implementation from UITableView.
- [x] An iOS application showing it's implementation and usage.
## Preview
## Requirements
iOS 8.0+ / Swift 5.0+
## Setup and Usage
This `PBTreeView` has been drawn over `UITableView`. Every row/node of the TreeView represents a `UITableViewCell` with a custom object.
> Step 1:
* First you need to arrange some datasource that seems like a tree. Check this [JSON datasource](https://github.com/partho-maple/PBTreeView/blob/master/PBTreeVIew/PBTreeVIew/Supporting%20FIles/getRelation.json) as example.
* This JSON data contains [RelationshipDetails](https://github.com/partho-maple/PBTreeView/blob/master/PBTreeVIew/PBTreeVIew/Classes/Model/JSON/RelationshipDetails.swift) object as primary unit. This object will contain the information for each node of the tree. This object need to have an unique identifire. In this case, it's `social_security_number`.
> Step 2:
* Create a `TreeViewDataHandler` object and call it's following function passing the parsed data array
```
public func configureTreeViewDatasource(_ relationDetails: [RelationshipDetails]) -> [TreeViewNodeItem]?
```
And use the return value of the above function as TreeView's data source. Lile following.
```
var dataHandler: TreeViewDataHandler? = TreeViewDataHandler()
let relations: [RelationshipDetails]? = readJson(JSON_File_Name)
var treeViewDataSource = [TreeViewNodeItem]()
treeViewDataSource = (dataHandler?.configureTreeViewDatasource(relations!))!
```
> Step 3:
* Listen for `RelodeTreeView` notification to relode the TreeView.
```
NotificationCenter.default.addObserver(self, selector: #selector(relodeTreeView(_:)), name: NSNotification.Name(rawValue: "RelodeTreeView"), object: nil)
func relodeTreeView(_ notification: Notification) {
self.treeViewDataSource = (dataHandler?.refreshNodes())!
DispatchQueue.main.async {
self.famityTreeTableView.reloadData()
}
}
```
## Customisation
### Setting up `UITableViewCell` and `UITableView`
* Create your own `UITableViewCell` custom subclass for the TreeView node.
### Setting up custom data model
* Just replace `Relations` and `RelationshipDetails` object with your own with proper changes and requirments.
## Up Next
* Dynamic addition and deletion of tree node.
* Dyanmic Data Container
* Dynamic View Holder
## Contributing
Contributions are welcome. Please just open an Issue on GitHub to discuss a point or request a feature or send a Pull Request with your suggestion. If there's a related discussion on the Swift Evolution mailing list, please also post the thread name with a link.
Please also try to follow the same syntax and semantic in your **commit messages** (see rationale [here](http://chris.beams.io/posts/git-commit/)).