Flutter中TextSelectionThemeData的selectionHandleColor不生效问题

在配置Flutter全局主题时，你可能遇到过这个问题：TextSelectionThemeData里的cursorColor和selectionColor都正常生效，唯独selectionHandleColor没有变化。你的代码如下：

MaterialApp(
  theme: ThemeData(
    scaffoldBackgroundColor: Colors.transparent,
    colorSchemeSeed: MaterialSwatchGenerator.generate(Colors.blue),
    textSelectionTheme: const TextSelectionThemeData(
      cursorColor: Colors.red,
      selectionHandleColor: Colors.red,
    ),
  ),
  home: MainChild(),
)

下面是几个实用的排查和解决方向：

• 升级Flutter版本：部分旧版本的Flutter存在selectionHandleColor主题配置不生效的bug，优先尝试升级到最新稳定版，很多这类问题会随版本更新修复。

• 检查局部组件的覆盖配置：如果你的TextField或TextFormField单独设置了selectionControls，全局主题的selectionHandleColor会被局部配置覆盖。如果使用了自定义的SelectionControls，需要确保它的handleColor是你想要的颜色；如果是系统默认的，去掉局部的selectionControls配置，让全局主题生效。

• 关联ColorScheme配置：某些场景下，selectionHandleColor会受ThemeData.colorScheme.primary的影响，可以尝试同时配置colorScheme，或者让selectionHandleColor和colorScheme同步：

  theme: ThemeData(
    colorSchemeSeed: Colors.blue,
    textSelectionTheme: TextSelectionThemeData(
      cursorColor: Colors.red,
      selectionHandleColor: Colors.red,
    ),
    colorScheme: ColorScheme.fromSeed(seedColor: Colors.blue).copyWith(primary: Colors.red),
  ),
  

• 自定义SelectionControls强制设置：如果以上方法都无效，可以直接自定义SelectionControls来指定手柄颜色，示例如下：

  class CustomSelectionControls extends MaterialTextSelectionControls {
    @override
    Color get handleColor => Colors.red;
  }
  

  然后在TextField中使用：

  TextField(
    selectionControls: CustomSelectionControls(),
    // 其他配置
  )
  

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