Tauri (Partie - Commencez par bien configurer la fenêtre

Préface

Lors du développement d'applications de bureau, il est crucial de comprendre et de configurer correctement les paramètres de fenêtre. Il permet de rationaliser les fonctionnalités et d'optimiser l'expérience utilisateur.

Le contenu suivant est basé sur la documentation officielle de Tauri 2 et fournit une description détaillée des paramètres de configuration de WindowConfig, y compris leurs fonctionnalités, leurs valeurs par défaut et leur applicabilité.

Comportements de base des fenêtres

Paramètre	Tapez	Description	Valeur par défaut
accepterFirstMouse	booléen	Si le premier événement de souris est accepté par la fenêtre (macOS uniquement).	faux
toujours en bas	booléen	Si la fenêtre est toujours placée en dessous des autres fenêtres.	faux
toujoursOnTop	booléen	Si la fenêtre est toujours placée au-dessus des autres fenêtres.	faux
Couleur d'arrière-plan	chaîne	Couleur de fond de la fenêtre (au format hexadécimal).	Aucune valeur par défaut
centre	booléen	Si la fenêtre est centrée sur l'écran.	faux
fermable	booléen	Si la fenêtre peut être fermée.	vrai
contentProtégé	booléen	Protège le contenu de la fenêtre contre la capture ou l'enregistrement (prise en charge partielle).	faux
décorations	booléen	Si les décorations de fenêtre doivent être affichées (telles que la barre de titre et les bordures).	vrai
dragDropEnabled	booléen	Si la fonctionnalité glisser-déposer est activée.	vrai
concentrer	booléen	Si la fenêtre obtient le focus lors de son lancement.	vrai
plein écran	booléen	Si la fenêtre démarre en mode plein écran.	faux
Titre caché	booléen	Masque la barre de titre (macOS uniquement).	faux
incognito	booléen	Active le mode navigation privée pour empêcher le suivi des données.	faux
étiquette	chaîne	Identifiant unique de la fenêtre (obligatoire).	Aucune valeur par défaut
maximisable	booléen	Si la fenêtre peut être agrandie.	vrai
maximisé	booléen	Si la fenêtre démarre en maximisant.	faux
minimisable	booléen	Si la fenêtre peut être réduite.	vrai
redimensionnable	booléen	Si la taille de la fenêtre peut être ajustée.	vrai
ignorer la barre des tâches	booléen	Masque la fenêtre de la barre des tâches (en fonction de la plate-forme).	faux
tabulationIdentifiant	chaîne	Identifiant pour regrouper les fenêtres (macOS uniquement).	Aucune valeur par défaut
thème	"clair" ou "sombre"	Thème par défaut de la fenêtre, partiellement supporté.	Défaut du système
titre	chaîne	Titre de la fenêtre.	«Application Tauri»
titreBarStyle	chaîne	Style de la barre de titre (en fonction de la plate-forme, comme macOS).	Style par défaut
transparent	booléen	Active la transparence de la fenêtre (support partiel).	faux
userAgent	chaîne	Agent utilisateur personnalisé pour la fenêtre.	Aucune valeur par défaut
visible	booléen	Si la fenêtre est visible.	vrai
visibleOnAllWorkspaces	booléen	Rend la fenêtre visible sur tous les espaces de travail (macOS uniquement).	faux
windowClassname	chaîne	Nom de classe de fenêtre personnalisé (Windows uniquement).	Aucune valeur par défaut
zoomHotkeysEnabled	booléen	Active les raccourcis clavier de zoom pour la fenêtre.	vrai

Dimensions et positionnement

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

Paramètre Tapez Description Valeur par défaut ête> largeur numéro Largeur initiale de la fenêtre (en pixels). 800 hauteur numéro Hauteur initiale de la fenêtre (en pixels). 600 minWidth numéro Largeur minimale de la fenêtre (en pixels). Aucune valeur par défaut minHauteur numéro Hauteur minimale de la fenêtre (en pixels). Aucune valeur par défaut maxWidth numéro Largeur maximale de la fenêtre (en pixels). Aucune valeur par défaut hauteurmax numéro Hauteur maximale de la fenêtre (en pixels). Aucune valeur par défaut x numéro Position initiale de l'axe X de la fenêtre (à partir du coin supérieur gauche de l'écran). Centré o numéro Position initiale de l'axe Y de la fenêtre (à partir du coin supérieur gauche de l'écran). Centré

Fonctionnalités du navigateur

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

Effets de fenêtre

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

---

Exemple de configuration 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
    }
  }
}

Conclusion

La configuration des paramètres de la fenêtre est une étape cruciale dans le développement de Tauri.

Comprendre l'objectif et les valeurs par défaut de chaque paramètre contribue non seulement à une mise en œuvre efficace, mais évite également d'éventuels problèmes de compatibilité multiplateforme.

Référez-vous à la documentation officielle de Tauri pour des configurations précises et plus de détails.

N'hésitez pas à explorer mon récent projet Tauri github.com/infinilabs/coco-app, qui est open-source. Pensez à lui donner une étoile ?.

C'est mon premier projet Tauri, et j'apprends au fur et à mesure. J'espère me connecter avec des personnes partageant les mêmes idées pour explorer et grandir ensemble.

Références

https://v2.tauri.app/reference/config/#windowconfig

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!