做項目的時候遇到了瀏覽網頁的需求,於是接觸到了 UIWebView 這個類。整體來看它的接口並不多,理解起來也不困難,這裡系統整理一遍。
UIWebView 繼承自 UIView,可以用它快速搭建一個網頁瀏覽容器。它的能力覆蓋了加載、導航、腳本執行等基礎場景。
delegate
@property(nonatomic, assign) id<UIWebViewDelegate> delegate;
代理對象,用於接收加載狀態等回調。
request
@property(nonatomic, readonly, retain) NSURLRequest *request;
當前頁面對應的 URL 請求。
loading
@property(nonatomic, readonly, getter=isLoading) BOOL loading;
當前網頁是否處於加載中。
canGoBack / canGoForward
@property(nonatomic, readonly, getter=canGoBack) BOOL canGoBack; @property(nonatomic, readonly, getter=canGoForward) BOOL canGoForward;
分別表示能否回退到上一頁、能否前進到下一頁。做瀏覽器時通常用它們來控制前後導航按鈕的可用狀態。
scalesPageToFit
@property(nonatomic) BOOL scalesPageToFit;
網頁內容是否自動縮放以適應屏幕寬度。
scrollView
@property(nonatomic, readonly, retain) UIScrollView *scrollView;
與該 web 視圖關聯的滾動視圖,可以藉此調整 zoomScale、contentInset 等。
suppressesIncrementalRendering
@property(nonatomic) BOOL suppressesIncrementalRendering;
是否等內容全部下載完成後才開始渲染,默認為 NO(即邊下載邊渲染)。
keyboardDisplayRequiresUserAction
@property(nonatomic) BOOL keyboardDisplayRequiresUserAction;
是否需要用戶主動操作才彈出鍵盤,默認 YES。若希望頁面加載後自動聚焦輸入框並彈出鍵盤,需設為 NO。
dataDetectorTypes
@property(nonatomic) UIDataDetectorTypes dataDetectorTypes;
enum {
UIDataDetectorTypePhoneNumber = 1 << 0,
UIDataDetectorTypeLink = 1 << 1,
UIDataDetectorTypeAddress = 1 << 2,
UIDataDetectorTypeCalendarEvent = 1 << 3,
UIDataDetectorTypeNone = 0,
UIDataDetectorTypeAll = NSUIntegerMax
};
把網頁中的純文本內容智能識別為可點擊的鏈接,例如電話號碼、地址、日期等。同樣是位掩碼,可以按需組合。
allowsInlineMediaPlayback
@property(nonatomic) BOOL allowsInlineMediaPlayback;
決定 HTML5 視頻是內嵌播放還是全屏播放。要實現內嵌,除了打開這個開關,HTML 中的 video 元素還必須帶上 webkit-playsinline 屬性。默認為 NO。
mediaPlaybackRequiresUserAction
@property(nonatomic) BOOL mediaPlaybackRequiresUserAction;
iPhone 與 iPad 上默認 YES,即視頻需要用戶點擊才能播放;設為 NO 則允許自動播放。
mediaPlaybackAllowsAirPlay
@property(nonatomic) BOOL mediaPlaybackAllowsAirPlay;
該頁面中的媒體是否允許使用 AirPlay,默認 YES。
- (void)loadRequest:(NSURLRequest *)request;
- (void)loadHTMLString:(NSString *)string baseURL:(NSURL *)baseURL;
- (void)loadData:(NSData *)data
MIMEType:(NSString *)MIMEType
textEncodingName:(NSString *)encodingName
baseURL:(NSURL *)baseURL;
- (void)stopLoading;
- (void)reload;
loadRequest: 加載網絡請求;loadHTMLString:baseURL: 直接渲染 HTML 字符串;loadData:MIMEType:textEncodingName:baseURL: 加載二進制數據並指定類型與編碼,適合呈現 PDF、Word 等文檔;stopLoading 中斷當前加載;reload 重新加載當前頁。
- (void)goBack; - (void)goForward;
配合前面的 canGoBack、canGoForward 使用即可實現瀏覽器的前後翻頁。
- (NSString *)stringByEvaluatingJavaScriptFromString:(NSString *)script;
返回腳本執行結果。有幾個限制需要了解:腳本執行時間上限為 10 秒,超時會被強制中止;JavaScript 的內存分配上限為 10MB,超出會導致頁面異常;此外腳本執行可能阻塞主線程,因此執行期間用戶的操作會被卡住,盡量避免在腳本裡做重活。
UIWebView 的接口總量不大,難點不在 API 本身,而在於細節:加載失敗的錯誤處理、進度條的顯示時機、與 JavaScript 的雙向通信、以及 iOS 12 之後蘋果已推薦遷移到 WKWebView。如果是新項目,建議直接從 WKWebView 起步 —— 它擁有獨立進程、更好的性能與更清晰的接口設計。
今天就到這裡 —— LC