feat: add Webview::show and Webview::hide (#11140)

closes #11126

Author: amrbashir

.changes/webview-hide-show-api.md

@@ -0,0 +1,6 @@
+---
+"tauri": "patch:feat"
+---
+
+Add `Webview::hide` and `Webview::show` methods.
+

.changes/webview-hide-show-runtime.md

@@ -0,0 +1,7 @@
+---
+"tauri-runtime": "patch:feat"
+"tauri-runtime-wry": "patch:feat"
+---
+
+Add `WebviewDispatch::hide` and `WebviewDispatch::show` methods.
+

.changes/webview-hide-show.md

@@ -0,0 +1,6 @@
+---
+"@tauri-apps/api": "patch:feat"
+---
+
+Add `Webview.hide` and `Webview.show` methods.
+

crates/tauri-runtime-wry/src/lib.rs

@@ -1237,6 +1237,8 @@ pub enum WebviewMessage {
   Navigate(Url),
   Print,
   Close,
+  Show,
+  Hide,
   SetPosition(Position),
   SetSize(Size),
   SetBounds(tauri_runtime::Rect),
@@ -1533,6 +1535,28 @@ impl<T: UserEvent> WebviewDispatch<T> for WryWebviewDispatcher<T> {
       ),
     )
   }
+
+  fn hide(&self) -> Result<()> {
+    send_user_message(
+      &self.context,
+      Message::Webview(
+        *self.window_id.lock().unwrap(),
+        self.webview_id,
+        WebviewMessage::Hide,
+      ),
+    )
+  }
+
+  fn show(&self) -> Result<()> {
+    send_user_message(
+      &self.context,
+      Message::Webview(
+        *self.window_id.lock().unwrap(),
+        self.webview_id,
+        WebviewMessage::Show,
+      ),
+    )
+  }
 }
 
 /// The Tauri [`WindowDispatch`] for [`Wry`].
@@ -3138,6 +3162,16 @@ fn handle_user_message<T: UserEvent>(
               log::error!("failed to navigate to url {}: {}", url, e);
             }
           }
+          WebviewMessage::Show => {
+            if let Err(e) = webview.set_visible(true) {
+              log::error!("failed to change webview visibility: {e}");
+            }
+          }
+          WebviewMessage::Hide => {
+            if let Err(e) = webview.set_visible(false) {
+              log::error!("failed to change webview visibility: {e}");
+            }
+          }
           WebviewMessage::Print => {
             let _ = webview.print();
           }

crates/tauri-runtime/src/lib.rs

@@ -505,6 +505,12 @@ pub trait WebviewDispatch<T: UserEvent>: Debug + Clone + Send + Sync + Sized + '
   /// Bring the window to front and focus the webview.
   fn set_focus(&self) -> Result<()>;
 
+  /// Hide the webview
+  fn hide(&self) -> Result<()>;
+
+  /// Show the webview
+  fn show(&self) -> Result<()>;
+
   /// Executes javascript on the window this [`WindowDispatch`] represents.
   fn eval_script<S: Into<String>>(&self, script: S) -> Result<()>;
 

crates/tauri-utils/src/acl/build.rs

@@ -306,7 +306,7 @@ commands.deny = ["{command}"]
 }
 
 const PERMISSION_TABLE_HEADER: &str =
-  "## Permission Table \n\n<table>\n<tr>\n<th>Identifier</th>\n<th>Description</th>\n</tr>\n";
+  "## Permission Table\n\n<table>\n<tr>\n<th>Identifier</th>\n<th>Description</th>\n</tr>\n";
 
 /// Generate a markdown documentation page containing the list of permissions of the plugin.
 pub fn generate_docs(

crates/tauri/build.rs

@@ -126,6 +126,8 @@ const PLUGINS: &[(&str, &[(&str, bool)])] = &[
       ("set_webview_position", false),
       ("set_webview_focus", false),
       ("set_webview_zoom", false),
+      ("webview_hide", false),
+      ("webview_show", false),
       ("print", false),
       ("reparent", false),
       ("clear_all_browsing_data", false),

crates/tauri/permissions/app/autogenerated/reference.md

@@ -6,7 +6,7 @@ Default permissions for the plugin.
 - `allow-name`
 - `allow-tauri-version`
 
-## Permission Table 
+## Permission Table
 
 <table>
 <tr>

crates/tauri/permissions/event/autogenerated/reference.md

@@ -7,7 +7,7 @@ Default permissions for the plugin.
 - `allow-emit`
 - `allow-emit-to`
 
-## Permission Table 
+## Permission Table
 
 <table>
 <tr>

crates/tauri/permissions/image/autogenerated/reference.md

@@ -8,7 +8,7 @@ Default permissions for the plugin.
 - `allow-rgba`
 - `allow-size`
 
-## Permission Table 
+## Permission Table
 
 <table>
 <tr>