Interface WindowOptions

Show window in the center of the screen..

The initial vertical position. Only applies if y is also set.

The initial horizontal position. Only applies if x is also set.

The initial width.

The initial height.

The minimum width. Only applies if minHeight is also set.

The minimum height. Only applies if minWidth is also set.

The maximum width. Only applies if maxHeight is also set.

The maximum height. Only applies if maxWidth is also set.

Prevent the window from overflowing the working area (e.g. monitor size - taskbar size) on creation, which means the window size will be limited to monitor size - taskbar size

Can either be set to true or to a PreventOverflowMargin object to set an additional margin that should be considered to determine the working area (in this case the window size will be limited to monitor size - taskbar size - margin)

NOTE: The overflow check is only performed on window creation, resizes can still overflow

Platform-specific

• iOS / Android: Unsupported.

Whether the window is resizable or not.

Window title.

Whether the window is in fullscreen mode or not.

Whether the window will be initially focused or not.

Whether the window 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.

Whether the window should be maximized upon creation or not.

Whether the window should be immediately visible upon creation or not.

Whether the window should have borders and bars or not.

Whether the window should always be on top of other windows or not.

Whether the window should always be below other windows.

Prevents the window contents from being captured by other apps.

Whether or not the window icon should be added to the taskbar.

Whether or not the window has shadow.

Platform-specific

• Windows:
  • false has no effect on decorated window, shadows are always ON.
  • true will make undecorated window have a 1px white border, and on Windows 11, it will have a rounded corners.
• Linux: Unsupported.

The initial window theme. Defaults to the system theme.

Only implemented on Windows and macOS 10.14+.

The style of the macOS title bar.

The position of the window controls on macOS.

Requires titleBarStyle: 'overlay' and decorations: true.

If true, sets the window title to be hidden on macOS.

Defines the window tabbing identifier on macOS.

Windows with the same tabbing identifier will be grouped together. If the tabbing identifier is not set, automatic tabbing will be disabled.

Whether the window's native maximize button is enabled or not. Defaults to true.

Whether the window's native minimize button is enabled or not. Defaults to true.

Whether the window's native close button is enabled or not. Defaults to true.

Sets a parent to the window to be created. Can be either a Window or a label of the window.

Platform-specific

• Windows: This sets the passed parent as an owner window to the window to be created. From MSDN owned windows docs:
  • An owned window is always above its owner in the z-order.
  • The system automatically destroys an owned window when its owner is destroyed.
  • An owned window is hidden when its owner is minimized.
• Linux: This makes the new window transient for parent, see https://docs.gtk.org/gtk3/method.Window.set_transient_for.html
• macOS: This adds the window as a child of parent, see https://developer.apple.com/documentation/appkit/nswindow/1419152-addchildwindow?language=objc

Whether the window should be visible on all workspaces or virtual desktops.

Platform-specific

• Windows / iOS / Android: Unsupported.

Window effects.

Requires the window to be transparent.

Platform-specific:

• Windows: If using decorations or shadows, you may want to try this workaround https://github.com/tauri-apps/tao/issues/72#issuecomment-975607891
• Linux: Unsupported

Set the window background color.

Platform-specific:

• Android / iOS: Unsupported.
• Windows: alpha channel is ignored.

Change the default background throttling behaviour.

Platform-specific

• 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

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

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

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.