您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 程式開發 >> iOS 開發綜合

UITableViewCell 高度自適應:圖片與文字混排時的動態計算

編輯:iOS 開發綜合

用 UITableView 呈現「圖片 + 文字介紹」的卡片流時,最棘手的往往不是版面配置,而是cell 高度該怎麼算。文字長度不一、圖片比例不同,如果寫死高度,畫面就會出現大片空白或文字被裁切。

拆解問題

一個包含標題、圖片、內文的 cell,總高度其實就是各區塊高度相加再加上間距:

總高度 = 標題區高度 + 圖片高度 + 文字高度 + 間距 × 間距數量

其中標題與間距是固定值(用巨集定義),真正需要計算的是圖片與文字兩項。

實作程式碼

// 動態計算 cell 高度
+ (CGFloat)heightForRowWithModel:(PhotoInfo *)photoInfo
{
    // 1. 圖片高度:讓圖片等比例縮放後的高度
    UIImage *image = [UIImage imageWithContentsOfFile:
                      [[NSBundle mainBundle] pathForResource:@"ZZ" ofType:@"png"]];
    CGFloat imageHeight = [self heightForImage:image];

    // 2. 文字高度
    CGFloat textHeight = [self heightForText:photoInfo.introduction];

    // 3. 加總
    return kPhotoCell_TitleLabel_Height
         + imageHeight
         + textHeight
         + 4 * kPhotoCell_MarginBetween;
}

// 單獨計算圖片高度
+ (CGFloat)heightForImage:(UIImage *)image
{
    CGSize size = image.size;

    // 依 cell 寬度求出縮放比例,再換算高度
    CGFloat scale = kPhotoCell_Width / size.width;
    return size.height * scale;
}

// 單獨計算文字高度
+ (CGFloat)heightForText:(NSString *)text
{
    // 計算時必須指定字體,才能得出正確行高
    NSDictionary *attributes = @{ NSFontAttributeName : [UIFont systemFontOfSize:kFontSize] };

    return [text boundingRectWithSize:CGSizeMake(kPhotoCell_Width, 1000)
                              options:NSStringDrawingUsesLineFragmentOrigin
                                 | NSStringDrawingUsesFontLeading
                           attributes:attributes
                              context:nil].size.height;
}

程式碼中所有以 k 開頭的都是巨集定義的常數,例如 kPhotoCell_Width(cell 內容寬度)、kFontSize(字級)、kPhotoCell_MarginBetween(區塊間距)。

幾個關鍵細節

  • boundingRectWithSize 的第二個參數是「最大容許尺寸」:寬度必須與實際顯示寬度一致,高度給一個足夠大的值(如 1000 或 CGFLOAT_MAX)即可。
  • options 不可省略:NSStringDrawingUsesLineFragmentOrigin 讓系統允許換行;NSStringDrawingUsesFontLeading 影響行距計算。兩者都漏掉會算出偏小的值。
  • attributes 的字體必須與 cell 中 Label 完全一致:這是最常見的錯誤來源。若 Label 用 15pt,計算時卻寫 14pt,高度就會有落差。實務上會把字體抽成一個共用方法,兩邊都呼叫它。
  • 圖片等比例縮放:以寬度為基準計算 scale,能確保圖片在不同解析度的資源下都填滿寬度且不變形。

更省事的做法

從 iOS 7 開始,蘋果提供了自佔算高度(Self-Sizing Cells)機制,可以省掉上述所有手動計算:

// 1. 告訴 tableView 使用自適應
tableView.rowHeight = UITableViewAutomaticDimension;
tableView.estimatedRowHeight = 100;   // 預估值,影響捲動流順度

// 2. 在 cell 中,讓 Auto Layout 約束完整
//    從最上方元素約束到 contentView.top,
//    最下方元素約束到 contentView.bottom,
//    且我不要寫死 cell 的高度約束

此方式的關鍵在於約束鏈必須完整且無斷點——由上到下每一層都要有垂直約束串起來,系統才能推出內容高度。IM 聊天視窗、社群動態流這類內容長度差異大的場景,自適應是首選。

效能提醒

高度計算如果放在 heightForRowAtIndexPath: 中每次都重算,在長列表上會明顯卡頓。常見的優化是:

  • 快取結果:以 model 或 indexPath 為 key 存起算好的高度,資料沒變就直接取用。
  • 預先計算:在資料載入完成時一次算完,寫回 model 的 rowHeight 屬性。
  • 避免在高度計算中做 I/O:像範例中讀取圖片檔這類操作,應該在資料準備階段就完成並快取 image 物件。

掌握「固定區塊 + 圖片比例 + 文字 boundingRect」這三個要素,任何混排 cell 的高度都能算準;若使用自適應,則把力氣花在把約束寫對上,效果會更好也更少出錯。

  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved