[webview_flutter_wkwebview] Expose the allowsLinkPreview property in WKWebView for iOS

packages/webview_flutter/webview_flutter_wkwebview/CHANGELOG.md

@@ -1,3 +1,8 @@
+## 3.20.0
+
+* Adds support to disable a preview of the destination for a link. See
+  `WebKitWebViewController.setAllowsLinkPreview`.
+
 ## 3.19.0
 
 * Adds support to set the over-scroll mode for the WebView. See `WebKitWebViewController.setOverScrollMode`.

packages/webview_flutter/webview_flutter_wkwebview/darwin/Tests/WebViewProxyAPITests.swift

@@ -278,6 +278,18 @@ class WebViewProxyAPITests: XCTestCase {
     XCTAssertFalse(instance.isInspectable)
   }
 
+  @MainActor func testSetAllowsLinkPreview() {
+    let registrar = TestProxyApiRegistrar()
+    let api = webViewProxyAPI(forRegistrar: registrar)
+
+    let instance = TestViewWKWebView()
+    let allow: Bool = true
+    try? api.pigeonDelegate.setAllowsLinkPreview(
+      pigeonApi: api, pigeonInstance: instance, allow: allow)
+
+    XCTAssertEqual(instance.allowsLinkPreview, allow)
+  }
+
   @MainActor func testGetCustomUserAgent() {
     let registrar = TestProxyApiRegistrar()
     let api = webViewProxyAPI(forRegistrar: registrar)

packages/webview_flutter/webview_flutter_wkwebview/darwin/webview_flutter_wkwebview/Sources/webview_flutter_wkwebview/WebKitLibrary.g.swift

@@ -1,7 +1,7 @@
 // Copyright 2013 The Flutter Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
-// Autogenerated from Pigeon (v25.2.0), do not edit directly.
+// Autogenerated from Pigeon (v25.3.0), do not edit directly.
 // See also: https://pub.dev/packages/pigeon
 
 import Foundation
@@ -77,6 +77,7 @@ private func nilOrValue<T>(_ value: Any?) -> T? {
   if value is NSNull { return nil }
   return value as! T?
 }
+
 /// Handles the callback when an object is deallocated.
 protocol WebKitLibraryPigeonInternalFinalizerDelegate: AnyObject {
   /// Invoked when the strong reference of an object is deallocated in an `InstanceManager`.
@@ -4774,6 +4775,14 @@ protocol PigeonApiDelegateUIViewWKWebView {
     func getCustomUserAgent(pigeonApi: PigeonApiUIViewWKWebView, pigeonInstance: WKWebView) throws
       -> String?
   #endif
+  #if !os(macOS)
+    /// Whether to allow previews for link destinations and detected data such as
+    /// addresses and phone numbers.
+    ///
+    /// Defaults to true.
+    func setAllowsLinkPreview(
+      pigeonApi: PigeonApiUIViewWKWebView, pigeonInstance: WKWebView, allow: Bool) throws
+  #endif
 }
 
 protocol PigeonApiProtocolUIViewWKWebView {
@@ -5272,6 +5281,27 @@ final class PigeonApiUIViewWKWebView: PigeonApiProtocolUIViewWKWebView {
         getCustomUserAgentChannel.setMessageHandler(nil)
       }
     #endif
+    #if !os(macOS)
+      let setAllowsLinkPreviewChannel = FlutterBasicMessageChannel(
+        name: "dev.flutter.pigeon.webview_flutter_wkwebview.UIViewWKWebView.setAllowsLinkPreview",
+        binaryMessenger: binaryMessenger, codec: codec)
+      if let api = api {
+        setAllowsLinkPreviewChannel.setMessageHandler { message, reply in
+          let args = message as! [Any?]
+          let pigeonInstanceArg = args[0] as! WKWebView
+          let allowArg = args[1] as! Bool
+          do {
+            try api.pigeonDelegate.setAllowsLinkPreview(
+              pigeonApi: api, pigeonInstance: pigeonInstanceArg, allow: allowArg)
+            reply(wrapResult(nil))
+          } catch {
+            reply(wrapError(error))
+          }
+        }
+      } else {
+        setAllowsLinkPreviewChannel.setMessageHandler(nil)
+      }
+    #endif
   }
 
   #if !os(macOS)
@@ -5424,6 +5454,14 @@ protocol PigeonApiDelegateNSViewWKWebView {
     func getCustomUserAgent(pigeonApi: PigeonApiNSViewWKWebView, pigeonInstance: WKWebView) throws
       -> String?
   #endif
+  #if !os(iOS)
+    /// Whether to allow previews for link destinations and detected data such as
+    /// addresses and phone numbers.
+    ///
+    /// Defaults to true.
+    func setAllowsLinkPreview(
+      pigeonApi: PigeonApiNSViewWKWebView, pigeonInstance: WKWebView, allow: Bool) throws
+  #endif
 }
 
 protocol PigeonApiProtocolNSViewWKWebView {
@@ -5900,6 +5938,27 @@ final class PigeonApiNSViewWKWebView: PigeonApiProtocolNSViewWKWebView {
         getCustomUserAgentChannel.setMessageHandler(nil)
       }
     #endif
+    #if !os(iOS)
+      let setAllowsLinkPreviewChannel = FlutterBasicMessageChannel(
+        name: "dev.flutter.pigeon.webview_flutter_wkwebview.NSViewWKWebView.setAllowsLinkPreview",
+        binaryMessenger: binaryMessenger, codec: codec)
+      if let api = api {
+        setAllowsLinkPreviewChannel.setMessageHandler { message, reply in
+          let args = message as! [Any?]
+          let pigeonInstanceArg = args[0] as! WKWebView
+          let allowArg = args[1] as! Bool
+          do {
+            try api.pigeonDelegate.setAllowsLinkPreview(
+              pigeonApi: api, pigeonInstance: pigeonInstanceArg, allow: allowArg)
+            reply(wrapResult(nil))
+          } catch {
+            reply(wrapError(error))
+          }
+        }
+      } else {
+        setAllowsLinkPreviewChannel.setMessageHandler(nil)
+      }
+    #endif
   }
 
   #if !os(iOS)

packages/webview_flutter/webview_flutter_wkwebview/darwin/webview_flutter_wkwebview/Sources/webview_flutter_wkwebview/WebViewProxyAPIDelegate.swift

@@ -380,4 +380,17 @@ class WebViewProxyAPIDelegate: PigeonApiDelegateWKWebView, PigeonApiDelegateUIVi
     return try getCustomUserAgent(
       pigeonApi: getUIViewWKWebViewAPI(pigeonApi), pigeonInstance: pigeonInstance)
   }
+
+  func setAllowsLinkPreview(
+    pigeonApi: PigeonApiUIViewWKWebView, pigeonInstance: WKWebView, allow: Bool
+  ) throws {
+    pigeonInstance.allowsLinkPreview = allow
+  }
+
+  func setAllowsLinkPreview(
+    pigeonApi: PigeonApiNSViewWKWebView, pigeonInstance: WKWebView, allow: Bool
+  ) throws {
+    try setAllowsLinkPreview(
+      pigeonApi: getUIViewWKWebViewAPI(pigeonApi), pigeonInstance: pigeonInstance, allow: allow)
+  }
 }

packages/webview_flutter/webview_flutter_wkwebview/lib/src/common/platform_webview.dart

@@ -397,4 +397,20 @@ class PlatformWebView {
 
     throw UnimplementedError('${webView.runtimeType} is not supported.');
   }
+
+  /// Whether to allow previews for link destinations and detected data such as
+  /// addresses and phone numbers.
+  ///
+  /// Defaults to true.
+  Future<void> setAllowsLinkPreview(bool allow) {
+    final WKWebView webView = nativeWebView;
+    switch (webView) {
+      case UIViewWKWebView():
+        return webView.setAllowsLinkPreview(allow);
+      case NSViewWKWebView():
+        return webView.setAllowsLinkPreview(allow);
+    }
+
+    throw UnimplementedError('${webView.runtimeType} is not supported.');
+  }
 }

packages/webview_flutter/webview_flutter_wkwebview/lib/src/common/web_kit.g.dart

@@ -1,7 +1,7 @@
 // Copyright 2013 The Flutter Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
-// Autogenerated from Pigeon (v25.2.0), do not edit directly.
+// Autogenerated from Pigeon (v25.3.0), do not edit directly.
 // See also: https://pub.dev/packages/pigeon
 // ignore_for_file: public_member_api_docs, non_constant_identifier_names, avoid_as, unused_import, unnecessary_parenthesis, prefer_null_aware_operators, omit_local_variable_types, unused_shown_name, unnecessary_import, no_leading_underscores_for_local_identifiers
 
@@ -5822,6 +5822,39 @@ class UIViewWKWebView extends UIView implements WKWebView {
     }
   }
 
+  /// Whether to allow previews for link destinations and detected data such as
+  /// addresses and phone numbers.
+  ///
+  /// Defaults to true.
+  Future<void> setAllowsLinkPreview(bool allow) async {
+    final _PigeonInternalProxyApiBaseCodec pigeonChannelCodec =
+        _pigeonVar_codecUIViewWKWebView;
+    final BinaryMessenger? pigeonVar_binaryMessenger = pigeon_binaryMessenger;
+    const String pigeonVar_channelName =
+        'dev.flutter.pigeon.webview_flutter_wkwebview.UIViewWKWebView.setAllowsLinkPreview';
+    final BasicMessageChannel<Object?> pigeonVar_channel =
+        BasicMessageChannel<Object?>(
+      pigeonVar_channelName,
+      pigeonChannelCodec,
+      binaryMessenger: pigeonVar_binaryMessenger,
+    );
+    final Future<Object?> pigeonVar_sendFuture =
+        pigeonVar_channel.send(<Object?>[this, allow]);
+    final List<Object?>? pigeonVar_replyList =
+        await pigeonVar_sendFuture as List<Object?>?;
+    if (pigeonVar_replyList == null) {
+      throw _createConnectionError(pigeonVar_channelName);
+    } else if (pigeonVar_replyList.length > 1) {
+      throw PlatformException(
+        code: pigeonVar_replyList[0]! as String,
+        message: pigeonVar_replyList[1] as String?,
+        details: pigeonVar_replyList[2],
+      );
+    } else {
+      return;
+    }
+  }
+
   @override
   UIViewWKWebView pigeon_copy() {
     return UIViewWKWebView.pigeon_detached(
@@ -6577,6 +6610,39 @@ class NSViewWKWebView extends NSObject implements WKWebView {
     }
   }
 
+  /// Whether to allow previews for link destinations and detected data such as
+  /// addresses and phone numbers.
+  ///
+  /// Defaults to true.
+  Future<void> setAllowsLinkPreview(bool allow) async {
+    final _PigeonInternalProxyApiBaseCodec pigeonChannelCodec =
+        _pigeonVar_codecNSViewWKWebView;
+    final BinaryMessenger? pigeonVar_binaryMessenger = pigeon_binaryMessenger;
+    const String pigeonVar_channelName =
+        'dev.flutter.pigeon.webview_flutter_wkwebview.NSViewWKWebView.setAllowsLinkPreview';
+    final BasicMessageChannel<Object?> pigeonVar_channel =
+        BasicMessageChannel<Object?>(
+      pigeonVar_channelName,
+      pigeonChannelCodec,
+      binaryMessenger: pigeonVar_binaryMessenger,
+    );
+    final Future<Object?> pigeonVar_sendFuture =
+        pigeonVar_channel.send(<Object?>[this, allow]);
+    final List<Object?>? pigeonVar_replyList =
+        await pigeonVar_sendFuture as List<Object?>?;
+    if (pigeonVar_replyList == null) {
+      throw _createConnectionError(pigeonVar_channelName);
+    } else if (pigeonVar_replyList.length > 1) {
+      throw PlatformException(
+        code: pigeonVar_replyList[0]! as String,
+        message: pigeonVar_replyList[1] as String?,
+        details: pigeonVar_replyList[2],
+      );
+    } else {
+      return;
+    }
+  }
+
   @override
   NSViewWKWebView pigeon_copy() {
     return NSViewWKWebView.pigeon_detached(