Tauri Core API - v2.9.1
    Preparing search index...

    Interface WebviewOptions

    Configuration for the webview to create.

    2.0.0

    interface WebviewOptions {
        url?: string;
        x: number;
        y: number;
        width: number;
        height: number;
        transparent?: boolean;
        focus?: boolean;
        dragDropEnabled?: boolean;
        acceptFirstMouse?: boolean;
        userAgent?: string;
        incognito?: boolean;
        proxyUrl?: string;
        zoomHotkeysEnabled?: boolean;
        useHttpsScheme?: boolean;
        devtools?: boolean;
        backgroundColor?: webview.Color;
        backgroundThrottling?: BackgroundThrottlingPolicy;
        javascriptDisabled?: boolean;
        allowLinkPreview?: boolean;
        disableInputAccessoryView?: boolean;
        dataDirectory?: string;
        dataStoreIdentifier?: number[];
        scrollBarStyle?: ScrollBarStyle;
    }
    Index

    Properties

    url? x y width height transparent? focus? dragDropEnabled? acceptFirstMouse? userAgent? incognito? proxyUrl? zoomHotkeysEnabled? useHttpsScheme? devtools? backgroundColor? backgroundThrottling? javascriptDisabled? allowLinkPreview? disableInputAccessoryView? dataDirectory? dataStoreIdentifier? scrollBarStyle?

    Properties

    url?: string

    Remote URL or local file path to open.

    • URL such as https://github.com/tauri-apps is opened directly on a Tauri webview.
    • data: URL such as data:text/html,<html>... is only supported with the webview-data-url Cargo feature for the tauri dependency.
    • local file path or route such as /path/to/page.html or /users is appended to the application URL (the devServer URL on development, or tauri://localhost/ and https://tauri.localhost/ on production).
    x: number

    The initial vertical position.

    y: number

    The initial horizontal position.

    width: number

    The initial width.

    height: number

    The initial height.

    transparent?: boolean

    Whether the webview is transparent or not. Note that on macOS this requires the macos-private-api feature flag, enabled under tauri.conf.json > app > macOSPrivateApi. WARNING: Using private APIs on macOS prevents your application from being accepted to the App Store.

    focus?: boolean

    Whether the webview should have focus or not

    2.1.0

    dragDropEnabled?: boolean

    Whether the drag and drop is enabled or not on the webview. By default it is enabled.

    Disabling it is required to use HTML5 drag and drop on the frontend on Windows.

    acceptFirstMouse?: boolean

    Whether clicking an inactive webview also clicks through to the webview on macOS.

    userAgent?: string

    The user agent for the webview.

    incognito?: boolean

    Whether or not the webview should be launched in incognito mode.

    • Android: Unsupported.
    proxyUrl?: string

    The proxy URL for the WebView for all network requests.

    Must be either a http:// or a socks5:// URL.

    • macOS: Requires the macos-proxy feature flag and only compiles for macOS 14+.
    zoomHotkeysEnabled?: boolean

    Whether page zooming by hotkeys is enabled

    • Windows: Controls WebView2's IsZoomControlEnabled setting.

    • MacOS / Linux: Injects a polyfill that zooms in and out with ctrl/command + -/=, 20% in each step, ranging from 20% to 1000%. Requires webview:allow-set-webview-zoom permission

    • Android / iOS: Unsupported.

    useHttpsScheme?: boolean

    Sets whether the custom protocols should use https://<scheme>.localhost instead of the default http://<scheme>.localhost on Windows and Android. Defaults to false.

    Using a https scheme will NOT allow mixed content when trying to fetch http endpoints and therefore will not match the behavior of the <scheme>://localhost protocols used on macOS and Linux.

    Changing this value between releases will change the IndexedDB, cookies and localstorage location and your app will not be able to access them.

    2.1.0

    devtools?: boolean

    Whether web inspector, which is usually called browser devtools, is enabled or not. Enabled by default.

    This API works in debug builds, but requires devtools feature flag to enable it in release builds.

    • macOS: This will call private functions on macOS.
    • 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.

    2.1.0

    backgroundColor?: webview.Color

    Set the window and webview background color.

    • macOS / iOS: Not implemented.
    • Windows:
      • On Windows 7, alpha channel is ignored.
      • On Windows 8 and newer, if alpha channel is not 0, it will be ignored.

    2.1.0

    backgroundThrottling?: BackgroundThrottlingPolicy

    Change the default background throttling behaviour.

    By default, browsers use a suspend policy that will throttle timers and even unload the whole tab (view) to free resources after roughly 5 minutes when a view became minimized or hidden. This will pause all tasks until the documents visibility state changes back from hidden to visible by bringing the view back to the foreground.

    • Linux / Windows / Android: Unsupported. Workarounds like a pending WebLock transaction might suffice.
    • iOS: Supported since version 17.0+.
    • macOS: Supported since version 14.0+.

    see https://github.com/tauri-apps/tauri/issues/5250#issuecomment-2569380578

    2.3.0

    javascriptDisabled?: boolean

    Whether we should disable JavaScript code execution on the webview or not.

    allowLinkPreview?: boolean

    on macOS and iOS there is a link preview on long pressing links, this is enabled by default. see https://docs.rs/objc2-web-kit/latest/objc2_web_kit/struct.WKWebView.html#method.allowsLinkPreview

    disableInputAccessoryView?: boolean

    Allows disabling the input accessory view on iOS.

    The accessory view is the view that appears above the keyboard when a text input element is focused. It usually displays a view with "Done", "Next" buttons.

    dataDirectory?: string

    Set a custom path for the webview's data directory (localStorage, cache, etc.) relative to [appDataDir()]/${label}. For security reasons, paths outside of that location can only be configured on the Rust side.

    • Windows: WebViews with different values for settings like additionalBrowserArgs, browserExtensionsEnabled or scrollBarStyle must have different data directories.
    • macOS / iOS: Unsupported, use dataStoreIdentifier instead.
    • Android: Unsupported.

    2.9.0

    dataStoreIdentifier?: number[]

    Initialize the WebView with a custom data store identifier. This can be seen as a replacement for dataDirectory which is unavailable in WKWebView. See https://developer.apple.com/documentation/webkit/wkwebsitedatastore/init(foridentifier:)?language=objc

    The array must contain 16 u8 numbers.

    • macOS / iOS: Available on macOS >= 14 and iOS >= 17
    • Windows / Linux / Android: Unsupported.

    2.9.0

    scrollBarStyle?: ScrollBarStyle

    Specifies the native scrollbar style to use with the webview. CSS styles that modify the scrollbar are applied on top of the native appearance configured here.

    Defaults to default, which is the browser default.

    • Windows:
      • fluentOverlay requires WebView2 Runtime version 125.0.2535.41 or higher, and does nothing on older versions.
      • This option must be given the same value for all webviews.
    • Linux / Android / iOS / macOS: Unsupported. Only supports Default and performs no operation.

    Settings

    Member Visibility

    On This Page

    Properties