Tauri（部分 - 首先正确设置窗口配置-js教程-PHP中文网

Tauri (Part - Get the window configuration right first

前言

在开发桌面应用程序时，理解并正确配置窗口参数至关重要。它有助于简化功能并优化用户体验。

以下内容基于Tauri 2官方文档，提供了WindowConfig配置参数的详细说明，包括其功能、默认值和适用性。

基本窗口行为

参数	类型	描述	默认值
接受FirstMouse	布尔值	窗口是否接受第一个鼠标事件（仅限 macOS）。	假
永远在底部	布尔值	窗口是否始终放置在其他窗口的下方。	假
永远在最上面	布尔值	窗口是否始终放置在其他窗口之上。	假
背景颜色	字符串	窗口的背景颜色（十六进制格式）。	无默认值
中心	布尔值	窗口是否位于屏幕中央。	假
可关闭	布尔值	是否可以关闭窗口。	真实
内容受保护	布尔值	保护窗口内容不被捕获或记录（部分支持）。	假
装饰品	布尔值	是否显示窗口装饰（如标题栏和边框）。	真实
dragDropEnabled	布尔值	是否启用拖放功能。	真实
焦点	布尔值	窗口启动时是否获得焦点。	真实
全屏	布尔值	窗口是否以全屏模式启动。	假
隐藏标题	布尔值	隐藏标题栏（仅限 macOS）。	假
隐身	布尔值	启用隐身模式以防止数据跟踪。	假
标签	字符串	窗口的唯一标识符（必需）。	无默认值
可最大化	布尔值	窗口是否可以最大化。	真实
最大化	布尔值	窗口是否开始最大化。	假
可最小化	布尔值	窗口是否可以最小化。	真实
可调整大小	布尔值	是否可以调整窗口大小	真实
跳过任务栏	布尔值	隐藏任务栏上的窗口（取决于平台）。	假
tabbingIdentifier	字符串	用于分组窗口的标识符（仅限 macOS）。	无默认值
主题	“亮”或“暗”	窗口默认主题，部分支持。	系统默认
标题	字符串	窗口标题。	“Tauri 应用程序”
titleBarStyle	字符串	标题栏的样式（取决于平台，例如 macOS）。	默认样式
透明	布尔值	启用窗口透明度（部分支持）。	假
用户代理	字符串	窗口的自定义用户代理。	无默认值
可见	布尔值	窗口是否可见。	真实
所有工作空间可见	布尔值	使窗口在所有工作区上可见（仅限 macOS）。	假
窗口类名称	字符串	自定义窗口类名称（仅限 Windows）。	无默认值
缩放热键已启用	布尔值	启用窗口缩放热键。	真实

尺寸和定位

Parameter	Type	Description	Default Value
width	number	Initial width of the window (in pixels).	800
height	number	Initial height of the window (in pixels).	600
minWidth	number	Minimum width of the window (in pixels).	No default value
minHeight	number	Minimum height of the window (in pixels).	No default value
maxWidth	number	Maximum width of the window (in pixels).	No default value
maxHeight	number	Maximum height of the window (in pixels).	No default value
x	number	Initial X-axis position of the window (from screen top-left).	Centered
y	number	Initial Y-axis position of the window (from screen top-left).	Centered

参数类型描述默认值标题> 宽度数字窗口的初始宽度（以像素为单位）。 800 身高数字窗口的初始高度（以像素为单位）。 600 最小宽度数字窗口的最小宽度（以像素为单位）。无默认值最小高度数字窗口的最小高度（以像素为单位）。无默认值最大宽度数字窗口的最大宽度（以像素为单位）。无默认值最大高度数字窗口的最大高度（以像素为单位）。无默认值 x 数字窗口的初始 X 轴位置（从屏幕左上角开始）。居中 y 数字窗口的初始 Y 轴位置（从屏幕左上角开始）。居中

浏览器功能

Parameter	Type	Description	Default Value
additionalBrowserArgs	string	Additional command-line arguments for the browser.	No default value
browserExtensionsEnabled	boolean	Enables support for browser extensions.	false
proxyUrl	string	Custom proxy URL.	No default value
useHttpsScheme	boolean	Forces the use of HTTPS.	false

窗口效果

Parameter	Type	Description	Default Value
shadow	boolean	Whether the window shows a shadow (platform-dependent).	true
windowEffects	string	Custom window effects (e.g., blur, transparency).	No default value

JSON 配置示例

src-tauri/tauri.conf.json

{
  "$schema": "https://schema.tauri.app/config/2.0.0",
  "productName": "Coco AI",
  "version": "0.1.0",
  "identifier": "rs.coco.app",
  "build": {
    "beforeDevCommand": "pnpm dev",
    "devUrl": "http://localhost:1420",
    "beforeBuildCommand": "pnpm build",
    "frontendDist": "../dist"
  },
  "app": {
    "macOSPrivateApi": true,
    "windows": [
      {
        "acceptFirstMouse": false, // Whether the first mouse event is accepted
        "additionalBrowserArgs": "", // Additional arguments passed to the browser
        "alwaysOnBottom": false, // Whether the window always stays at the bottom
        "alwaysOnTop": false, // Whether the window always stays on top
        "backgroundColor": "#ffffff", // Background color of the window (default is white)
        "browserExtensionsEnabled": false, // Whether browser extensions are enabled
        "center": true, // Whether the window is centered
        "closable": true, // Whether the window can be closed
        "contentProtected": false, // Whether content protection is enabled (prevents screenshots)
        "create": true, // Whether to display the window when created
        "decorations": true, // Whether to display window decorations
        "devtools": false, // Whether developer tools are enabled (disabled by default in production)
        "dragDropEnabled": true, // Whether drag-and-drop functionality is enabled
        "focus": true, // Whether the window is focused
        "fullscreen": false, // Whether the window is in fullscreen mode
        "height": 600, // Window height (default 600px)
        "hiddenTitle": false, // Whether the window title bar is hidden
        "incognito": false, // Whether incognito mode is enabled
        "label": "main", // Unique label (identifier) of the window
        "maxHeight": null, // Maximum height of the window (default is unlimited)
        "maximizable": true, // Whether the window can be maximized
        "maximized": false, // Whether the window is maximized by default
        "maxWidth": null, // Maximum width of the window (default is unlimited)
        "minHeight": 300, // Minimum height of the window (default 300px)
        "minimizable": true, // Whether the window can be minimized
        "minWidth": 300, // Minimum width of the window (default 300px)
        "parent": null, // Parent window (default is none)
        "proxyUrl": "", // Proxy URL
        "resizable": true, // Whether the window is resizable
        "shadow": true, // Whether the window shadow is displayed
        "skipTaskbar": false, // Whether to skip showing the window in the taskbar
        "tabbingIdentifier": null, // Identifier for grouping windows
        "theme": "light", // Window theme (default is light)
        "title": "Tauri App", // Window title
        "titleBarStyle": "default", // Title bar style
        "transparent": false, // Whether the window is transparent
        "url": "/", // Default URL of the window
        "useHttpsScheme": false, // Whether to enforce HTTPS
        "userAgent": null, // Custom user agent (default is null)
        "visible": true, // Whether the window is visible
        "visibleOnAllWorkspaces": false, // Whether the window is visible on all workspaces
        "width": 800, // Window width (default 800px)
        "windowClassname": "", // Window class name (customizable)
        "windowEffects": null, // Window effects (default is none)
        "x": null, // Initial X-coordinate of the window position
        "y": null, // Initial Y-coordinate of the window position
        "zoomHotkeysEnabled": true // Whether zoom hotkeys are enabled
      }
    ],
    "security": {
      "csp": null
    }
  }
}

登录后复制