Flutter中如何通过代码清除SelectableText.rich的选中状态？

方法一：通过FocusNode控制焦点（推荐） #

利用焦点与文本选中状态的关联，当SelectableText失去焦点时，选中状态会自动清除。具体实现步骤如下：

1. 在父有状态组件中定义FocusNode：

final FocusNode _selectableTextFocusNode = FocusNode();

2. 将FocusNode绑定到SelectableText.rich组件：

return SelectableText.rich(
  TextSpan(
    children: doc.allSpans
        .map(
          (e) => TextSpan(
            text: e.text,
            style: TextStyle(
              color: Colors.black,
              fontWeight: e.style.contains("bold") ? FontWeight.bold : null,
              fontStyle: e.style.contains("italic") ? FontStyle.italic : null,
              decoration: e.style.contains("underline") ? TextDecoration.underline : null,
              fontSize: 18,
            ),
          ),
        )
        .toList(),
  ),
  onSelectionChanged: onSelectionChanged,
  enableInteractiveSelection: selectionEnabled,
  focusNode: _selectableTextFocusNode, // 绑定焦点节点
);

3. 用GestureDetector包裹页面根布局，监听外部点击事件：

@override
Widget build(BuildContext context) {
  return GestureDetector(
    onTap: () {
      // 移除SelectableText的焦点，自动清除选中状态
      _selectableTextFocusNode.unfocus();
      // 确保全局焦点都移除，避免其他控件干扰
      FocusScope.of(context).unfocus();
    },
    behavior: HitTestBehavior.opaque, // 确保空白区域点击也能触发
    child: Scaffold(
      body: // 包含SelectableText的页面内容
    ),
  );
}

4. 在组件销毁时释放FocusNode：

@override
void dispose() {
  _selectableTextFocusNode.dispose();
  super.dispose();
}

方法二：通过GlobalKey直接操作选中状态 #

如果焦点控制的方式不满足需求，可以通过GlobalKey获取SelectableText的内部状态，手动重置选中状态：

1. 定义GlobalKey：

final GlobalKey<SelectableTextState> _selectableTextKey = GlobalKey();

2. 将GlobalKey绑定到SelectableText.rich：

return SelectableText.rich(
  key: _selectableTextKey,
  TextSpan(
    // 原有的TextSpan配置
  ),
  onSelectionChanged: onSelectionChanged,
  enableInteractiveSelection: selectionEnabled,
);

3. 在外部点击时调用内部方法重置选中状态：

onTap: () {
  final selectableState = _selectableTextKey.currentState;
  if (selectableState != null) {
    // 重置为无选中状态
    selectableState.updateSelection(
      const TextSelection.collapsed(offset: -1),
      const SelectionChangedCause.userInteraction,
    );
  }
}

注意：此方法依赖SelectableTextState的内部方法updateSelection，属于非公开API，后续Flutter版本更新可能存在兼容性风险。

内容的提问来源于stack exchange，提问作者holycamolie