Source: Apple Inc. Canonical content at https://developer.apple.com/design/human-interface-guidelines/sheets. This file is a structured index of that content, snapshot 2025-02-02. Apple HIG text and imagery are © Apple Inc.; this repository provides organization and cross-referencing for AI agent consumption only.
Sheets
Best practices
Use a sheet to present simple content or tasks.
For complex or prolonged user flows, consider alternatives to sheets.
Display only one sheet at a time from the main interface.
Use a nonmodal view when you want to present supplementary items that affect the main task in the parent view.
Platform considerations
iOS, iPadOS
In an iPhone app, consider supporting the medium detent to allow progressive disclosure of the sheet’s content.
Include a grabber in a resizable sheet.
Support swiping to dismiss a sheet.
Position Done and Cancel buttons as people expect.
Prefer using the page or form sheet presentation styles in an iPadOS app.
macOS
Present a sheet in a reasonable default size.
Let people interact with other app windows without first dismissing a sheet.
Position a sheet’s dismiss buttons as people expect.
Use a panel instead of a sheet if people need to repeatedly provide input and observe results.
visionOS
Avoid displaying a sheet that emerges from the bottom edge of a window.
Present a sheet in a default size that helps people retain their context.
watchOS
Use a sheet only when your modal task requires a custom title or custom content presentation.
Keep sheet interactions brief and occasional.
Change the default label of the dismiss control only if it makes sense in your app.
If you change the default label, prefer using SF Symbols to represent the action.
<!-- hig-doctor:canonical-footer -->
For the complete guidance, including worked examples and illustrations, see the canonical page: https://developer.apple.com/design/human-interface-guidelines/sheets