prefersHeadAnchorAlternative
Category: Type Property
Platforms: visionOS 2.0+
Overview
A Boolean value that indicates the person’s preference for content that follows their head position.
Declaration
static var prefersHeadAnchorAlternative: Bool { get }
Details
See Also
- Head-anchored content
-
static var prefersHeadAnchorAlternativeDidChangeNotification: Notification.Name
-
Accessibility
- AccessibilitySettings
- prefersHeadAnchorAlternative
prefers Head Anchor Alternative
Discussion
The value of this property is true if the person doesn’t want content anchored to their head position, or false if anchoring content to the head position is acceptable.
On Apple Vision Pro, apps can create a heads-up display effect by setting up content to follow the person’s head position. This effect allows the content to remain in the same position, no matter where the person looks. However, some assistive technologies are incompatible with this type of content. For example, a technology might use the person’s head movements to control the current selection. Anchoring content to the head position prevents affected technologies from interacting with that content.
If your app contains head-anchored content, call this function before you display that content. If the function returns true , find alternate ways to display your content. For example, display it in a regular window.
Topics (Grouped)
Head-anchored content
- varprefersHeadAnchorAlternativeDidChangeNotification:Notification.Name — static; A notification that posts when the system setting for head-anchored content changes.
Code Examples
static var prefersHeadAnchorAlternative: Bool { get }