Localized label identifying this Rotor to the user.
Instance Method
インスタンスメソッド
accessibility
accessibilityRotor(_:textRanges:)
Create an Accessibility Rotor with the specified user-visible label and entries for each of the specified ranges. The Rotor will be attached to the current Accessibility element, and each entry will go the specified range of that element.
Availability 有効性
- iOS 15.0+
- iPadOS 15.0+
- macOS 12.0+
- Mac Catalyst 15.0+
- tvOS 15.0+
- watchOS 8.0+
Technology
- Swift
UI
Declaration 宣言
func accessibilityRotor<L>(_ label: L, textRanges: [Range
<String
.Index
>]) -> some View
where L : StringProtocol
Parameters パラメータ
label
textRanges
An array of ranges that will be used to generate the entries of the Rotor.
Discussion 議論
An Accessibility Rotor is a shortcut for Accessibility users to quickly navigate to specific elements of the user interface, and optionally specific ranges of text within those elements.
In the following example, a Message application adds a Rotor allowing the user to navigate through all the ranges of text containing email addresses.
extension Message {
// Ranges of special areas in the `content` text. Calculated
// when `content` is set and then cached so that we don't have
// to re-compute them.
var emailAddressRanges: [Range<String.Index>]
}
struct MessageContentView: View {
TextEditor(.constant(message.content))
.accessibilityRotor("Email Addresses",
textRanges: message.emailAddressRanges)
}