Close Menu

TOInsetGroupedTableView

TOInsetGroupedTableView

The TOInsetGroupedTableView is a subclass of UITableView that provides a grouped table view style with customizable inset margins for section headers and footers. This allows for creating visually pleasing designs with consistent spacing across all sections and cells.

Installation

  • Using CocoaPods:

“`
pod ‘TOInsetGroupedTableView’
“`

Or manually download the source files and add them to your project.

Usage

To use the TOInsetGroupedTableView in your project, follow these steps:

  1. Import the TOInsetGroupedTableView module:

“`swift
import TOInsetGroupedTableView
“`

Ensure that your view controller conforms to the UITableViewDelegate and UITableViewDataSource protocols.

Create an instance of TOInsetGroupedTableView:

“`swift
let tableView = TOInsetGroupedTableView(frame: CGRect(x: 0, y: 0, width: view.bounds.width, height: view.bounds.height), style: .grouped)
“`

Set the delegate and data source for the table view:

“`swift
tableView.delegate = self
tableView.dataSource = self
“`

Implement the necessary UITableViewDelegate and UITableViewDataSource methods to provide the table view with data and the desired appearance.

Customization

The TOInsetGroupedTableView class provides various properties for customizing the appearance and layout. These properties can be accessed and modified on an instance of TOInsetGroupedTableView. Here are some of the available customization options:

  • sectionHeaderInset: A UIEdgeInsets value that specifies the top, left, bottom, and right insets for the section headers.
  • sectionFooterInset: A UIEdgeInsets value that specifies the top, left, bottom, and right insets for the section footers.
  • sectionHeaderHeight: A CGFloat value that specifies the height of the section headers.
  • sectionFooterHeight: A CGFloat value that specifies the height of the section footers.
  • sectionHeaderTitleColor: A UIColor value that specifies the text color of the section headers.
  • sectionFooterTitleColor: A UIColor value that specifies the text color of the section footers.
  • sectionHeaderTitleFont: A UIFont value that specifies the font of the section headers.
  • sectionFooterTitleFont: A UIFont value that specifies the font of the section footers.

Example Usage

Here is an example of how to use the TOInsetGroupedTableView:


import UIKit
import TOInsetGroupedTableView

class ViewController: UIViewController, UITableViewDelegate, UITableViewDataSource {

    var tableView: TOInsetGroupedTableView!
    
    override func viewDidLoad() {
        super.viewDidLoad()
        
        tableView = TOInsetGroupedTableView(frame: CGRect(x: 0, y: 0, width: view.bounds.width, height: view.bounds.height), style: .grouped)
        
        tableView.delegate = self
        tableView.dataSource = self
        
        // Register your custom table view cells if needed
        tableView.register(UITableViewCell.self, forCellReuseIdentifier: "Cell")
        
        view.addSubview(tableView)
    }
    
    // Implement UITableViewDataSource and UITableViewDelegate methods
    
    // ...
    
}

Remember to implement the necessary UITableViewDelegate and UITableViewDataSource methods and configure the appearance according to your requirements.

Requirements

– iOS 9.0+

– Xcode 11+

– Swift 5+

License

TOInsetGroupedTableView is released under the MIT license. See the LICENSE file for more details.