通用接口

导入：

import 'package:xue_hua_webview/xue_hua_webview.dart';

WebViewController

构造函数：

构造函数	用途
WebViewController({onPermissionRequest})	使用通用参数创建 controller。
WebViewController.fromPlatformCreationParams(params, {onPermissionRequest})	使用平台创建参数。
WebViewController.fromPlatform(platform, {onPermissionRequest})	包装已有平台 controller。

加载：

方法	返回	说明
loadRequest	Future<void>	加载 URL 或 HTTP 请求。
loadFile	Future<void>	加载设备文件。
loadFlutterAsset	Future<void>	加载 Flutter asset。
loadHtmlString	Future<void>	加载内存 HTML。

导航：

方法	返回
currentUrl()	Future<String?>
canGoBack()	Future<bool>
canGoForward()	Future<bool>
goBack()	Future<void>
goForward()	Future<void>
reload()	Future<void>
setNavigationDelegate(delegate)	Future<void>

JavaScript：

方法	返回
setJavaScriptMode	Future<void>
runJavaScript	Future<void>
runJavaScriptReturningResult	Future<Object>
runJavaScriptAsync	Future<JavaScriptAsyncResult>
addUserScript / removeAllUserScripts	Future<void>
addJavaScriptChannel(String name, {required void Function(JavaScriptMessage) onMessageReceived})	Future<void>
removeJavaScriptChannel	Future<void>
setOnConsoleMessage	Future<void>
setOnJavaScriptAlertDialog	Future<void>
setOnJavaScriptConfirmDialog	Future<void>
setOnJavaScriptTextInputDialog	Future<void>

视图状态：

方法	返回
getTitle()	Future<String?>
scrollTo / scrollBy	Future<void>
getScrollPosition()	Future<Offset>
setOnScrollPositionChange	Future<void>
setVerticalScrollBarEnabled / setHorizontalScrollBarEnabled	Future<void>
supportsSetScrollBarsEnabled()	Future<bool>
enableZoom	Future<void>
setBackgroundColor	Future<void>
setUserAgent / getUserAgent	Future<void> / Future<String?>
setOverScrollMode	Future<void>
dispose()	Future<void>

NavigationDelegate

回调	作用
onNavigationRequest	允许或阻止导航。
onPageStarted	页面开始加载。
onPageFinished	页面加载完成。
onProgress	加载进度。
onWebResourceError	资源错误。
onUrlChange	URL 变化。
onHttpAuthRequest	HTTP 鉴权。
onHttpError	HTTP 状态错误。
onSslAuthError	可恢复 SSL 证书错误。

WebViewWidget

WebViewWidget 接收 WebViewController 并委托当前平台实现构建 native/Web 视图。

WebViewCookieManager

方法	返回	作用
clearCookies()	Future<bool>	清空 cookie。
setCookie(WebViewCookie cookie)	Future<void>	设置通用 cookie。
getCookies({required Uri domain})	Future<List<WebViewCookie>>	获取指定域名可见 cookie。

WebViewStorageManager

无需活 WebViewController 即可清理网站数据。removeData({dataTypes, since}) 可清理 cookie、HTTP cache 和 DOM storage。Web 仅限宿主 origin。

HeadlessWebView

不插入 WebViewWidget 也能加载页面、执行 JS 并接收回调。使用 run() / dispose() / isRunning，通过 controller 操作。

导出的接口类型

xue_hua_webview.dart 导出 LoadRequestMethod、NavigationDecision、NavigationRequest、WebResourceError、HttpResponseError、HttpAuthRequest、WebViewCredential、JavaScriptMode、JavaScriptMessage、JavaScriptConsoleMessage、JS dialog request、ScrollPositionChange、WebViewCookie、WebViewOverScrollMode、WebViewPermissionResourceType、WebViewPlatform、UserScript、UserScriptInjectionTime、JavaScriptAsyncResult 和 WebViewDataType 等类型。