[iOS/Swift] TableView 를 위한 Protocol :: Datasource, Delegate

TableView 를 위한 Protocol

UITableView 를 위한 Protocol 은 UITableViewDataSource, UITableViewDelegate 가 있다. 여기서 Protocol 은 TableView를 이용하기 위해 해야할 일들의 목록, 즉 구현해야할 method 들이다. 

 

protocol 준수는 클래스간 상속을 하듯이 작성해주면 된다. UITableViewDataSource protocol 의 경우, 필수 구현 함수를 추가하지 않으면, 아래와 같은 에러가 발생한다. Fix 를 누르면 자동으로 추가해준다.

extension BountyViewController: UITableViewDataSource {
	
}

 

UITableViewDataSource

protocol UITableViewDataSource

💡 The methods adopted by the object you use to manage data and provide cells for a table view.

Table view data source object 는 해당 프로토콜을 채택한다. Table view 는 데이터 기반이고, 일반적으로 제공된 data source object 를 통해 데이터를 얻는다. data source object 는 앱의 데이터를 관리하고, table 의 cell 을 생성하고 관리할 책임을 갖는다. 

 

Data source object 의 책임은 다음과 같다. 

• table 의 section 과 row 의 개수를 알려주는 것
• table 의 각 row 에 cell 을 제공하는 것
• section header 와 footer 에 title 을 제공하는 것
• table 의 index 를 설정하는 것
• 기본 데이터를 변경해야 하는 user 또는 table 초기 업데이트에 응답하는 것

TableView 를 이용하기 위해서 필수로 구현해야 하는 method 가 있다. TableView 의 cell 이 몇개인지? Table view 를 어떻게 보여줄 것인지? 에 대한 질문이다. 해당 질문은 다음 method 를 구현함으로 답변할 수 있다.

 

1. tableView(_:numberOfRowsInSection:)

func tableView(_ tableView: UITableView, numberOfRowsInSection section: Int) -> Int

• 특정 section 에 표시할 row 의 개수를 묻는 method
• return 값으로 몇 개의 셀을 보여줄지에 대한 답변을 구현하면 된다. 
• section 에 따라 다른 셀의 개수를 반환하도록 구현할 수 있다. 

2. tableView(_:cellForRowAt:)

func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -> UITableViewCell 

• 특정 위치에 표시할 cell 을 요청하는 method
• cell 을 생성할 때, custom cell 을 재사용하려면 dequeueReusableCell(withIdentifier:for:) method 를 이용한다.
• cell 을 만든 후에, data 값들을 통해 cell 의 속성들을 업데이트할 수 있다.
• return 값으로 UITableViewCell 을 상속받은 object 를 반환해야 한다. (nil 반환시 에러 발생)

 

UITableViewDelegate

protocol UITableViewDelegate

💡Methods for managing selections, configuring section headers and footers, deleting and reordering cells, and performing other actions in a table view.

Table view delegate object는 해당 프로토콜을 채택한다. Table view 내에 클릭된 셀을 매니징하거나, 섹션의 header와 footer 설정, 셀을 삭제하거나 재졍럴하기 위해 이용한다.

 

해당 프로토콜의 method 들은 다음 기능들을 제공한다.

• custom header 와 footer view 를 만들고 관리하는 것
• row, header, footer 의 높이를 지정하는 것
• 더 나은 스크롤 지원을 위해 높이의 추정치를 제공하는 것
• row 의 들여쓰기 수준을 지정하는 것
• 선택된 row 에 대해 응답하는 것
• table row 를 스와이프하는 등 액션에 응답하는 것
• table content 를 편집할 수 있도록 지원하는 것

UITableViewDelegate 프로토콜은 필수 구현 method 가 없다. 다음은 주로 작성했던 method 이다.

 

tableView(_didSelectRowAt:) 

optional func tableView(_ tableView: UITableView, didSelectRowAt indexPath: IndexPath)

 

• delegate (대리인)에게 row가 선택되었음을 알려주는 함수. 
• 셀을 선택했을 때 어떻게 할지에 대해 구현할 수 있는 함수이다.
• 예시로, TableView 가 List page 이고 Detail page 가 있다면 해당 method 에서 performSegue 를 호출해 Detail page 로 넘어가는 코드를 작성할 수 있다.

extension ListViewController: UITableViewDelegate {

    func tableView(_ tableView: UITableView, didSelectRowAt indexPath: IndexPath) {
        print("--> \(indexPath.row)")
        performSegue(withIdentifier: "showDetail", sender: indexPath.row)
    }
}

---

공식 문서

• Apple Developer Documentation - UITableViewDataSource
• Apple Developer Documentation - UITableViewDelegate

참고 문서

• woonhyeong.tistory.com/6?category=827228 > Datasource, Delegate method 가 잘 정리되어 있다.