🚨 UITableView 이슈 모음

테이블 뷰에서 사소하면서도 흔히 발생할 수 있는 이슈들을 모아보았습니다.

1. Optional error가 발생한다면?

Thread 1: Fatal error: Unexpectedly found nil while unwrapping an Optional value

• 옵셔널 에러가 났다면 identifier 오타가 났는지 확인해 봅시다.
• identifier 오타로 해당 셀을 찾지 못했는데, 옵셔널을 강제로 벗겼을 때 나는 이슈입니다.

extension UITableViewCell {
    static var identifier: String {
        String(describing: self)
    }
}

• 이러한 휴먼에러를 줄이기 위해 identifier를 아예 타입 속성으로 만드시는걸 추천드립니다.

2. Cell이 안보인다면?

let list = ["프로젝트", "쇼핑", "메인 업무", "과제"]

// 셀의 개수
override func tableView(_ tableView: UITableView, numberOfRowsInSection section: Int) -> Int {
    return 3
}

• 배열에 내용을 추가했는데 안보인다면 numberOfRowsInSection 부분을 살펴봅시다.
• 데이터 개수와 셀의 개수를 꼭 맞춰줘야 합니다.
  • 데이터 개수 > 셀 개수 → 셀 개수 만큼만 나옵니다.
  • 데이터 개수 < 셀 개수 → 인덱스 에러가 납니다.

3. Index out of range 인덱스 에러가 난다면?

let list = ["프로젝트", "쇼핑", "메인 업무"]

// 셀의 개수
override func tableView(_ tableView: UITableView, numberOfRowsInSection section: Int) -> Int {
    return 4
}

• 마찬가지로 numberOfRowsInSection 메서드 부분을 확인해봅시다.
• 셀 개수 만큼 반복하는데 배열 개수가 적다? → list[3]은 존재하지 않으므로 인덱스 에러가 납니다.

override func tableView(_ tableView: UITableView, numberOfRowsInSection section: Int) -> Int {
    return list.count
}

• 그래서 보통 list.count 로 써주는 편입니다.
• 만약 필터링을 하거나 배열 범위를 줄여야 하는 경우, 조건 처리를 해주시거나 원본 배열을 건드리지 않는 방향으로 해주셔야 합니다.
  
  
  

4. 테이블 뷰에 데이터가 반영이 안된다면?

tableView.reloadData()

• 이 reloadData()를 빠트린건 아닌지 확인해봅시다.
• 뷰와 데이터는 따로 놀기 때문에 데이터가 변경될 때마다 다시 갱신시켜줘야 합니다.
• 테이블의 모든 데이터를 다 갱신시켜주는게 reloadData()입니다.
  • 테이블 뷰의 스와이프 애니메이션까지 없애버릴 수 있으니 그럴땐 한 줄만 리로드 해주는 reloadRows를 사용해봅시다.

5. 테이블 Cell의 높이가 동적으로 변하지 않는다면?

Cell에 Label이 있고 이 Label의 텍스트 양이 자유롭게 줄어들고 늘어난다면, Cell 높이 역시 동적으로 변해야지 Label이 잘리지 않을 겁니다. 그런데 변하지 않는다면?

5-1. rowHeight를 automaticDimension으로 설정

tableView.rowHeight = UITableView.automaticDimension

• 먼저 높이를 UITableView.automaticDimension로 설정하셔야 합니다.

5-2. numberOfLines를 0으로 설정

cell.textLabel?.numberOfLines = 0

• Label의 numberOfLines를 0으로 설정하셨는지 확인해봅시다.
• numberOfLines는 Label의 줄 수를 설정할 수 있는 속성인데, 0으로 한다는건 텍스트를 무한으로 다 보여주겠다는 의미입니다.
• 이걸 설정 안하면 default가 1이니 1줄만 보여주게 됩니다.
• 0으로 바꿔줘야 줄 수 만큼 동적으로 높이가 바뀔 수 있습니다.

5-3. Cell 오토레이아웃 설정

• 높이가 늘어나는 곳에 height을 고정하면 안됩니다.
• 그곳을 제외하고 나머지는 여백과 높이를 고정시켜야합니다.
  • 텍스트필드도 폰트 크기를 고려해서 높이 고정시키는게 오류가 적은 편입니다.

5-4. 최소 높이 설정

• 만약 최소 높이는 고정시켜야 한다면 오토레이아웃 높이 설정 편집하는 부분에서 부등호로 >= 이상으로 설정해줍시다.

6. 데이터 삭제가 안된다?

• 혹시 데이터를 지우지 않고 deleteRows 메서드만 사용하셨나요? 이 메서드는 단순히 뷰를 변경해줄 뿐, 실제 데이터에는 영향을 주지 않습니다.
• 실제 데이터를 remove해주시고 deleteRows를 사용해봅시다.

6-1. 데이터도 지우고 deleteRows했더니 에러나고 이상해요

• 셀 데이터를 지웠지만 다른 정보(버튼의 tag 등)는 그대로라서 그럴 수 있습니다.
• reloadData, reloadRows, reloadSections을 사용해서 정보들을 업데이트해주세요.

7. 그냥 셀이 이상하게 나와요(?)

의도한 것	실제로 나온 것

셀이 1000개 있다고 진짜로 셀 1000개를 만들 수는 없습니다.

• 메모리를 보다 효율적으로 사용하고, 자연스러운 스크롤을 위해서 TableView, CollectionView에 도입된 개념이 재사용 메커니즘입니다.
• 컨베이어 벨트마냥 1000개 중 10개 정도만 만들어서 돌려쓰는 것인데요, 이 과정에서 이전의 데이터가 남아있을 수 있습니다.
• 그래서 애초에 셀을 만드는 cellForRowAt 부분에서 조건 처리를 100% 해주셔야 합니다.