Scarriffle/onyx
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Inhalt beginnt unterhalb der Notch statt dahinter

Browse Source 
Das Panel reichte oben bündig an die Bildschirmkante, damit seine Fläche mit
der schwarzen Notch-Hardware zu einem Körper verschmilzt. Die Notch ist aber
undurchsichtig — die obersten 38 pt Inhalt waren schlicht nicht zu sehen. Links
und rechts daneben liegt in diesem Streifen zusätzlich die Menüleiste, der ganze
Streifen ist also unbrauchbar.

Die Fläche bleibt deshalb, wo sie war; nur der Inhalt rückt nach unten. Das
Fenster wächst entsprechend mit (446x340 → 446x378), damit unten nichts
abgeschnitten wird.

Der Controller nimmt jetzt die Inhaltsgröße entgegen und schlägt den Freiraum
selbst auf. Keine Aufrufstelle muss daran denken, und beim Wechsel zwischen
eingebautem Display (38 pt) und externem (virtueller Balken) wandert der
Freiraum automatisch mit.

Gegengemessen statt geschätzt: die Zentrierung war korrekt (Panel-midX 900 =
Notch-midX 900), der Fehler lag allein in der Höhe. Vier Tests halten den
Inhaltsbereich jetzt außerhalb der Notch fest, auch für den virtuellen Balken.

70 Tests grün.
This commit is contained in:
Guido Schmit
2026-08-10 17:43:30 +02:00
parent 8e0629d3a5
commit 65f9fbfa4e
5 changed files with 97 additions and 11 deletions
Download Patch File Download Diff File Expand all files Collapse all files

16
Packages/OnyxKit/Sources/OnyxNotch/NotchGeometry.swift
View File

@@ -118,6 +118,22 @@ public struct NotchGeometry: Equatable, Sendable {
.clamped(to: screenFrame)
}
/// Der Bereich, in dem Inhalt tatsächlich zu sehen ist.
///
/// Das Panel reicht bis an die Bildschirmoberkante, damit seine Fläche mit
/// der schwarzen Notch zu einem Körper verschmilzt. Die Notch ist aber
/// undurchsichtig — was dort steht, ist weg. Auch links und rechts daneben
/// liegt in diesem Streifen die Menüleiste. Der nutzbare Bereich beginnt
/// deshalb vollständig unterhalb.
public func contentRect(for contentSize: CGSize) -> CGRect {
let full = panelRect(for: CGSize(width: contentSize.width,
height: contentSize.height + rect.height))
return CGRect(x: full.minX,
y: full.minY,
width: full.width,
height: max(full.height - rect.height, 0))
}
/// Wohin das Panel gehört: auf die Notch zentriert, oben bündig mit dem
/// Bildschirmrand — es wächst aus der Notch heraus, statt darunter zu schweben.
public func panelRect(for size: CGSize) -> CGRect {

18
Packages/OnyxKit/Sources/OnyxNotch/NotchPresentation.swift
View File

@@ -14,9 +14,18 @@ public final class NotchPresentation {
public var collapsedSize: CGSize
public var expandedSize: CGSize
public init(collapsedSize: CGSize, expandedSize: CGSize) {
/// Wie weit der Inhalt von oben wegbleiben muss.
///
/// Die Fläche reicht bis an die Bildschirmoberkante, damit sie mit der
/// schwarzen Notch-Hardware zu einem Körper verschmilzt. Die Notch ist aber
/// undurchsichtig: alles, was in diesen obersten Punkten steht, ist schlicht
/// nicht zu sehen. Der Inhalt beginnt deshalb darunter.
public var contentTopInset: CGFloat
public init(collapsedSize: CGSize, expandedSize: CGSize, contentTopInset: CGFloat) {
self.collapsedSize = collapsedSize
self.expandedSize = expandedSize
self.contentTopInset = contentTopInset
}
/// Wie lange das Einfahren braucht, bis das Fenster gefahrlos verschwinden darf.
@@ -60,7 +69,12 @@ public struct NotchContainer<Content: View>: View {
.overlay(alignment: .top) {
content
.frame(width: presentation.expandedSize.width,
height: presentation.expandedSize.height)
height: presentation.expandedSize.height
- presentation.contentTopInset,
alignment: .top)
// Freiraum für die Notch. Padding statt Offset, damit
// der Inhalt auch beim Messen die richtige Höhe hat.
.padding(.top, presentation.contentTopInset)
.opacity(presentation.isExpanded ? 1 : 0)
// Ein Hauch von oben herangleiten — genug, um Richtung zu
// geben, zu wenig, um als Bewegung aufzufallen.

31
Packages/OnyxKit/Sources/OnyxNotch/NotchScreenController.swift
View File

@@ -19,24 +19,35 @@ public final class NotchScreenController {
/// Entfernt das Fenster erst, wenn das Einfahren zu Ende ist.
private var teardownTimer: DispatchWorkItem?
/// Größe des ausgefahrenen Panels. Ab Phase 2 liefert das die Layout-Engine.
public var expandedSize: CGSize {
/// Größe des **Inhalts**, nicht des Fensters. Die Layout-Engine liefert sie;
/// den Freiraum für die Notch schlägt der Controller selbst auf, damit keine
/// Aufrufstelle daran denken muss.
public var contentSize: CGSize {
didSet {
guard expandedSize != oldValue else { return }
guard contentSize != oldValue else { return }
presentation.expandedSize = expandedSize
layoutPanel()
}
}
/// Fenstergröße: Inhalt plus der von der Notch verdeckte Streifen.
private var expandedSize: CGSize {
CGSize(width: contentSize.width, height: contentSize.height + geometry.rect.height)
}
public init(metrics: ScreenMetrics,
virtualSize: CGSize,
expandedSize: CGSize = CGSize(width: 640, height: 320),
contentSize: CGSize = CGSize(width: 640, height: 320),
makeContent: (NotchPresentation) -> NSView) {
self.displayID = metrics.displayID
self.geometry = NotchGeometry.resolve(metrics, virtualSize: virtualSize)
self.expandedSize = expandedSize
self.presentation = NotchPresentation(collapsedSize: geometry.rect.size,
expandedSize: expandedSize)
let geometry = NotchGeometry.resolve(metrics, virtualSize: virtualSize)
self.geometry = geometry
self.contentSize = contentSize
self.presentation = NotchPresentation(
collapsedSize: geometry.rect.size,
expandedSize: CGSize(width: contentSize.width,
height: contentSize.height + geometry.rect.height),
contentTopInset: geometry.rect.height)
self.panel = NotchPanel(contentRect: .zero)
panel.contentView = makeContent(presentation)
layoutPanel()
@@ -66,6 +77,10 @@ public final class NotchScreenController {
public func update(metrics: ScreenMetrics, virtualSize: CGSize) {
geometry = NotchGeometry.resolve(metrics, virtualSize: virtualSize)
presentation.collapsedSize = geometry.rect.size
// Beim Wechsel zwischen eingebautem Display (38 pt Notch) und externem
// (virtueller Balken) ändert sich der Freiraum mit.
presentation.contentTopInset = geometry.rect.height
presentation.expandedSize = expandedSize
layoutPanel()
}

41
Packages/OnyxKit/Tests/OnyxNotchTests/NotchGeometryTests.swift
View File

@@ -131,6 +131,47 @@ struct NotchGeometryTests {
#expect(panel.maxY == 1440)
}
// MARK: - Sichtbarer Inhaltsbereich
//
// Die Notch ist undurchsichtig. Ein Panel, dessen Oberkante am Bildschirmrand
// liegt, verliert dort alles, was gezeichnet wird — genau der Fehler, der in
// der ersten lauffähigen Fassung sichtbar wurde.
@Test("Der Inhaltsbereich liegt vollständig unterhalb der Notch")
func contentClearsTheNotch() {
let g = NotchGeometry.resolve(Self.builtIn, virtualSize: Self.virtualSize)
let content = g.contentRect(for: CGSize(width: 446, height: 340))
#expect(!content.intersects(g.rect))
#expect(content.maxY <= g.rect.minY)
}
@Test("Der Inhaltsbereich behält die angeforderte Höhe — nichts geht verloren")
func contentKeepsRequestedHeight() {
let g = NotchGeometry.resolve(Self.builtIn, virtualSize: Self.virtualSize)
let content = g.contentRect(for: CGSize(width: 446, height: 340))
#expect(content.height == 340)
#expect(content.width == 446)
}
@Test("Das Fenster darüber reicht bis an die Bildschirmkante, damit es mit der Notch verschmilzt")
func panelStillReachesScreenTop() {
let g = NotchGeometry.resolve(Self.builtIn, virtualSize: Self.virtualSize)
let panel = g.panelRect(for: CGSize(width: 446, height: 340 + g.rect.height))
#expect(panel.maxY == Self.builtIn.frame.maxY)
}
@Test("Auf einem externen Display gilt dasselbe für den virtuellen Balken")
func contentClearsVirtualNotch() {
let g = NotchGeometry.resolve(Self.external, virtualSize: Self.virtualSize)
let content = g.contentRect(for: CGSize(width: 446, height: 340))
#expect(!content.intersects(g.rect))
#expect(content.height == 340)
}
@Test("Zu hohes Panel wird auf die Bildschirmhöhe begrenzt")
func panelClampsHeight() {
let g = NotchGeometry.resolve(Self.builtIn, virtualSize: Self.virtualSize)