Janelas do notch

NewNotchWindow cria um painel do macOS com formato personalizado e que não ativa o aplicativo, anexado ao compartimento da câmera. O Wails controla o posicionamento nativo, as extensões pretas de encaixe, a área externa transparente, o nível da janela, o comportamento nos Spaces e as animações opcionais para mostrar e ocultar. Seu conteúdo web ocupa apenas o retângulo interno solicitado. Ao mover o ponteiro para dentro da janela, sua webview se torna imediatamente a principal receptora de entrada, sem ativar o aplicativo.

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

Opções

NewNotchWindow controla o tamanho externo, a posição, a moldura, a transparência, a política de redimensionamento, a classe do painel nativo, o nível da janela e o comportamento de coleção. Os valores desses campos em WindowOptions são substituídos intencionalmente. Os demais campos são preservados. O arraste nativo pelo plano de fundo e as regiões de arraste CSS são desativados para que a janela permaneça anexada ao compartimento da câmera.

O NotchWindow retornado expõe intencionalmente apenas Show, Hide, Visibility e Close; a geometria nativa não pode ser alterada por meio da referência de alto nível.

Ciclo de vida

• Show revela a janela nativa existente. Com a animação ativada, ela desliza para baixo a partir de uma posição acima da tela.
• Hide mantém a janela ativa para reutilização. Com a animação ativada, ela desliza novamente para uma posição acima da tela antes de ser removida da exibição. A webview, o estado do JavaScript, os bindings e os listeners de eventos permanecem carregados, mas a janela oculta não tem uma área que responda à passagem do ponteiro; o aplicativo deve chamar Show para revelá-la novamente.
• Visibility informa a visibilidade nativa atual.
• Close destrói permanentemente a janela nativa. Crie outra antes de mostrar essa notificação novamente.
• A entrada do ponteiro traz essa janela de notch para a frente e direciona o foco à sua webview para permitir a interação imediata pelo teclado, preservando o comportamento do painel que não ativa o aplicativo.

Cada chamada a NewNotchWindow cria uma janela independente com conteúdo, visibilidade e estado de animação próprios. As janelas usam o mesmo nível nativo; portanto, a instância mostrada mais recentemente ou na qual o ponteiro entrou por último aparece à frente e pode se sobrepor às instâncias anteriores. Quando as janelas têm telas diferentes como destino, cada uma é centralizada no compartimento da câmera da respectiva tela. O macOS não coordena janelas de notch pertencentes a aplicativos diferentes; se aplicativos distintos mostrarem janelas no mesmo local e nível, a janela ordenada mais recentemente aparecerá à frente.

Em cargas de trabalho de notificações, os aplicativos normalmente reutilizam uma janela oculta ou mantêm a própria fila em uma única webview. O Wails não impõe enfileiramento, substituição, dispensa automática nem uma política de janela única.

Consulte o exemplo notch-notification de um monitor de sistema compacto cujo estado ativo do JavaScript persiste durante ciclos repetidos de exibição e ocultação de notificações.