Swift Optional accessibilityRotor(_:textRanges:)用法及代码示例

用法一

实例方法

accessibilityRotor(_:textRanges:)

使用指定的 user-visible 标签和每个指定范围的条目创建一个辅助函数转子。转子将附加到当前的辅助函数元素，每个条目将进入该元素的指定范围。

声明

func accessibilityRotor(
    _ labelKey: LocalizedStringKey,
    textRanges: [Range<String.Index>]
) -> some View

参数

labelKey: 向用户标识此转子的本地化标签。
textRanges: 将用于生成转子条目的范围数组。

详述

辅助函数转子是辅助函数用户快速导航到用户接口的特定元素以及这些元素中的特定文本范围的快捷方式。

在以下示例中，消息应用程序添加了一个转子，允许用户浏览包含电子邮件地址的所有文本范围。


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)
}

可用版本

iOS 15.0+, iPadOS 15.0+, macOS 12.0+, Mac Catalyst 15.0+, tvOS 15.0+, watchOS 8.0+

用法二

实例方法

accessibilityRotor(_:textRanges:)

使用指定的 user-visible 标签和每个指定范围的条目创建一个辅助函数转子。转子将附加到当前的辅助函数元素，每个条目将进入该元素的指定范围。

声明

func accessibilityRotor(
    _ label: Text,
    textRanges: [Range<String.Index>]
) -> some View

参数

label: 向用户标识此转子的本地化标签。
textRanges: 将用于生成转子条目的范围数组。

详述

辅助函数转子是辅助函数用户快速导航到用户接口的特定元素以及这些元素中的特定文本范围的快捷方式。

在以下示例中，消息应用程序添加了一个转子，允许用户浏览包含电子邮件地址的所有文本范围。


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)
}

可用版本

iOS 15.0+, iPadOS 15.0+, macOS 12.0+, Mac Catalyst 15.0+, tvOS 15.0+, watchOS 8.0+

用法三

实例方法

accessibilityRotor(_:textRanges:)

创建一个可访问性转子来替换指定的系统提供的转子。转子将附加到当前的辅助函数元素，每个条目将进入该元素的指定范围。

声明

func accessibilityRotor(
    _ systemRotor: AccessibilitySystemRotor,
    textRanges: [Range<String.Index>]
) -> some View

参数

systemRotor: 将被此自定义转子覆盖的系统提供的转子。
textRanges: 将用于生成转子条目的范围数组。

详述

辅助函数转子是辅助函数用户快速导航到用户接口的特定元素以及这些元素中的特定文本范围的快捷方式。

在以下示例中，消息应用程序添加了一个转子，允许用户浏览包含标题的所有文本范围。


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 headingRanges: [Range<String.Index>]
}


struct MessageContentView: View {
    TextEditor(.constant(message.content))
        .accessibilityRotor(
            .heading,
            textRanges: message.headingRanges
        )
}

可用版本

iOS 15.0+, iPadOS 15.0+, macOS 12.0+, Mac Catalyst 15.0+, tvOS 15.0+, watchOS 8.0+

用法四

实例方法

accessibilityRotor(_:textRanges:)

使用指定的 user-visible 标签和每个指定范围的条目创建一个辅助函数转子。转子将附加到当前的辅助函数元素，每个条目将进入该元素的指定范围。

声明

func accessibilityRotor<L>(
    _ label: L,
    textRanges: [Range<String.Index>]
) -> some View where L : StringProtocol

参数

label: 向用户标识此转子的本地化标签。
textRanges: 将用于生成转子条目的范围数组。

详述

辅助函数转子是辅助函数用户快速导航到用户接口的特定元素以及这些元素中的特定文本范围的快捷方式。

在以下示例中，消息应用程序添加了一个转子，允许用户浏览包含电子邮件地址的所有文本范围。


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)
}

可用版本

iOS 15.0+, iPadOS 15.0+, macOS 12.0+, Mac Catalyst 15.0+, tvOS 15.0+, watchOS 8.0+

相关用法

注：本文由纯净天空筛选整理自apple.com大神的英文原创作品 Optional accessibilityRotor(_:textRanges:)。非经特殊声明，原始代码版权归原作者所有，本译文未经允许或授权，请勿转载或复制。