노치 창

NewNotchWindow은 카메라 하우징에 부착되는 형태가 지정된 macOS 패널을 만듭니다. 이 패널은 애플리케이션을 활성화하지 않습니다. Wails는 네이티브 배치, 검은색 연결 날개, 투명한 외부 캔버스, 창 레벨, Spaces 동작 및 선택적인 표시·숨기기 애니메이션을 관리합니다. 웹 콘텐츠는 요청한 내부 사각형 영역만 차지합니다. 포인터를 창 안으로 이동하면 애플리케이션을 활성화하지 않고도 해당 webview가 즉시 키 입력을 받을 수 있는 상태가 됩니다.

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

옵션

NewNotchWindow은 외부 크기, 위치, 프레임, 투명도, 크기 조절 정책, 네이티브 패널 클래스, 창 레벨 및 컬렉션 동작을 관리합니다. WindowOptions에 있는 해당 필드의 값은 의도적으로 대체됩니다. 다른 필드는 유지됩니다. 창이 카메라 하우징에 부착된 상태를 유지하도록 네이티브 배경 드래그와 CSS 드래그 영역은 비활성화됩니다.

반환된 NotchWindow은 의도적으로 Show, Hide, Visibility 및 Close만 노출하며, 고수준 핸들을 통해 네이티브 지오메트리를 변경할 수 없습니다.

수명 주기

• Show은 기존 네이티브 창을 표시합니다. 애니메이션을 활성화하면 창이 디스플레이 위쪽에서 아래로 슬라이드됩니다.
• Hide은 재사용할 수 있도록 창을 유지합니다. 애니메이션을 활성화하면 창을 화면에서 제외하기 전에 디스플레이 위쪽으로 다시 슬라이드합니다. webview, JavaScript 상태, 바인딩 및 이벤트 리스너는 로드된 상태로 유지되지만 숨겨진 창에는 호버 대상이 없습니다. 다시 표시하려면 애플리케이션에서 Show을 호출해야 합니다.
• Visibility은 현재 네이티브 표시 상태를 보고합니다.
• Close은 네이티브 창을 영구적으로 제거합니다. 해당 알림을 다시 표시하기 전에 새 창을 만드세요.
• 포인터가 진입하면 애플리케이션을 활성화하지 않는 패널 동작을 유지하면서 해당 노치 창을 맨 앞으로 가져오고 webview에 포커스를 설정하여 즉시 키보드로 조작할 수 있게 합니다.

NewNotchWindow을 호출할 때마다 자체 콘텐츠, 표시 상태 및 애니메이션 상태를 가진 독립적인 창이 생성됩니다. 창은 동일한 네이티브 레벨을 사용하므로 가장 최근에 표시되었거나 포인터가 진입한 인스턴스가 맨 앞에 나타나며 이전 인스턴스를 덮을 수 있습니다. 창이 서로 다른 화면을 대상으로 하면 각 창은 해당 화면의 카메라 하우징을 기준으로 중앙에 배치됩니다. macOS는 서로 다른 애플리케이션에 속한 노치 창을 조정하지 않습니다. 별도의 앱이 같은 위치와 레벨에 창을 표시하면 가장 최근에 화면에 배치된 창이 맨 앞에 나타납니다.

알림 용도의 경우 애플리케이션은 일반적으로 숨겨진 창을 재사용하거나 하나의 webview에서 자체 큐를 유지합니다. Wails는 큐잉, 교체, 자동 닫기 또는 단일 창 정책을 강제하지 않습니다.

알림을 반복해서 표시하고 숨겨도 실시간 JavaScript 상태가 유지되는 간결한 시스템 모니터는 notch-notification 예제를 참조하세요.