WindowTreatment is a small set of classes and extensions to aid in working with
NSWindow and its associated functions.
Swift Package Manager:
dependencies: [ .package(url: "https://github.com/ChimeHQ/WindowTreatment") ]
A simple container view that makes it much easier to correctly position content under the titlebar of a host
NSWindow. This turns out to be a fairly esoteric thing to do, but can be essential when your
NSWindow has a transparent titlebar.
let titlebarAwareView = WindowTitlebarAwareView() // myView will always be correctly position below the containing window's // titlebar region, and react accordingly if the titlebar size/state changes titlebarAwareView.contentView = myView // ...
A wrapper controller useful in cases where you need to use
WindowTitlebarAwareView with a system that only accepts
Wrappers around observation of
NSWindow states for
main, and tabbing. Very useful for UI updates in response to these changes. Particularly for tab state, which is very challenging to observe correctly in all cases.
Super-simple class that uses
WindowStateObserver and provides a nice base for
NSView subclasses that need to change their appearance depending on host window main/key state.
A class that tracks changes in the application's windows, simplifying logic that depends on the state of all windows.
// simple method to size a window to pleasing dimensions relative to its screen window.makeReasonableSize()
Title bar transparency helpers:
// This method also handles the height adjustments needed when removing transparency window.titlebarTransparentWithFullSizeContent = true window.usesFullSizeContentView = true
self.windowIsMain self.windowIsKey self.windowIsOnActiveSpace
SwiftUI View Modifiers
windowStateEnvironment() // makes WindowStateKey available in the environment
Suggestions or Feedback
We'd love to hear from you! Get in touch via twitter, an issue, or a pull request.
Please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms.