Sheets

ComponentsDialogs

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.

Resources

Developer documentation

Change log


For the complete guidance, including worked examples and illustrations, see the canonical page: https://developer.apple.com/design/human-interface-guidelines/sheets

Get HIG guidance in your AI

Install Apple HIG Skills and get expert design guidance directly in Claude Code.

npx skills add raintree-technology/apple-hig-skills
Email updates aren't configured on this deployment yet. Follow the GitHub repo (opens in new tab) for updates.