用途:在 SwiftUI 应用中嵌入和管理网页内容,使用 iOS 26、iPadOS 26、macOS 26、visionOS 26 引入的原生 WebKit-for-SwiftUI API。适用于需要内嵌网页界面、应用自有 HTML 内容、JavaScript 交互或自定义导航策略的场景。
主要能力:仅渲染 URL 时用 WebView(url:);需要加载请求、观察状态、调用 JavaScript 或控制导航时用 WebPage。WebPage 是 @MainActor 可观察类型,支持 load(URLRequest)、load(URL)、load(html:baseURL:) 等加载入口,提供 title、url、isLoading、estimatedProgress、currentNavigationEvent、backForwardList 等属性,可用 page.navigations 异步序列观察导航事件。通过 WebPage.NavigationDeciding 实现允许、取消或改写导航,例如保留自有域、将外链交给 openURL。用 callJavaScript(_:arguments:in:contentWorld:) 执行脚本,传函数体而非完整声明,Swift 值经 arguments 传入。可用 WebPage.Configuration 与 URLSchemeHandler 加载本地或自定义 scheme 内容。WebView 修饰符包括返回/前进手势、页内查找、滚动位置同步等。
使用方式:一个 WebPage 同时只能关联一个 WebView,多个可见网页需分别创建实例。
限制:内嵌 WebView 不应用于 OAuth,认证应使用 ASWebAuthenticationSession;callJavaScript 不能直接替代 WKScriptMessageHandler;低于 iOS 26 或需旧版 WebKit 特性时回退 WKWebView;macOS/visionOS 的跳出浏览用默认浏览器/openURL,而非 SFSafariViewController。具体版本与迁移细节暂未提供。