WKWebView 是 iOS 中取代 UIWebView 的現代網頁元件。它效能更好、架構更完整,也支援更多現代 Web 能力。但從 UIWebView 遷移過來時,仍會遇到不少細節問題。
WKWebView 只能透過代碼建立,初始化時需要傳入 WKWebViewConfiguration。多數情況下使用預設設定即可,但若要讓網頁內嵌影片正常播放,記得調整 allowsInlineMediaPlayback。
WKWebView 本身也支援 estimatedProgress 與 allowsBackForwardNavigationGestures,讓載入進度與手勢返回更容易實作。
若需要自訂 User-Agent,可以透過 WKWebView 執行 JavaScript 取得預設值,再透過 NSUserDefaults 全域覆寫。若使用 iOS 9 以上,也可以直接設定 customUserAgent,避免影響全域請求。
WKWebView 常用代理包括:
若想於網頁內容下方附加原生 View,直接修改 scrollView 的 contentSize 或 contentInset 可能會失敗或影響點擊事件。較穩定的做法,是在網頁載入完成後,透過 JavaScript 動態插入一個空白 div,再把原生 View 放在對應位置。
若網頁使用正式憑證,通常可正常載入;若使用自建憑證,則需要處理 authentication challenge。WKNavigationDelegate 提供了更方便的認證方式,但部分舊系統可能存在相容性問題。
WKWebView 透過 addScriptMessageHandler 建立原生與網頁之間的橋梁。JavaScript 可呼叫 postMessage,原生端則會收到 WKScriptMessage,並從中取出 body 與 name。
原生要回傳資料給網頁時,通常透過 evaluateJavaScript 執行一段全域回呼函數。相較於舊式 UIWebView,WKWebView 的溝通方式更明確,但也需要更小心地設計介面與型別。
整體而言,WKWebView 更現代、更穩定,但遷移時仍需注意細節。理解這些差異,能大幅減少踩坑時間。