Eyes

InputsInputs

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

Eyes

Best practices

Always give people multiple ways to interact with your app.

Design for visual comfort.

Place content at a comfortable viewing distance.

Prefer using standard UI components.

Making items easy to see

Minimize visual distractions.

Make it easy for people to look at an item by providing enough space around it.

Avoid using a repeating pattern or texture that fills the field of view.

Encouraging interaction

Consider using subtle visual cues to encourage people to look at the item they’re most likely to want.

In general, give an interactive item a rounded shape.

If you create an interactive component that consists of more than one element, be sure to provide an overall containing shape that visionOS can highlight.

Custom hover effects

Prefer using a custom hover effect to emphasize or enhance a special moment in your experience.

Choose the right delay.

  • No delay (default). A custom hover effect that appears without delay tends to be especially useful when the effect is subtle or invites interaction, like when a knob appears on a slider.

  • Short delay. Consider using a short delay to let people look at an element and quickly interact with it without waiting for the effect to appear; for example, the expansion of tabs in a tab bar works this way.

  • Long delay. If your custom hover effect shows additional information, like when a tooltip appears below a button, a slightly longer delay can work well because most people won’t need to view the additional information every time.

Aim to keep one or more of the element’s primary views unchanged in both states of a custom hover effect.

Thoroughly test custom hover effects.

Platform considerations

Resources

Developer documentation

Videos

Change log


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

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.