Swift UITableView 完全指南 – 2025 最新的 UITableViewDataSource 實作教程

在iOS開發中，`UITableView`是一個非常重要的元件，能夠讓開發者快速建立表格式介面，使用者可以輕鬆查看資料。為了有效地使用`UITableView`，開發者必須了解`UITableViewDataSource`協定，這是控制`UITableView`資料來源和`UITableViewCell`顯示方式的關鍵。

什麼是 UITableViewDataSource？

`UITableViewDataSource`是一個協定，定義了`UITableView`需要實作的方法，以正確顯示資料。實作此協定後，開發者可以控制表格的行數和每個行的內容。

開始使用 UITableView

首先，您需要建立一個`UITableView`的實例並設定其資料來源。以下是如何進行的步驟：

let tableView = UITableView()
tableView.dataSource = self

接著，您需要遵循`UITableViewDataSource`協定並實作必要的方法：

extension YourViewController: UITableViewDataSource {
    func numberOfSections(in tableView: UITableView) -> Int {
        // 回傳要顯示的section數量
        return 1
    }

    func tableView(_ tableView: UITableView, numberOfRowsInSection section: Int) -> Int {
        // 回傳每個section要顯示的row數量
        return 10
    }

    func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -> UITableViewCell {
        // 回傳每個cell要顯示的內容
        let cell = tableView.dequeueReusableCell(withIdentifier: "Cell", for: indexPath)
        cell.textLabel?.text = "Cell \(indexPath.row)"
        return cell
    }
}

在這段程式碼中：
– 我們實作了`numberOfSections(in:)`方法，回傳要顯示的section數量。
– 接著是`tableView(_:numberOfRowsInSection:)`方法，這裡回傳每個section中的row數量。
– 最後，`tableView(_:cellForRowAt:)`方法用來配置每個cell的內容。

錯誤排除

如果您在實作時遇到問題，檢查以下幾點：
– 確保您的`UITableView`的dataSource正確設定為當前的視圖控制器。
– 確認cell的重用識別符（reuse identifier）與您在`dequeueReusableCell`中使用的一致。
– 檢查`UITableView`是否有連接至Interface Builder（如果您使用的是Storyboard）。

延伸應用

`UITableView`不僅可以顯示靜態資料，還可以與動態資料來源結合使用，例如從網路API獲取資料。您可以考慮使用`URLSession`來獲取JSON數據，然後將其解析並顯示在`UITableView`中。

結語

`UITableView`和`UITableViewDataSource`是iOS開發中不可或缺的部分。透過本篇教程，您應該能夠掌握如何使用這些工具來建立高效的表格界面。

Swift UITableView - 應用基本的UITableViewDataSource 👌

Q&A（常見問題解答）

1. UITableView 和 UICollectionView 有什麼不同？

UITableView 是用於顯示一維列表的，而 UICollectionView 則用於顯示二維網格佈局，提供更多的佈局選擇。

2. 如何在 UITableView 中添加刪除功能？

您可以在 UITableViewDataSource 中實作 tableView(_:commit:forRowAt:) 方法，處理刪除邏輯。

3. 可以有多個 Section 嗎？

是的，您可以在 numberOfSections(in:) 方法中返回多個 section，並在 tableView(_:numberOfRowsInSection:) 方法中為每個 section 提供不同的 row 數量。

—

Categorized in:

iOSswift

Tagged in:

,