Tauri (パート - 最初にウィンドウ構成を正しく取得する)-jsチュートリアル-php.cn

Tauri (Part - Get the window configuration right first

序文

デスクトップアプリケーションを開発する場合、ウィンドウパラメーターを理解し、正しく構成することが重要です。機能を合理化し、ユーザーエクスペリエンスを最適化するのに役立ちます。

次のコンテンツは Tauri 2 公式ドキュメントに基づいており、機能、デフォルト値、適用性など、WindowConfig 構成パラメーターの詳細な説明を提供します。

基本的なウィンドウの動作

パラメータ	タイプ	説明	デフォルト値
acceptFirstMouse	ブール値	最初のマウスイベントがウィンドウによって受け入れられるかどうか (macOS のみ)。	偽
常に下側	ブール値	ウィンドウを常に他のウィンドウの下に配置するかどうか。	偽
常にトップ	ブール値	ウィンドウを常に他のウィンドウの上に配置するかどうか。	偽
背景色	文字列	ウィンドウの背景色 (16 進形式)。	デフォルト値なし
センター	ブール値	ウィンドウが画面の中央に配置されているかどうか。	偽
開閉可能	ブール値	ウィンドウを閉められるかどうか。	本当
コンテンツ保護	ブール値	ウィンドウのコンテンツがキャプチャまたは記録されないように保護します (部分的なサポート)。	偽
装飾	ブール値	ウィンドウの装飾 (タイトルバーや境界線など) を表示するかどうか。	本当
dragDropEnabled	ブール値	ドラッグアンドドロップ機能が有効かどうか。	本当
フォーカス	ブール値	起動時にウィンドウにフォーカスを取得するかどうか。	本当
全画面	ブール値	ウィンドウを全画面モードで開始するかどうか。	偽
隠しタイトル	ブール値	タイトルバーを非表示にします (macOS のみ)。	偽
シークレット	ブール値	シークレットモードを有効にしてデータ追跡を防ぎます。	偽
ラベル	文字列	ウィンドウの一意の識別子 (必須)。	デフォルト値なし
最大化可能	ブール値	ウィンドウを最大化できるかどうか。	本当
最大化	ブール値	ウィンドウを最大化して開始するかどうか。	偽
最小化可能	ブール値	ウィンドウを最小化できるかどうか。	本当
サイズ変更可能	ブール値	ウィンドウのサイズを調整できるかどうか。	本当
タスクバーをスキップ	ブール値	タスクバーからウィンドウを非表示にします (プラットフォームに依存します)。	偽
タブ識別子	文字列	ウィンドウをグループ化するための識別子 (macOS のみ)。	デフォルト値なし
テーマ	「明るい」か「暗い」か	ウィンドウのデフォルトのテーマ。部分的にサポートされています。	システムのデフォルト
タイトル	文字列	ウィンドウのタイトル	「タウリアプリ」
タイトルバースタイル	文字列	タイトルバーのスタイル (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 minWidth 番号ウィンドウの最小幅 (ピクセル単位)。デフォルト値なし最小身長番号ウィンドウの最小の高さ (ピクセル単位)。デフォルト値なし maxWidth 番号ウィンドウの最大幅 (ピクセル単位)。デフォルト値なし最大高さ番号ウィンドウの最大高さ (ピクセル単位)。デフォルト値なし 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
    }
  }
}

ログイン後にコピー