Flutter WebView 外部链接跳转浏览器或独立窗口的实现
Flutter WebView 域名区分与外部链接处理实现
基于你现有基础代码的逻辑,核心通过WebView导航拦截机制判断URL域名,再分别处理内外链接,以下为完整可落地的实现步骤:
依赖配置
首先在pubspec.yaml的dependencies中添加对应依赖:
- 核心WebView组件:
webview_flutter: ^4.7.0(需升级至4.0以上版本,旧版回调逻辑有差异) - 若需要跳转系统浏览器,额外引入:
url_launcher: ^6.2.5
核心域名判断逻辑
先实现公共的内外链接判断方法,可放在状态类内部作为私有方法:
/// 判断是否为website.com站点的内部链接 bool _isInternalUrl(String url) { final Uri? parsedUri = Uri.tryParse(url); // 空链接或无合法协议默认按外部链接处理 if (parsedUri == null || !parsedUri.hasScheme) return false; // 规则调整说明:如需严格仅匹配主域,仅保留 `parsedUri.host == 'website.com'` 一行即可 // 下方规则同时允许所有子域名(如m.website.com、admin.website.com) return parsedUri.host == 'website.com' || parsedUri.host.endsWith('.website.com'); }
两种外部链接处理方案
两种方案可根据业务需求二选一,也可结合使用(如指定类别的外部链接用弹窗,其余跳浏览器):
方案1:外部链接跳转至系统浏览器
拦截到外部链接后调用系统浏览器打开,同时阻止WebView自身加载该链接,完整代码如下:
import 'package:flutter/material.dart'; import 'package:webview_flutter/webview_flutter.dart'; import 'package:url_launcher/url_launcher.dart'; class Forum extends StatefulWidget { @override _ForumState createState() => _ForumState(); } class _ForumState extends State<Forum> { late final WebViewController _mainWebViewController; @override void initState() { super.initState(); // 初始化主WebView控制器 _mainWebViewController = WebViewController() ..setJavaScriptMode(JavaScriptMode.unrestricted) // 配置导航拦截逻辑 ..setNavigationDelegate( NavigationDelegate( onNavigationRequest: (NavigationRequest request) { String targetUrl = request.url; // 内部链接直接允许WebView加载 if (_isInternalUrl(targetUrl)) { return NavigationDecision.navigate; } // 外部链接触发系统浏览器跳转 _launchExternalUrlToSystem(targetUrl); return NavigationDecision.prevent; }, ), ) // 加载站点首页 ..loadRequest(Uri.parse("https://website.com")); } /// 跳转系统浏览器 Future<void> _launchExternalUrlToSystem(String url) async { final Uri targetUri = Uri.parse(url); if (!await launchUrl(targetUri, mode: LaunchMode.externalApplication)) { // 跳转失败时给出提示 ScaffoldMessenger.of(context).showSnackBar( const SnackBar(content: Text("无法打开该链接")) ); } } bool _isInternalUrl(String url) { final Uri? parsedUri = Uri.tryParse(url); if (parsedUri == null || !parsedUri.hasScheme) return false; return parsedUri.host == 'website.com' || parsedUri.host.endsWith('.website.com'); } @override Widget build(BuildContext context) { return MaterialApp( debugShowCheckedModeBanner: false, title: 'Forum', home: Scaffold( body: WebViewWidget(controller: _mainWebViewController), ), ); } }
方案2:外部链接独立弹窗WebView打开(类Instagram交互)
拦截到外部链接后弹出模态窗口,窗口内嵌套独立WebView加载外部链接,无需跳转系统浏览器,仅需替换上述方案中_launchExternalUrlToSystem方法为弹窗逻辑即可,改动代码如下:
/// 弹出WebView弹窗加载外部链接 void _showExternalUrlBottomSheet(String url) { // 弹窗内子WebView控制器,可后续绑定刷新、返回逻辑 late final WebViewController _subWebViewController; showModalBottomSheet( context: context, isScrollControlled: true, // 允许自定义弹窗高度 backgroundColor: Colors.white, shape: const RoundedRectangleBorder( borderRadius: BorderRadius.vertical(top: Radius.circular(16)) ), builder: (context) { // 初始化子WebView控制器 _subWebViewController = WebViewController() ..setJavaScriptMode(JavaScriptMode.unrestricted) ..loadRequest(Uri.parse(url)); return SizedBox( // 弹窗高度设为屏幕的90%,可根据需求调整 height: MediaQuery.of(context).size.height * 0.9, child: Column( children: [ // 弹窗顶部栏,可自定义样式 Container( padding: const EdgeInsets.symmetric(horizontal: 12, vertical: 8), child: Row( mainAxisAlignment: MainAxisAlignment.spaceBetween, children: [ IconButton( icon: const Icon(Icons.close), onPressed: () => Navigator.pop(context), ), IconButton( icon: const Icon(Icons.refresh), onPressed: () => _subWebViewController.reload(), ) ], ), ), // 子WebView加载外部链接 Expanded( child: WebViewWidget(controller: _subWebViewController), ) ], ), ); } ); }
同时将onNavigationRequest中的外部链接处理改为调用_showExternalUrlBottomSheet(targetUrl)即可。
注意事项
- 域名规则可灵活调整:如需匹配更复杂的域名规则,直接修改
_isInternalUrl的判断逻辑即可。 - 非HTTPS链接适配:安卓端如果需要加载明文HTTP链接,需在
android/app/src/main/AndroidManifest.xml的<application>标签中添加android:usesCleartextTraffic="true"。 - 返回键适配:若使用弹窗WebView,可给子WebView添加返回监听,优先返回上一页,到浏览历史最后一页再关闭弹窗,优化交互体验。
- 跳转模式调整:
launchUrl的mode参数可切换为LaunchMode.inAppBrowserView,使用应用内浏览器标签打开,替代系统浏览器跳转。
内容的提问来源于stack exchange,提问作者Akif Akkaya
相关产品推荐
相关产品推荐

