---
title: "ShelfWidgetNotchWrapTraits, DroppyKit"
description: "How a widget&#x27;s header row wraps around the camera, declared in notchWrap."
canonical: "https://getdroppy.app/docs/droppykit/api/shelf-widget-notch-wrap-traits"
last-updated: "2026-09-09"
---

# ShelfWidgetNotchWrapTraits

How a widget's header row wraps around the camera, declared in notchWrap.

`struct ShelfWidgetNotchWrapTraits`

On a Mac with a notch, a widget that has the shelf to itself can rise into the two bands beside the camera, the way Droppy's own Notes, Pomodoro and Calendar do: its top row splits, one part left of the notch and one right of it, and everything under that row starts below the camera. The shelf gets shorter by roughly the row's height. The camera island wraps the same way around its camera pill (1.22.0): the island's own walls stand at the card's sides and the bands run to the pill plus the 6pt Droppy keeps clear of it, 70 points in the middle on the 16-inch MacBook Pro.

Declare the height of the header row as your classic layout draws it, inside [`contentInsets`](https://getdroppy.app/docs/droppykit/api/shelf-widget-context#content-insets), and the narrowest band its two halves still fit in. When the host wraps the widget, it tells the mount through [`notchWrap`](https://getdroppy.app/docs/droppykit/api/shelf-widget-context#notch-wrap); when that is `nil` (a grouped row, the Dynamic Island on a display without a camera cutout, an external display, a band narrower than you asked for, a host older than 1.21.0) lay the widget out exactly as before. The host grows the widget's rectangle by what the wrapped row adds over `headerHeight`, so a fixed content height stays the classic one.

## Initializers

### init(headerHeight:besideExtent:)

`init(headerHeight: CGFloat, besideExtent: CGFloat)`

Creates the declaration (1.26.0).

Compiled into the droplet and forwarded to the 1.21.0 initializer, so it needs no newer host: a droplet that declares `minAPI` 1.21.0 or later spells it this way with no availability check.

- Parameters:
- headerHeight: The classic header row's height.
- besideExtent: How far the wider half reaches from the card's edge, labels included.

### init(headerHeight:minimumBandWidth:)

`init(headerHeight: CGFloat, minimumBandWidth: CGFloat = 56)`

Creates the declaration under the old band name (1.21.0).

Superseded by `init(headerHeight:besideExtent:)` in 1.26.0, which takes the same number under the name the host's rule uses. Kept, unchanged, for droplets already built with it.

## Properties

### besideExtent

`var besideExtent: CGFloat { get }`

How far the wider of the row's two halves reaches from the card's edge, where a wrapped row starts (a wrapped context's [`contentInsets`](https://getdroppy.app/docs/droppykit/api/shelf-widget-context#content-insets) are zero), labels included (1.26.0).

A host from 1.26.0 on wraps the row when [`fitsBesideCutout(surfaceWidth:cutoutWidth:besideExtent:)`](https://getdroppy.app/docs/droppykit/api/droplet-cutout-wrap#fits-beside-cutout-surface-width-cutout-width-beside-extent) says this fits beside the cutout on the display in hand, the one rule every surface of Droppy's own uses, and otherwise keeps the classic layout: the row starts just under the cutout. Declare what the halves need to show whole: a control that only fits by dropping its label needs the wider number, so the row hangs under a MacBook's notch instead of losing it (a title may still shorten). Hosts before 1.26.0 wrap when the band is at least the larger of this and 64 points.

Compiled into the droplet (it reads the 1.21.0 property), so it needs no newer host.

### headerHeight

`let headerHeight: CGFloat`

The classic header row's height, inside the content insets.

### minimumBandWidth

`let minimumBandWidth: CGFloat`

The number the host's wrap rule takes, under its 1.21.0 name: how far the wider of the row's two halves reaches. Read `besideExtent`.
