Section headers and footers in iOS Swift

Introduction

Section headers and footers help organize lists by grouping items and adding titles or notes above or below each group.

You want to separate a list of contacts by their first letter.

You need to add a title above each group of settings in a settings screen.

You want to show extra information or summary below a group of items.

You want to make a long list easier to scan by grouping related items visually.

Syntax

iOS Swift

func tableView(_ tableView: UITableView, titleForHeaderInSection section: Int) -> String? {
    return "Header Title"
}

func tableView(_ tableView: UITableView, titleForFooterInSection section: Int) -> String? {
    return "Footer Title"
}

These methods belong to UITableViewDataSource protocol.

Return nil if you don't want a header or footer for that section.

Examples

Returns different header titles for two sections: "Fruits" and "Vegetables".

iOS Swift

func tableView(_ tableView: UITableView, titleForHeaderInSection section: Int) -> String? {
    return ["Fruits", "Vegetables"][section]
}

Shows a footer with the section number below each section.

iOS Swift

func tableView(_ tableView: UITableView, titleForFooterInSection section: Int) -> String? {
    return "End of section \(section + 1)"
}

Sample App

This example shows a table with two sections: "Fruits" and "Vegetables". Each section has a header title and a footer note. The table displays the items in each group.

iOS Swift

import UIKit

class ViewController: UIViewController, UITableViewDataSource {
    let tableView = UITableView()
    let data = [["Apple", "Banana"], ["Carrot", "Lettuce"]]
    let headers = ["Fruits", "Vegetables"]
    let footers = ["End of fruits", "End of vegetables"]

    override func viewDidLoad() {
        super.viewDidLoad()
        tableView.frame = view.bounds
        tableView.dataSource = self
        view.addSubview(tableView)
    }

    func numberOfSections(in tableView: UITableView) -> Int {
        return data.count
    }

    func tableView(_ tableView: UITableView, numberOfRowsInSection section: Int) -> Int {
        return data[section].count
    }

    func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -> UITableViewCell {
        let cell = UITableViewCell(style: .default, reuseIdentifier: "cell")
        cell.textLabel?.text = data[indexPath.section][indexPath.row]
        return cell
    }

    func tableView(_ tableView: UITableView, titleForHeaderInSection section: Int) -> String? {
        return headers[section]
    }

    func tableView(_ tableView: UITableView, titleForFooterInSection section: Int) -> String? {
        return footers[section]
    }
}

Important Notes

Headers and footers are optional; return nil to omit them.

For more custom headers or footers, use UITableViewDelegate methods to provide views instead of just text.

Headers appear above the section rows; footers appear below.

Summary

Section headers and footers help organize and label groups in a list.

Use UITableViewDataSource methods to add simple text headers and footers.

They improve readability and user experience in long or grouped lists.

Practice

1. What is the main purpose of section headers and footers in a UITableView?

easy

A. To change the background color of the table view

B. To add animations between table cells

C. To handle user input events

D. To organize and label groups of rows for better readability

Solution

1. Step 1: Understand the role of section headers and footers

   Section headers and footers are used to separate and label groups of rows in a table view.

2. Step 2: Identify their effect on user experience

   They improve readability by clearly marking different sections, making the list easier to navigate.

3. Final Answer:

   To organize and label groups of rows for better readability -> Option D

4. Quick Check:

   Section headers and footers = organize groups [OK]

Hint: Headers and footers label groups in lists [OK]

Common Mistakes:

• Confusing headers with animations
• Thinking headers change colors only
• Assuming headers handle input

2. Which UITableViewDataSource method is used to provide a title for a section header?

easy

A. tableView(_:cellForRowAt:)

B. tableView(_:titleForHeaderInSection:)

C. tableView(_:heightForRowAt:)

D. tableView(_:didSelectRowAt:)

Solution

1. Step 1: Recall UITableViewDataSource methods for headers

   The method tableView(_:titleForHeaderInSection:) returns the text for the header of a section.

2. Step 2: Differentiate from other methods

   Other methods handle cells, row height, or selection, not headers.

3. Final Answer:

   tableView(_:titleForHeaderInSection:) -> Option B

4. Quick Check:

   Header title method = tableView(_:titleForHeaderInSection:) [OK]

Hint: Header titles use titleForHeaderInSection method [OK]

Common Mistakes:

• Choosing cellForRowAt for headers
• Confusing heightForRowAt with header titles
• Selecting didSelectRowAt which is for taps

3. Given this code snippet, what will be displayed as the footer text for section 1?

func tableView(_ tableView: UITableView, titleForFooterInSection section: Int) -> String? {
  if section == 0 {
    return "End of first section"
  } else if section == 1 {
    return "End of second section"
  }
  return nil
}

medium

A. "End of second section"

B. "End of first section"

C. nil (no footer text)

D. Runtime error

Solution

1. Step 1: Analyze the method for section 1

   The method checks if section == 1 and returns "End of second section" for that case.

2. Step 2: Confirm no errors or nil for section 1

   Since section 1 matches the else if condition, it returns the string, not nil or error.

3. Final Answer:

   "End of second section" -> Option A

4. Quick Check:

   Footer for section 1 = "End of second section" [OK]

Hint: Check section number in footer method [OK]

Common Mistakes:

• Confusing section 0 and 1
• Assuming nil means default text
• Expecting runtime error from this code

4. Identify the error in this code for adding a section header title:

func tableView(_ tableView: UITableView, titleForHeaderInSection section: Int) -> String? {
  if section == 0 {
    return "First Section"
  }
}

medium

A. Using String instead of String?

B. Wrong method name for header title

C. Missing return statement for all code paths

D. Incorrect parameter types

Solution

1. Step 1: Check method return type and all paths

   The method returns String? but does not return anything if section != 0, causing a missing return error.

2. Step 2: Confirm method signature correctness

   The method name and parameters are correct; the issue is missing return for other sections.

3. Final Answer:

   Missing return statement for all code paths -> Option C

4. Quick Check:

   All paths must return a value [OK]

Hint: All function paths must return a value [OK]

Common Mistakes:

• Ignoring missing return for else cases
• Thinking method name is wrong
• Confusing return type with optional

5. You want to display a custom view as a section header instead of just text. Which UITableViewDelegate method should you implement?

hard

A. tableView(_:viewForHeaderInSection:)

B. tableView(_:titleForHeaderInSection:)

C. tableView(_:heightForRowAt:)

D. tableView(_:didSelectRowAt:)

Solution

1. Step 1: Identify method for custom header views

   The method tableView(_:viewForHeaderInSection:) allows returning a UIView to use as a header.

2. Step 2: Differentiate from text-only header method

   tableView(_:titleForHeaderInSection:) returns only a String, not a view.

3. Final Answer:

   tableView(_:viewForHeaderInSection:) -> Option A

4. Quick Check:

   Custom header view method = viewForHeaderInSection [OK]

Hint: Use viewForHeaderInSection for custom header views [OK]

Common Mistakes:

• Using titleForHeaderInSection for views
• Confusing row height with header view
• Thinking didSelectRowAt affects headers