Struct WebViewRenderer 

pub struct WebViewRenderer { /* private fields */ }

WebView-based renderer using wry + tao.

Platform backends:

• Windows: WebView2 (Edge Chromium)
• macOS: WKWebView (WebKit)
• Linux: WebKitGTK

Frameless / Custom Title Bar

Set decorations = false in WindowConfig to create a frameless window. The frontend can use window.__RDESKTOP_WINDOW__ to control the window:

window.__RDESKTOP_WINDOW__.minimize()
window.__RDESKTOP_WINDOW__.maximize()
window.__RDESKTOP_WINDOW__.close()
window.__RDESKTOP_WINDOW__.startDrag()       // drag from custom title bar
window.__RDESKTOP_WINDOW__.startResize('bottom-right')  // resize from edge

Implementations

impl WebViewRenderer

pub fn new(config: &AppConfig) -> Result<Self>

pub fn set_asset_root(&mut self, root: impl Into<PathBuf>) -> Result<()>

Register a local directory as the renderer’s rdesktop:// asset root.

Native WebViews cannot reliably load Vite module assets from file:// or NavigateToString() because of origin and module-CORS rules. Serving the built frontend through a framework-owned protocol gives the page a stable origin on every desktop backend.

pub fn set_data_directory( &mut self, directory: impl Into<PathBuf>, ) -> Result<()>

Store WebView cookies, localStorage, IndexedDB, and cache outside the executable directory.

Windows portable applications should point this at a preserved per-user directory (for example %LOCALAPPDATA%/<product>/WebView2). Otherwise WebView2 defaults beside the executable can be lost during a clean application update. The path must be absolute; Wry/WebView2 creates it when the first WebView starts.

pub fn set_outbox(&mut self, outbox: Arc<Mutex<Vec<String>>>)

Attach an external outbox so other runtimes (e.g. a Node extension host) can push messages to the frontend. Each entry is a JSON string emitted as window.__RDESKTOP_IPC__(<json>).

Trait Implementations

impl Renderer for WebViewRenderer

fn init(&mut self) -> Result<()>

Initialize the renderer.

fn create_window(&mut self, config: &WindowConfig) -> Result<WindowHandle>

Create a new window with the given configuration.

fn load_url(&self, window: WindowHandle, url: &str) -> Result<()>

Load a URL in the specified window.

fn load_html(&self, window: WindowHandle, html: &str) -> Result<()>

Load HTML content directly.

fn eval_script(&self, window: WindowHandle, script: &str) -> Result<()>

Execute JavaScript in the specified window.

fn set_ipc_handler(&mut self, handler: Box<dyn IpcHandler>)

Set the IPC handler for messages from the frontend.

fn send_to_frontend(&self, window: WindowHandle, message: &str) -> Result<()>

Send a message to the frontend JavaScript.

fn set_title(&self, window: WindowHandle, title: &str) -> Result<()>

Set the window title.

fn set_size(&self, window: WindowHandle, width: u32, height: u32) -> Result<()>

Set the window size.

fn set_resizable(&self, window: WindowHandle, resizable: bool) -> Result<()>

Set whether the window is resizable.

fn set_visible(&self, window: WindowHandle, visible: bool) -> Result<()>

Show or hide the window.

fn close_window(&mut self, window: WindowHandle) -> Result<()>

Close a window.

fn minimize_window(&self, window: WindowHandle) -> Result<()>

Minimize the window.

fn maximize_window(&self, window: WindowHandle) -> Result<()>

Toggle maximize/restore.

fn is_maximized(&self, _window: WindowHandle) -> Result<bool>

Check whether the window is currently maximized.

fn set_fullscreen(&self, window: WindowHandle, fullscreen: bool) -> Result<()>

Toggle fullscreen mode.

fn is_fullscreen(&self, _window: WindowHandle) -> Result<bool>

Check whether the window is currently fullscreen.

fn start_drag(&self, window: WindowHandle) -> Result<()>

Begin an interactive window drag.

fn start_resize(&self, window: WindowHandle, edge: ResizeEdge) -> Result<()>

Begin an interactive window resize.

fn set_decorations(&self, window: WindowHandle, decorations: bool) -> Result<()>

Set whether the window has OS decorations (title bar + borders).

fn set_always_on_top(&self, window: WindowHandle, always: bool) -> Result<()>

Set the window’s always-on-top state.

fn run(self: Box<Self>) -> Result<()>

Run the main event loop. This blocks until the application exits.

fn kind(&self) -> RendererKind

Get the renderer kind.

fn load_html_with_base_url( &self, window: WindowHandle, html: &str, base_url: &str, ) -> Result<(), RdesktopError>

Load HTML content with a document base URL for relative assets.

fn set_click_through( &self, _window: WindowHandle, _enabled: bool, ) -> Result<(), RdesktopError>

Enable or disable click-through: when enabled, pointer events fall through the window to whatever is behind it (used by wallpaper and click-through overlays). Applied at window creation by default; this method allows toggling it at runtime where the platform supports it.