Swift UITableView 使用完全手冊:2025 最新教學與最佳實踐

UITableView 是 iOS 開發中最常用的元件之一,能夠讓開發者輕鬆地建立列表,讓使用者更便捷地閱讀與操作。在 Swift 中,使用 UITableView 也非常簡單。接下來,我們將深入探討如何在 Swift 中有效地使用 UITableView,並提供完整的實作範例與最佳實踐。

首先,您需要在 Xcode 專案中加入 UITableView,可在 Storyboard 的 Object Library 中找到,如下圖所示:

UITableView

步驟 1:設置 UITableView

在您的 ViewController 中,添加 UITableViewDelegateUITableViewDataSource 協議,並建立 UITableView 的屬性:

class ViewController: UIViewController, UITableViewDelegate, UITableViewDataSource {
    @IBOutlet weak var tableView: UITableView!
}

步驟 2:實作必需的方法

接下來,您需要實作 UITableViewDelegateUITableViewDataSource 的必要方法:

func tableView(_ tableView: UITableView, numberOfRowsInSection section: Int) -> Int {
    return 10 // 返回行數
}

func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -> UITableViewCell {
    let cell = tableView.dequeueReusableCell(withIdentifier: "Cell", for: indexPath)
    cell.textLabel?.text = "Row \(indexPath.row)" // 設定單元格顯示內容
    return cell
}

步驟 3:在 viewDidLoad 中設置 delegate 和 dataSource

最後,在 ViewController 的 viewDidLoad 方法中,將 UITableViewDelegate 和 UITableViewDataSource 設定給 UITableView:

override func viewDidLoad() {
    super.viewDidLoad()
    tableView.delegate = self
    tableView.dataSource = self
}

錯誤排除

如果在運行時遇到問題,請檢查以下幾點:

  • 確保您已經在 Storyboard 中設定 UITableView 的 Identifier 為 “Cell”。
  • 確認 UITableView 的 delegate 和 dataSource 被正確設置。
  • 檢查是否有連接 IBOutlet,否則可能會導致崩潰。

延伸應用

您可以進一步擴展 UITableView 的功能,例如:

  • 實作編輯模式,允許使用者刪除或重新排序行。
  • 自定義 UITableViewCell,以實現更豐富的內容顯示。
  • 使用 JSON 數據動態填充 UITableView,以提高靈活性。

以上就是在 Swift 中使用 UITableView 的完整步驟與最佳實踐,您可以依照這些步驟來建立一個功能完整的 UITableView。

Swift UITableView 第一次使用 教學 📚

Q&A(常見問題解答)

1. UITableView 和 UICollectionView 有什麼不同?

UITableView 用於顯示垂直列表,而 UICollectionView 則可用於顯示多維佈局,適用於更複雜的 UI。

2. 如何在 UITableView 中顯示圖片?

您只需在 cellForRowAt 方法中設置 UIImageView,並將其加入到 UITableViewCell 的內容視圖中即可。

3. UITableView 如何支持無限滾動?

您可以在 scrollViewDidScroll 方法中檢查滾動位置,當接近底部時加載更多數據。

Categorized in:

Tagged in:

,