Tauri (Bahagian - Dapatkan konfigurasi tetingkap dengan betul terlebih dahulu

Mukadimah

Apabila membangunkan aplikasi desktop, memahami dan mengkonfigurasi parameter tetingkap dengan betul adalah penting. Ia membantu memperkemas kefungsian dan mengoptimumkan pengalaman pengguna.

Kandungan berikut adalah berdasarkan dokumentasi rasmi Tauri 2 dan memberikan penerangan terperinci tentang parameter konfigurasi WindowConfig, termasuk kefungsian, nilai lalai dan kebolehgunaannya.

Tingkah Laku Asas Tingkap

Parameter	Jenis	Penerangan	Nilai Lalai
terimaFirstMouse	boolean	Sama ada acara tetikus pertama diterima oleh tetingkap (macOS sahaja).	palsu
sentiasaOnBottom	boolean	Sama ada tingkap sentiasa diletakkan di bawah tingkap lain.	palsu
sentiasaOnTop	boolean	Sama ada tingkap sentiasa diletakkan di atas tingkap lain.	palsu
Warna latar belakang	rentetan	Warna latar belakang tetingkap (dalam format perenambelasan).	Tiada nilai lalai
pusat	boolean	Sama ada tetingkap dipusatkan pada skrin.	palsu
boleh ditutup	boolean	Sama ada tingkap boleh ditutup.	benar
kandungan Dilindungi	boolean	Melindungi kandungan tetingkap daripada ditangkap atau dirakam (sokongan separa).	palsu
hiasan	boolean	Sama ada mahu memaparkan hiasan tingkap (seperti bar tajuk dan jidar).	benar
dragDropEnabled	boolean	Sama ada fungsi seret dan lepas didayakan.	benar
fokus	boolean	Sama ada tetingkap mendapat fokus apabila dilancarkan.	benar
skrin penuh	boolean	Sama ada tetingkap bermula dalam mod skrin penuh.	palsu
tajuk tersembunyi	boolean	Menyembunyikan bar tajuk (macOS sahaja).	palsu
inkognito	boolean	Mendayakan mod inkognito untuk menghalang penjejakan data.	palsu
label	rentetan	Pengecam unik untuk tetingkap (diperlukan).	Tiada nilai lalai
boleh dimaksimumkan	boolean	Sama ada tetingkap boleh dimaksimumkan.	benar
dimaksimumkan	boolean	Sama ada tetingkap mula dimaksimumkan.	palsu
boleh diminimumkan	boolean	Sama ada tingkap boleh diminimumkan.	benar
boleh diubah saiz	boolean	Sama ada saiz tetingkap boleh dilaraskan.	benar
skipTaskbar	boolean	Menyembunyikan tetingkap daripada bar tugas (bergantung pada platform).	palsu
Pengecam tabbing	rentetan	Pengecam untuk mengumpulkan tetingkap (macOS sahaja).	Tiada nilai lalai
tema	"terang" atau "gelap"	Tema lalai tetingkap, sebahagiannya disokong.	Lalai sistem
tajuk	rentetan	Tajuk tingkap.	"Apl Tauri"
titleBarStyle	rentetan	Gaya bar tajuk (bergantung pada platform, seperti macOS).	Gaya lalai
telus	boolean	Mendayakan ketelusan untuk tetingkap (sokongan separa).	palsu
Ejen pengguna	rentetan	Ejen Pengguna Tersuai untuk tetingkap.	Tiada nilai lalai
kelihatan	boolean	Sama ada tingkap kelihatan.	benar
visibleOnAllWorkspaces	boolean	Menjadikan tetingkap kelihatan pada semua ruang kerja (macOS sahaja).	palsu
windowClassname	rentetan	Nama kelas tetingkap tersuai (Windows sahaja).	Tiada nilai lalai
zoomHotkeysEnabled	boolean	Mendayakan kekunci pintas zum untuk tetingkap.	benar

Dimensi dan Kedudukan

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

Parameter Jenis Penerangan Nilai Lalai lebar nombor Lebar awal tetingkap (dalam piksel). 800 tinggi nombor Ketinggian awal tetingkap (dalam piksel). 600 minLebar nombor Lebar minimum tetingkap (dalam piksel). Tiada nilai lalai minHeight nombor Ketinggian minimum tetingkap (dalam piksel). Tiada nilai lalai Lebar maksimum nombor Lebar maksimum tetingkap (dalam piksel). Tiada nilai lalai maxHeight nombor Ketinggian maksimum tetingkap (dalam piksel). Tiada nilai lalai x nombor Kedudukan paksi X awal tetingkap (dari kiri atas skrin). Berpusat y nombor Kedudukan paksi Y awal tetingkap (dari kiri atas skrin). Berpusat

Ciri Pelayar

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

Kesan Tetingkap

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

---

Contoh Konfigurasi 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
    }
  }
}

Kesimpulan

Mengkonfigurasi parameter tetingkap ialah langkah penting dalam pembangunan Tauri.

Memahami tujuan dan nilai lalai setiap parameter bukan sahaja membantu dalam pelaksanaan yang cekap tetapi juga menghalang potensi isu keserasian merentas platform.

Rujuk Dokumentasi Rasmi Tauri untuk konfigurasi yang tepat dan butiran lanjut.

Jangan teragak-agak untuk meneroka projek Tauri saya yang baru-baru ini github.com/infinilabs/coco-app, iaitu sumber terbuka. Sila pertimbangkan untuk memberinya bintang ?.

Ini adalah projek Tauri pertama saya, dan saya sedang belajar sambil berjalan. Saya berharap dapat berhubung dengan individu yang berfikiran sama untuk meneroka dan berkembang bersama.

Rujukan

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

Atas ialah kandungan terperinci Tauri (Bahagian - Dapatkan konfigurasi tetingkap dengan betul terlebih dahulu. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!