您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 訊息 >> iOS 相關資訊

iOS MKMapView 自訂 CalloutView 的實作思路

編輯:iOS 相關資訊

地圖上標記位置的那個 view 叫 marker(或 pin),點下去後彈出的那個叫 CalloutView。系統預設樣式很樸素,要換成自訂版面,得先理解這兩者其實都是 annotation。

一、先釐清概念

一個 annotation 對應一個 view。系統幫你管的情況是:annotation 對應 MKPinAnnotationView(marker),點擊後彈出的資訊框則由同一個 view 的 leftCalloutAccessoryView 等屬性或預設樣式產生,而這個預設框幾乎無法客製。

因此自訂的思路是:把 callout 也當成一個獨立的 annotation 來處理。做法是定義兩個 annotation 類別——CustomPinAnnotation 代表地上的圖釘,CustomCalloutAnnotation 代表彈出的資訊框。圖釘沿用系統樣式就好,通常只要換一張圖;資訊框則完全自繪成 CustomCalloutView。

二、實作流程

1. 呼叫 addAnnotation: 加入一個 CustomPinAnnotation。系統會回呼 delegate 的 viewForAnnotation:,你在這裡回傳一個 MKPinAnnotationView(記得設定 canShowCallout = NO,否則系統預設框會跟自訂框打架)。

2. 使用者點擊圖釘,系統呼叫 didSelectAnnotationView:。你在這個方法裡 addAnnotation: 一個 CustomCalloutAnnotation,座標設為圖釘位置。

3. 這次 add 又會觸發 viewForAnnotation:。這回你判斷型別,回傳自製的 CustomCalloutView 即可。

4. 使用者點到別處或地圖移動時,記得把 callout annotation 移除,避免殘留。

三、幾個實作細節

在 viewForAnnotation: 中做型別分流是關鍵:

- (MKAnnotationView *)mapView:(MKMapView *)mapView
             viewForAnnotation:(id<MKAnnotation>)annotation {
    if ([annotation isKindOfClass:[CustomCalloutAnnotation class]]) {
        // 回傳自訂的 callout view
        CustomCalloutView *callout = [[CustomCalloutView alloc] initWithAnnotation:annotation
                                                                     reuseIdentifier:@"Callout"];
        callout.canShowCallout = NO;
        return callout;
    }
    // 一般圖釘
    MKPinAnnotationView *pin = [[MKPinAnnotationView alloc] initWithAnnotation:annotation
                                                                reuseIdentifier:@"Pin"];
    pin.image = [UIImage imageNamed:@"pin.png"];
    pin.canShowCallout = NO;    // 關掉系統預設框
    return pin;
}

自訂 view 通常要在其中擺放圖片與文字標籤,並在 initWithAnnotation: 時把 annotation 的 title、subtitle 等值取出來 assign 給子視圖。另外別忘了實作 prepareForReuse 之外的 reuse 邏輯,因為 MKMapView 會重用 view,未清空的舊內容會殘留。

若需要「氣泡尾巴」指向圖釘的視覺效果,可以用 Core Graphics 畫一個帶尖角的三角形,或者直接把氣泡底圖做成九宮格切圖再拼上。

四、效果

五、更簡潔的替代方案

上面這套「用兩個 annotation 疊出 callout」的技巧,是在 iOS 9 之前常見的解法,因為當時系統幾乎不給客製空間。iOS 9 之後,蘋果為 MKAnnotationView 加入了 detailCalloutAccessoryView,可以直接塞入任何 UIView 作為資訊框內容;配合 leftCalloutAccessoryView 與 rightCalloutAccessoryView,多數「自訂彈出內容」的需求都能在不離開系統 callout 的前提下完成,動畫、箭頭指向、點擊外部關閉等行為都由系統處理。

因此現在的建議順序是:先看 detailCalloutAccessoryView 能否滿足需求(多數情況可以);確實需要完全自繪時,再考慮上述的雙 annotation 做法,或改用第三方地圖函式庫。無論走哪條路,「annotation 對應 view、view 由 delegate 提供」這個基本模型都沒有改變,先理解它,之後實作任何變形都不會迷路。

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