TextSelection 是 SwiftUI 中用来控制文本选择行为的一个机制，它允许你指定视图中的文本是否可以被用户选中、复制或与其他系统功能交互。通过设置 TextSelection，你可以轻松启用或禁用文本的选择能力，从而满足不同平台和应用场景下对交互行为的要求。

1. 主要概念 #

• 选择性控制
  默认情况下，某些平台上的 Text 视图可能不支持文本选择（例如 iOS 上的 Text 视图通常不可选中），而在 macOS 上则可能默认可选。通过 TextSelection，你可以明确地启用或禁用文本选择行为。

• 统一应用
  当你在容器视图上应用了 TextSelection 修饰符，所有嵌套的文本内容都会继承这种选择行为，这使得在整个视图层次中统一管理文本选择变得简单。

2. 常用 API #

SwiftUI 提供了一个视图修饰符 textSelection(_:) 来控制文本选择。这个修饰符接收一个枚举值作为参数，该枚举通常包含以下两个选项：

• .enabled：允许文本被选中和复制。
• .disabled：禁止文本选择，用户无法对其进行选中操作。

示例代码 #

启用文本选择：

Text("这是一段可复制的文本")
    .textSelection(.enabled)

禁用文本选择：

Text("这是一段不可复制的文本")
    .textSelection(.disabled)

你也可以根据条件动态设置：

Text("条件控制文本选择")
    .textSelection(someCondition ? .enabled : .disabled)

3. 使用场景 #

• 复制与共享
  对于需要用户复制、分享或保存内容的应用场景，启用 TextSelection 能使用户直接选中文本，从而提高用户体验。

• 阅读与辅助功能
  在一些阅读器或文档类应用中，允许用户选中并复制文本是必需的，同时也有助于辅助功能的实现。

• 平台适配
  在 iOS 上默认文本通常不可选中，但有时你希望提供类似 macOS 那样的复制功能，这时可以使用 TextSelection(.enabled) 来实现。

• 全局控制
  当你需要在一个容器内统一控制所有文本的选择行为时，可以将 TextSelection 应用于容器视图，从而影响所有嵌套的 Text 视图。

4. 注意事项 #

• 平台差异
  不同平台（如 iOS 与 macOS）的默认文本选择行为可能不同，使用 TextSelection 能确保在所有平台上达到预期效果。

• 与其他修饰符配合
  TextSelection 只是一个控制交互行为的修饰符，可以与其他修饰符（如字体、颜色、布局修饰符）一起使用，不会相互干扰。

• 动态更新
  如果你的视图状态发生变化，并希望动态切换文本选择能力，也可以结合状态变量进行控制。

5. 总结 #

SwiftUI 的 TextSelection 通过提供一个简单的视图修饰符（textSelection(_:)），让开发者能够轻松控制视图中文本的选择行为。无论是启用文本复制，还是为阅读体验提供便利，都可以通过设置 .enabled 或 .disabled 来实现。它在跨平台应用开发中非常有用，确保不同平台上的用户都能获得符合预期的交互体验。