{"id":52315,"date":"2026-06-18T14:56:11","date_gmt":"2026-06-18T18:56:11","guid":{"rendered":"https:\/\/mjtsai.com\/blog\/?p=52315"},"modified":"2026-06-18T14:56:41","modified_gmt":"2026-06-18T18:56:41","slug":"appkit-in-macos-27","status":"publish","type":"post","link":"https:\/\/mjtsai.com\/blog\/2026\/06\/18\/appkit-in-macos-27\/","title":{"rendered":"AppKit in macOS 27"},"content":{"rendered":"

macOS Golden Gate 27 Beta Release Notes<\/a>:<\/p>\n

\n

AppKit adds NSRefreshController<\/code>, providing pull-to-refresh functionality for NSScrollView<\/code>.<\/p>\n

[…]<\/p>\n

NSToolbarItemGroup<\/code> adds the role<\/code> property and the NSToolbarItemGroupRole<\/code> enum, allowing toolbar item groups to be tagged with a semantic role. NSSegmentedControl<\/code> similarly adds a role<\/code> property and the NSSegmentedControlRole<\/code> enum, including a tabs<\/code> role for controls that represent tab-based navigation and content selection.<\/p>\n

[…]<\/p>\n

NSTextSelectionManager<\/code> provides common text selection interactions (click, drag, shift-click, double\/triple-click word\/line\/paragraph selection) to a NSView<\/code> with a set of NSGestureRecognizers<\/code> rather than overriding NSEvent<\/code> mouse methods. NSTextView<\/code> now uses NSTextSelectionManager<\/code> and provides its own set of NSGestureRecognizers<\/code> to provide additional features in addition to text selection.<\/p>\n

[…]<\/p>\n

By default, NSMenu<\/code> hides all menu item symbol images — non-symbol images remain visible. […] Use the new preferredImageVisibility<\/code> property on NSMenuItem<\/code> to customize the image visibility for your menu items. As in macOS 26.0, NSMenu<\/code> automatically provides default visible menu item images for certain common system-wide menu items, such as Settings, Share, and Print.<\/p>\n<\/blockquote>\n\n

AppKit updates<\/a>:<\/p>\n

\n

Create events similar to UIControl<\/code> events on NSControl<\/code><\/a> with the new NSControl.Events<\/code><\/a> type.<\/p>\n

[…]<\/p>\n

Initiate a drag operation from a gesture recognizer using the new beginDraggingSession(items:gesture:source:)<\/code><\/a> method on NSView<\/code><\/a>.<\/p>\n

[…]<\/p>\n

Update views automatically in response to Observable<\/code><\/a> model changes using the guidance in Updating views automatically with observation tracking<\/a>.<\/p>\n<\/blockquote>\n\n

How is this different from what was announced last year<\/a>?<\/p>\n\n

Modernize your AppKit app<\/a>:<\/p>\n

\n

Bring your AppKit app up to date with modern macOS conventions. Dive into handling input with control events and gesture recognizers, moving beyond traditional tracking loops. Enhance keyboard navigation in your app, implement graceful state restoration after restarts, and take advantage of new corner concentricity APIs that let your interface blend seamlessly with the macOS aesthetic.<\/p>\n<\/blockquote>\n\n

Steve Troughton-Smith<\/a>:<\/p>\n

\n

To summarize the singular AppKit session this year: hey remember all these APIs and design patterns from UIKit? Well they’re now in AppKit and you should use them! Also make your glass use interactive bounce effects.<\/p>\n

Why? No reason!😉<\/p>\n<\/blockquote>\n\n

TN3212<\/a>:<\/p>\n

\n

In macOS 27, AppKit continues to standardize on gesture recognizers as the primary mechanism for input handling. This change directly affects Sidecar because gesture recognizers are the only way to respond to touch input from a Sidecar-connected iPad running iPadOS 27. If your app relies on tracking loops for mouse event handling, migrate to gesture recognizers to support Sidecar touch input.<\/p>\n

This article explains how the gesture recognizer model works, how to implement gesture recognizers correctly for Sidecar touch input, how to update your existing event-handling code, and which APIs macOS 27 adds. Codebases that implement nextEvent(matching:)<\/code><\/a> or mouseDown(with:)<\/code><\/a>, mouseDragged(with:)<\/code><\/a>, and mouseUp(with:)<\/code><\/a> events are most affected by the updates discussed.<\/p>\n<\/blockquote>\n\n

Greg Pierce<\/a>:<\/p>\n

\n

After the AppKit session blindsided me a bit after telling me not to override mouseDown<\/code>, and then telling me I should override hitTest<\/code><\/p>\n<\/blockquote>\n\n

Mario Guzmán<\/a>:<\/p>\n

\n

A few years ago, Apple introduced:<\/p>\n

func tableView(_ tableView: NSTableView, userCanChangeVisibilityOf column: NSTableColumn) -> Bool<\/pre>\n
for NSTableView<\/code>, which Is a native way users could control-click on a TableView column to show\/hide columns.<\/p>\n
This year, in #macOS27, they updated it to have a new “Reset to Defaults” option.<\/p>\n
This is awesome bc I have done my own implementation of this feature JUST to have the option to “reset all columns” and now Apple just includes it!<\/p>\n<\/blockquote>\n\n
Elevate your app’s text experience with TextKit<\/a>:<\/p>\n
\n
Discover how to combine the convenience of built-in text views with the control of TextKit. We’ll show you how new APIs make it easy to extend UITextView<\/code> and NSTextView<\/code> with custom behaviors like line numbers and collapsible sections. We’ll also explore the TextKit architecture and walk through new caching and reuse policies for text attachments.<\/p>\n<\/blockquote>\n\n
Previously:<\/p>\n