Disclosure controls

ComponentsMenus & Actions

Source: Apple Inc. Canonical content at https://developer.apple.com/design/human-interface-guidelines/disclosure-controls. 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.

Disclosure controls

Best practices

Use a disclosure control to hide details until they’re relevant.

Disclosure triangles

  • Collapsed
  • Expanded

Provide a descriptive label when using a disclosure triangle.

Disclosure buttons

  • Collapsed
  • Expanded

Place a disclosure button near the content that it shows and hides.

Use no more than one disclosure button in a single view.

Platform considerations

iOS, iPadOS, visionOS

Resources

Developer documentation

Videos


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

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.