Fenêtres d’encoche

NewNotchWindow crée un panneau macOS profilé, sans activation, attaché au boîtier de la caméra. Wails gère le positionnement natif, les ailes d’attache noires, la surface extérieure transparente, le niveau de la fenêtre, le comportement dans les Spaces ainsi que les animations facultatives d’affichage et de masquage. Votre contenu web occupe uniquement le rectangle intérieur demandé. Lorsque le pointeur entre dans la fenêtre, sa webview devient immédiatement la fenêtre clé sans activer l’application.

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()

Options

NewNotchWindow gère les dimensions extérieures, la position, le cadre, la transparence, la politique de redimensionnement, la classe du panneau natif, le niveau de la fenêtre et le comportement dans les collections. Les valeurs de ces champs dans WindowOptions sont délibérément remplacées. Les autres champs sont conservés. Le déplacement natif par l’arrière-plan et les zones de déplacement CSS sont désactivés afin que la fenêtre reste attachée au boîtier de la caméra.

L’objet NotchWindow renvoyé n’expose délibérément que Show, Hide, Visibility et Close ; la géométrie native ne peut pas être modifiée au moyen de l’objet de haut niveau.

Cycle de vie

• Show affiche la fenêtre native existante. Lorsque l’animation est activée, elle glisse vers le bas depuis une position au-dessus de l’écran.
• Hide conserve la fenêtre afin de permettre sa réutilisation. Lorsque l’animation est activée, elle glisse de nouveau au-dessus de l’écran avant d’être retirée de l’affichage. La webview, l’état JavaScript, les liaisons et les écouteurs d’événements restent chargés, mais la fenêtre masquée ne constitue plus une cible de survol ; l’application doit appeler Show pour l’afficher de nouveau.
• Visibility indique la visibilité native actuelle.
• Close détruit définitivement la fenêtre native. Créez-en une nouvelle avant d’afficher de nouveau cette notification.
• Lorsque le pointeur entre dans cette fenêtre d’encoche, celle-ci passe au premier plan et sa webview reçoit le focus pour permettre une interaction immédiate au clavier, tout en conservant le comportement du panneau sans activation.

Chaque appel à NewNotchWindow crée une fenêtre indépendante avec son propre contenu, sa propre visibilité et son propre état d’animation. Les fenêtres utilisent le même niveau natif ; l’instance la plus récemment affichée ou survolée apparaît donc au premier plan et peut recouvrir les instances précédentes. Lorsque les fenêtres ciblent des écrans différents, chacune est centrée sur le boîtier de la caméra de l’écran concerné. macOS ne coordonne pas les fenêtres d’encoche appartenant à différentes applications ; si des applications distinctes affichent des fenêtres au même emplacement et au même niveau, la fenêtre la plus récemment placée dans l’ordre d’affichage apparaît au premier plan.

Pour les charges de travail de notification, les applications réutilisent généralement une fenêtre masquée ou gèrent leur propre file d’attente dans une seule webview. Wails n’impose ni mise en file d’attente, ni remplacement, ni fermeture automatique, ni politique de fenêtre unique.

Consultez l’exemple notch-notification qui présente un moniteur système compact dont l’état JavaScript en temps réel persiste au fil des cycles répétés d’affichage et de masquage des notifications.