Jendela Notch

NewNotchWindow membuat panel macOS berbentuk yang tidak mengaktifkan aplikasi dan melekat pada casing kamera. Wails mengelola penempatan native, sayap sambungan hitam, kanvas luar transparan, level jendela, perilaku Spaces, serta animasi tampil dan sembunyi opsional. Konten web Anda hanya menempati persegi panjang bagian dalam yang diminta. Memindahkan penunjuk ke dalam jendela akan segera menjadikan webview-nya sebagai jendela utama untuk input tanpa mengaktifkan aplikasi.

alert := app.Window.NewNotchWindow(application.NotchWindowOptions{
    Width:    660,
    Height:   92,
    Animated: true,
    WindowOptions: application.WebviewWindowOptions{
        Name: "alert",
        URL:  "/alert",
    },
})

alert.Show()
alert.Hide()
visible := alert.Visibility()
alert.Close()

Opsi

NewNotchWindow mengelola ukuran luar, posisi, bingkai, transparansi, kebijakan pengubahan ukuran, kelas panel native, level jendela, dan perilaku koleksi. Nilai untuk bidang-bidang tersebut dalam WindowOptions sengaja diganti. Bidang lainnya dipertahankan. Penyeretan latar belakang native dan area seret CSS dinonaktifkan agar jendela tetap melekat pada casing kamera.

NotchWindow yang dikembalikan sengaja hanya mengekspos Show, Hide, Visibility, dan Close; geometri native tidak dapat diubah melalui handle tingkat tinggi.

Siklus Hidup

• Show menampilkan jendela native yang sudah ada. Jika animasi diaktifkan, jendela bergeser turun dari atas layar.
• Hide mempertahankan jendela agar tetap aktif untuk digunakan kembali. Jika animasi diaktifkan, jendela bergeser kembali ke atas layar sebelum dikeluarkan dari tampilan. Webview, status JavaScript, pengikatan, dan pemroses peristiwa tetap dimuat, tetapi jendela tersembunyi tidak memiliki target hover; aplikasi harus memanggil Show untuk menampilkannya kembali.
• Visibility melaporkan visibilitas native saat ini.
• Close memusnahkan jendela native secara permanen. Buat jendela baru sebelum menampilkan notifikasi tersebut lagi.
• Saat penunjuk memasuki jendela notch, jendela tersebut dibawa ke depan dan webview-nya difokuskan agar dapat langsung menerima input papan ketik, sembari mempertahankan perilaku panel yang tidak mengaktifkan aplikasi.

Setiap pemanggilan NewNotchWindow membuat jendela independen dengan konten, visibilitas, dan status animasinya sendiri. Semua jendela menggunakan level native yang sama, sehingga instans yang paling baru ditampilkan atau dimasuki penunjuk akan muncul di depan dan dapat menutupi instans sebelumnya. Jika jendela menargetkan layar yang berbeda, setiap jendela dipusatkan pada casing kamera layar tersebut. macOS tidak mengoordinasikan jendela notch milik aplikasi yang berbeda; jika beberapa aplikasi menampilkan jendela pada lokasi dan level yang sama, jendela yang terakhir ditempatkan dalam urutan tampilan akan muncul di depan.

Untuk beban kerja notifikasi, aplikasi umumnya menggunakan kembali jendela tersembunyi atau mengelola antreannya sendiri dalam satu webview. Wails tidak memberlakukan antrean, penggantian, penutupan otomatis, ataupun kebijakan satu jendela.

Lihat contoh notch-notification untuk monitor sistem ringkas yang status JavaScript aktifnya tetap dipertahankan melalui siklus tampil dan sembunyi notifikasi yang berulang.