feat(macos): add accept_first_mouse option, closes #714

.changes/accept-first-mouse.md

@@ -0,0 +1,5 @@
+---
+"wry": patch
+---
+
+Added `WebViewAttributes::with_accept_first_mouse` method for macOS.

examples/custom_titlebar.rs

@@ -129,6 +129,7 @@ fn main() -> wry::Result<()> {
     .with_url(url)?
     .with_initialization_script(script)
     .with_ipc_handler(handler)
+    .with_accept_first_mouse(true)
     .build()?;
   webviews.insert(webview.window().id(), webview);
 

src/webview/mod.rs

@@ -186,6 +186,12 @@ pub struct WebViewAttributes {
   /// - Android: Open `chrome://inspect/#devices` in Chrome to get the devtools window. Wry's `WebView` devtools API isn't supported on Android.
   /// - iOS: Open Safari > Develop > [Your Device Name] > [Your WebView] to get the devtools window.
   pub devtools: bool,
+  /// Whether clicking an inactive window also clicks through to the webview. Default is `false`.
+  ///
+  /// ## Platform-specific
+  ///
+  /// This configuration only impacts macOS.
+  pub accept_first_mouse: bool,
 }
 
 impl Default for WebViewAttributes {
@@ -206,6 +212,7 @@ impl Default for WebViewAttributes {
       clipboard: false,
       devtools: false,
       zoom_hotkeys_enabled: false,
+      accept_first_mouse: false,
     }
   }
 }
@@ -460,6 +467,16 @@ impl<'a> WebViewBuilder<'a> {
     self
   }
 
+  /// Sets whether clicking an inactive window also clicks through to the webview. Default is `false`.
+  ///
+  /// ## Platform-specific
+  ///
+  /// This configuration only impacts macOS.
+  pub fn with_accept_first_mouse(mut self, accept_first_mouse: bool) -> Self {
+    self.webview.accept_first_mouse = accept_first_mouse;
+    self
+  }
+
   /// Consume the builder and create the [`WebView`].
   ///
   /// Platform-specific behavior:

src/webview/wkwebview/mod.rs

@@ -259,7 +259,19 @@ impl InnerWebView {
         #[allow(unused_mut)]
         Some(mut decl) => {
           #[cfg(target_os = "macos")]
-          add_file_drop_methods(&mut decl);
+          {
+            add_file_drop_methods(&mut decl);
+            if attributes.accept_first_mouse {
+              decl.add_method(
+                sel!(acceptsFirstMouse:),
+                yes as extern "C" fn(&Object, Sel, id) -> BOOL,
+              );
+            }
+
+            extern "C" fn yes(_this: &Object, _sel: Sel, _event: id) -> BOOL {
+              YES
+            }
+          }
           decl.register()
         }
         _ => class!(WryWebView),
@@ -689,7 +701,7 @@ r#"Object.defineProperty(window, 'ipc', {
     }
   }
 
-  pub fn set_background_color(&self, background_color: RGBA) -> Result<()> {
+  pub fn set_background_color(&self, _background_color: RGBA) -> Result<()> {
     Ok(())
   }
 }