常见的使用方法和功能
- 前进和后退：
webView.goBack() // 后退
webView.goForward() // 前进
- 刷新页面：
webView.reload()
- 监听页面加载事件：
extension ViewController: WKNavigationDelegate {
func webView(_ webView: WKWebView, didFinish navigation: WKNavigation!) {
print("页面加载完成")
}
}
- 在 WebView 中执行 JavaScript：
webView.evaluateJavaScript("document.getElementById('myElement').innerHTML") { (result, error) in
if let html = result as? String {
print(html)
}
}
- 在 WebView 中注入自定义 JavaScript：
let script = WKUserScript(source: "alert('Hello world!');", injectionTime: .atDocumentEnd, forMainFrameOnly: true)
let userContentController = webView.configuration.userContentController
userContentController.addUserScript(script)
- 与 WebView 进行交互：
使用WKUserContentController对象处理WebView和JavaScript之间的消息交互。首先，为WKWebViewConfiguration实例创建一个userContentController对象，然后通过add方法添加消息处理器。
let userContentController = webView.configuration.userContentController
userContentController.add(self, name: "myMessageHandler")
然后，在 JavaScript 中，使用 window.webkit.messageHandlers.myMessageHandler.postMessage() 将消息发送到 WebView。
- 清除缓存：
let websiteDataTypes = NSSet(array: [WKWebsiteDataTypeDiskCache, WKWebsiteDataTypeMemoryCache])
let date = Date(timeIntervalSince1970: 0)
WKWebsiteDataStore.default().removeData(ofTypes: websiteDataTypes as! Set<String>, modifiedSince: date) {
print("缓存已清除")
}
- 在 WebView 中注入自定义 JavaScript：
let script = WKUserScript(source: "alert('Hello world!');", injectionTime: .atDocumentEnd, forMainFrameOnly: true)
let userContentController = webView.configuration.userContentController
userContentController.addUserScript(script)
WKWebViewConfiguration 使用方法和功能
WKWebViewConfiguration 是用于配置 WKWebView 的类。它可以用于控制如何显示 WebView 中的内容、JavaScript 的交互、缓存和 Cookie 管理等方面。下面是一些常用的 WKWebViewConfiguration 属性：
processPool: 使用WKProcessPool实例作为WebView进程池，多个WKWebView可以共享一个WKProcessPool实例，从而实现在同一进程中运行多个WebView。userContentController: 使用WKUserContentController实例来管理WebView中的JavaScript消息处理和用户脚本。preferences: 使用WKPreferences实例来控制WebView的偏好设置，例如JavaScript是否启用、内置字体是否可缩放、文本是否自动适应用户选择等。websiteDataStore: 使用WKWebsiteDataStore实例来管理WebView中的网站数据，例如缓存、Cookie、本地存储等。allowsInlineMediaPlayback: 布尔值，指定是否允许媒体以内联模式播放。mediaTypesRequiringUserActionForPlayback:WKAudiovisualMediaTypes枚举，指定哪些媒体类型需要用户手动触发播放。dataDetectorTypes:WKDataDetectorTypes枚举，指定 WebView 中自动检测链接的类型。
创建 WKWebViewConfiguration 实例：
let configuration = WKWebViewConfiguration()
配置偏好设置：
configuration.preferences.javaScriptEnabled = true // 启用 JavaScript
configuration.preferences.javaScriptCanOpenWindowsAutomatically = false // 禁止 JavaScript 自动打开窗口
configuration.preferences.minimumFontSize = 10 // 设置最小字体大小
配置用户交互控制：
configuration.userContentController.add(self, name: "myHandler") // 添加用户脚本消息处理程序
configuration.userContentController.addUserScript(myUserScript) // 添加用户脚本
配置 Web 视频播放行为：
configuration.allowsInlineMediaPlayback = true // 允许媒体以内联模式播放
configuration.mediaTypesRequiringUserActionForPlayback = .all // 设置媒体类型需要用户手动播放
配置网页内容预览行为：
configuration.dataDetectorTypes = [.phoneNumber, .link] // 启用电话号码和链接的数据检测
配置网页内容缩放行为：
configuration.userInterfaceStyle = .dark // 设置网页界面风格为暗黑模式
configuration.suppressesIncrementalRendering = false // 关闭增量渲染
配置其他属性：
configuration.websiteDataStore = WKWebsiteDataStore.default() // 使用默认的网站数据存储
configuration.applicationNameForUserAgent = "CustomApp/1.0" // 设置自定义的 User Agent 应用名称
实例
import UIKit
import WebKit
class ViewController: UIViewController, WKNavigationDelegate {
@IBOutlet weak var progressView: UIProgressView!
@IBOutlet weak var mainWebView: WKWebView!
@IBOutlet weak var webBackBtn: UIButton!
@IBOutlet weak var webForBtn: UIButton!
private var observation: NSKeyValueObservation? = nil
override func viewDidLoad() {
super.viewDidLoad()
mainWebView.configuration.allowsInlineMediaPlayback = true
mainWebView.configuration.mediaTypesRequiringUserActionForPlayback = .all
mainWebView.backgroundColor = .clear
mainWebView.isOpaque = false
mainWebView.uiDelegate = self
mainWebView.navigationDelegate = self
observation = mainWebView.observe(\.estimatedProgress, options: [.new]) { [weak self] _, _ in
guard let self = self else {return }
self.progressView.progress = Float(self.mainWebView.estimatedProgress)
}
// 加载包含视频的网页
if let url = URL(string: "https://www.example.com/video.html") {
let request = URLRequest(url: url)
mainWebView.load(request)
}
}
}
extension ViewController: WKNavigationDelegate, WKUIDelegate {
func webView(_ webView: WKWebView, didFailProvisionalNavigation navigation: WKNavigation!, withError error: Error) {
// 网页加载失败，隐藏进度条
progressView.isHidden = true
self.webForBtn.isEnabled = self.mainWebView.canGoForward
self.webBackBtn.isEnabled = self.mainWebView.canGoBack
}
func webView(_ webView: WKWebView, didStartProvisionalNavigation navigation: WKNavigation!) {
// 网页开始加载，显示进度条
progressView.isHidden = false
progressView.setProgress(0.08, animated: false)
}
func webView(_ webView: WKWebView, didCommit navigation: WKNavigation!) {
// 网页内容开始返回，更新进度条
progressView.setProgress(0.12, animated: true)
}
func webView(_ webView: WKWebView, didFail navigation: WKNavigation!, withError error: Error) {
// 网页加载失败，隐藏进度条
progressView.isHidden = true
self.webForBtn.isEnabled = self.mainWebView.canGoForward
self.webBackBtn.isEnabled = self.mainWebView.canGoBack
}
func webViewWebContentProcessDidTerminate(_ webView: WKWebView) {
// 网页进程终止，隐藏进度条
progressView.isHidden = true
self.webForBtn.isEnabled = self.mainWebView.canGoForward
self.webBackBtn.isEnabled = self.mainWebView.canGoBack
}
func webView(_ webView: WKWebView, didFinish navigation: WKNavigation!) {
// 网页加载完毕，更新进度条
progressView.setProgress(1.0, animated: true)
DispatchQueue.main.asyncAfter(deadline: .now() + 1) {
self.progressView.isHidden = true
}
self.webForBtn.isEnabled = self.mainWebView.canGoForward
self.webBackBtn.isEnabled = self.mainWebView.canGoBack
}
}
扩展
WKAudiovisualMediaTypes 枚举是用于配置在 WKWebView 中播放媒体时需要用户手动操作的类型。
以下是该枚举的成员以及对应的解释：
没有指定媒体类型，即不需要用户手动操作。
WKAudiovisualMediaTypeNone：
音频类型媒体，包括音乐、声音等，需要用户手动操作才能播放。
WKAudiovisualMediaTypeAudio：
视频类型媒体，包括视频文件、网络视频等，需要用户手动操作才能播放。
WKAudiovisualMediaTypeVideo：
所有类型的媒体都需要用户手动操作才能播放。
WKAudiovisualMediaTypeAll：
这些成员可以用于配置在 WKWebView 中触发媒体播放时用户的交互行为。
通过选择不同的成员，你可以控制在 WebView 中播放不同类型媒体时用户是否需要手动操作。
WKDataDetectorTypes 枚举是用于配置 WKWebView 中数据检测类型的枚举。
它定义了一些常见的数据类型，以便在 WebView 中对这些数据进行自动检测和处理。
以下是该枚举的成员以及对应的解释：
电话号码类型的数据，包括电话号码、拨号链接等。
WKDataDetectorTypePhoneNumber：
链接类型的数据，包括网页链接、URL 等。
WKDataDetectorTypeLink：
地址类型的数据，包括邮寄地址、地图位置等。
WKDataDetectorTypeAddress：
日历事件类型的数据，例如日期、时间等。
WKDataDetectorTypeCalendarEvent：
跟踪号类型的数据，例如快递单号。
WKDataDetectorTypeTrackingNumber：
航班号类型的数据，用于识别航班号码。
WKDataDetectorTypeFlightNumber：
查询建议类型的数据，用于识别查询建议。
WKDataDetectorTypeLookupSuggestion：
不检测任何数据类型。
WKDataDetectorTypeNone：
检测所有支持的数据类型。
WKDataDetectorTypeAll：
通过使用这些成员，你可以为 WKWebView 指定需要自动检测和处理的数据类型，以提供更好的用户体验。
例如，如果你启用了电话号码和链接的数据检测，在 WebView 中展示的电话号码和链接将会自动可点击并触发相应操作。
