Tauri 窗口配置
窗口配置对象。
类型:object
名字 | 类型 | 违约 | 描述 |
---|---|---|---|
label | string | 零 | 窗口标识符。它必须是字母数字。 |
url | WindowUrl | 视图 | 窗口 webview URL。 |
userAgent | string ? | 零 | webview 的用户代理 |
fileDropEnabled | boolean | true | 是否在 Web 视图上启用文件放置。默认情况下,它处于启用状态。 禁用它需要在 Windows 的前端使用拖放。 |
center | boolean | false | 窗口是否居中启动。 |
x | number ?(格式:双) | 零 | 窗口左上角的水平位置 |
y | number ?(格式:双) | 零 | 窗口左上角的垂直位置 |
width | number (格式:双) | 800 | 窗口宽度。 |
height | number (格式:双) | 600 | 窗口高度。 |
minWidth | number ?(格式:双) | 零 | 最小窗口宽度。 |
minHeight | number ?(格式:双) | 零 | 最小窗口高度。 |
maxWidth | number ?(格式:双) | 零 | 最大窗口宽度。 |
maxHeight | number ?(格式:双) | 零 | 最大窗口高度。 |
resizable | boolean | true | 窗口是否可调整大小。 |
title | string | 零 | 窗口标题。 |
fullscreen | boolean | false | 窗口是否以全屏模式启动。 |
focus | boolean | true | 窗口最初是否聚焦。 |
transparent | boolean | false | 窗口是否透明。请注意,这需要在 下启用的功能标志。 警告:使用私有 API 会阻止您的应用程序被 接受。 macOS macos-private-api tauri > macOSPrivateApi macOS App Store |
maximized | boolean | false | 窗口是否最大化。 |
visible | boolean | true | 窗口是否可见。 |
decorations | boolean | true | 窗口是否应该有边框和条形。 |
alwaysOnTop | boolean | false | 窗口是否应始终位于其他窗口的顶部。 |
contentProtected | boolean | false | 防止窗口内容被其他应用捕获。 |
skipTaskbar | boolean | false | 如果 ,则在 Windows 和 Linux 上隐藏任务栏中的窗口图标。true |
theme | 主题 ? | 视图 | 初始窗口主题。默认为系统主题。仅在 Windows 和 macOS 10.14+ 上实现。 |
titleBarStyle | TitleBarStyle | 视图 | macOS 标题栏的样式。 |
hiddenTitle | boolean | false | 如果 ,则在 macOS 上将窗口标题设置为隐藏。true |
acceptFirstMouse | boolean | false | 在 macOS 上,单击非活动窗口是否也会单击进入 Web 视图。 |
tabbingIdentifier | string ? | 零 | 定义 macOS 的窗口 [tabbing identifier]。 具有匹配 Tab 键标识符的 Windows 将组合在一起。如果未设置 Tab 键标识符,则将禁用自动 Tab 键。 [制表符标识符]:https://developer.apple.com/documentation/appkit/nswindow/1644704-tabbingidentifier |
additionalBrowserArgs | string ? | 零 | 在 Windows 上定义其他浏览器参数。默认情况下,wry passs,因此如果您使用此方法,则还需要根据需要自行禁用这些组件。--disable-features=msWebOOUI,msPdfOOUI,msSmartScreenProtection |
窗口网址
要在 Tauri Web 视图窗口中打开的 URL。
可以是以下任何一种类型:
-
string
(format: uri
):外部 URL。 -
string
:应用 URL 的路径部分。例如,要加载 ,您可以简单地在此配置中提供。tauri://localhost/users/john
users/john
主题
系统主题。
可以是以下任何一种类型:
- “Light”:浅色主题。
- “Dark”:深色主题。
标题BarStyle
窗口标题栏在 macOS 上的显示方式。
可以是以下任何一种类型:
- “Visible”:一个普通的标题栏。
- “透明”:使标题栏透明,因此改为显示窗口背景色。如果您不需要在标题栏下有实际的 HTML,则很有用。这样可以避免使用 .当 Tauri 允许您设置自定义窗口背景颜色时,会更有用。TitleBarStyle::Overlay
- “叠加”:将标题栏显示为窗口内容上的透明叠加。请记住:
- 标题栏的高度在不同的操作系统版本上是不同的,这可能会导致窗口控件和标题不在您意想不到的位置。
- 您需要定义一个自定义拖动区域以使窗口可拖动,但是由于限制,当窗口未 https://github.com/tauri-apps/tauri/issues/4316 焦点时,您无法拖动窗口。
- 窗口标题的颜色取决于系统主题。