# AccessibilityFocusState A property wrapper type that can read and write a value that SwiftUI updates as the focus of any active accessibility technology, such as VoiceOver, changes. ``` @propertyWrapper @frozen struct AccessibilityFocusState where Value : Hashable ``` ## Overview Use this capability to request that VoiceOver or other accessibility technologies programmatically focus on a specific element, or to determine whether VoiceOver or other accessibility technologies are focused on particular elements. Use [`accessibilityFocused(_:equals:)`](/documentation/SwiftUI/View/accessibilityFocused(_:equals:)) or [`accessibilityFocused(_:)`](/documentation/SwiftUI/View/accessibilityFocused(_:)) in conjunction with this property wrapper to identify accessibility elements for which you want to get or set accessibility focus. When accessibility focus enters the modified accessibility element, the framework updates the wrapped value of this property to match a given prototype value. When accessibility focus leaves, SwiftUI resets the wrapped value of an optional property to `nil` or the wrapped value of a Boolean property to `false`. Setting the property’s value programmatically has the reverse effect, causing accessibility focus to move to whichever accessibility element is associated with the updated value. In the example below, when `notification` changes, and its `isPriority` property is `true`, the accessibility focus moves to the notification `Text` element above the rest of the view’s content: ``` struct CustomNotification: Equatable { var text: String var isPriority: Bool } struct ContentView: View { @Binding var notification: CustomNotification? @AccessibilityFocusState var isNotificationFocused: Bool var body: some View { VStack { if let notification = self.notification { Text(notification.text) .accessibilityFocused($isNotificationFocused) } Text("The main content for this view.") } .onChange(of: notification) { notification in if (notification?.isPriority == true) { isNotificationFocused = true } } } } ``` To allow for cases where accessibility focus is completely absent from the tree of accessibility elements, or accessibility technologies are not active, the wrapped value must be either optional or Boolean. Some initializers of `AccessibilityFocusState` also allow specifying accessibility technologies, determining to which types of accessibility focus this binding applies. If you specify no accessibility technologies, SwiftUI uses an aggregate of any and all active accessibility technologies. ## Topics ### Creating a focus state [`init()`](/documentation/SwiftUI/AccessibilityFocusState/init()) Creates a new accessibility focus state for a Boolean value. [`init(for:)`](/documentation/SwiftUI/AccessibilityFocusState/init(for:)) Creates a new accessibility focus state for a Boolean value, using the accessibility technologies you specify. ### Getting the state [`projectedValue`](/documentation/SwiftUI/AccessibilityFocusState/projectedValue) A projection of the state value that can be used to establish bindings between view content and accessibility focus placement. [`wrappedValue`](/documentation/SwiftUI/AccessibilityFocusState/wrappedValue) The current state value, taking into account whatever bindings might be in effect due to the current location of focus. [`AccessibilityFocusState.Binding`](/documentation/SwiftUI/AccessibilityFocusState/Binding) --- Copyright © 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)