WindowTreatment

2.3.0

Tools for happier work with NSWindow
ChimeHQ/WindowTreatment

What's New

v2.3.0

2023-08-21T11:18:31Z
  • new observeCurrentWindow and observeWindowState view modifiers
  • deprecate windowStateEnvironment

Build Status License Platforms

WindowTreatment

WindowTreatment is a small set of classes and extensions to aid in working with NSWindow and its associated functions.

Integration

Swift Package Manager:

dependencies: [
    .package(url: "https://github.com/ChimeHQ/WindowTreatment")
]

SwiftUI View Modifiers

observeCurrentWindow() // puts the current window object into the environment
observeWindowState()   // makes WindowStateKey available in the environment

Classes

WindowTitlebarAwareView

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
// ...

WindowTitlebarAwareViewController

A wrapper controller useful in cases where you need to use WindowTitlebarAwareView with a system that only accepts NSViewControllers, like NSSplitViewController.

WindowStateObserver

Wrappers around observation of NSWindow states for key, 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.

WindowStateAwareView

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.

ApplicationWindowState

A class that tracks changes in the application's windows, simplifying logic that depends on the state of all windows.

NSWindow Extensions

Sizing conveniences:

// 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

NSView Extensions

Window state:

self.windowIsMain
self.windowIsKey
self.windowIsOnActiveSpace

Suggestions or Feedback

We'd love to hear from you! Get in touch via an issue or 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.

Description

  • Swift Tools 5.0.0
View More Packages from this Author

Dependencies

  • None
Last updated: Sat Oct 19 2024 02:30:15 GMT-0900 (Hawaii-Aleutian Daylight Time)