快速开始

通用 API 主要由四个类组成：

WebViewController：控制 WebView。
WebViewWidget：显示 WebView。
NavigationDelegate：接收导航事件。
WebViewCookieManager：管理 WebView cookie。

基础用法

import 'package:flutter/material.dart';
import 'package:webview_all/webview_all.dart';

class BrowserPage extends StatefulWidget {
  const BrowserPage({super.key});

  @override
  State<BrowserPage> createState() => _BrowserPageState();
}

class _BrowserPageState extends State<BrowserPage> {
  late final WebViewController controller;

  @override
  void initState() {
    super.initState();
    controller = WebViewController()
      ..setJavaScriptMode(JavaScriptMode.unrestricted)
      ..setNavigationDelegate(
        NavigationDelegate(
          onPageStarted: (url) => debugPrint('Started $url'),
          onPageFinished: (url) => debugPrint('Finished $url'),
          onWebResourceError: (error) {
            debugPrint('WebView error: ${error.description}');
          },
        ),
      )
      ..loadRequest(Uri.parse('https://flutter.dev'));
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: const Text('Browser')),
      body: WebViewWidget(controller: controller),
    );
  }
}

导航控制

if (await controller.canGoBack()) {
  await controller.goBack();
}

if (await controller.canGoForward()) {
  await controller.goForward();
}

await controller.reload();

加载 HTML

await controller.loadHtmlString(
  '<html><body><h1>Hello</h1></body></html>',
  baseUrl: 'https://example.com/docs/',
);

JavaScript Channel

await controller.addJavaScriptChannel(
  'AppBridge',
  onMessageReceived: (JavaScriptMessage message) {
    debugPrint('Message from page: ${message.message}');
  },
);

await controller.runJavaScript('AppBridge.postMessage("ready")');

Web 平台上，JavaScript 执行和 channel 注入只能用于同源 iframe 内容，或由 loadHtmlString / fetch-backed loadRequest 加载的可访问内容。

使用平台实现

if (controller.platform is WindowsWebViewController) {
  final windows = controller.platform as WindowsWebViewController;
  await windows.openDevTools();
}

构造时需要平台参数时：

PlatformWebViewControllerCreationParams params =
    const PlatformWebViewControllerCreationParams();

if (WebViewPlatform.instance is WebKitWebViewPlatform) {
  params = WebKitWebViewControllerCreationParams(
    allowsInlineMediaPlayback: true,
    mediaTypesRequiringUserAction: const <PlaybackMediaTypes>{},
  );
}

final controller = WebViewController.fromPlatformCreationParams(params);