Flutter TextField如何获取超过maxLength限制的完整粘贴值？

方法一：使用Flutter 3.3+的onPaste回调（推荐） #

Flutter 3.3版本开始，TextField新增了onPaste参数，可直接获取完整粘贴内容，不受maxLength限制。修改代码如下：

@override
Widget build(context) {
  return TextField(
    controller: _controllers,
    maxLength: 10,
    onChanged: (val) {
      log(val, name: "Form Change");
      ref.read(formStateProvider.notifier).change(index, val);
    },
    // 添加onPaste回调获取完整粘贴内容
    onPaste: (String? text) {
      if (text != null) {
        log("完整粘贴内容: $text", name: "Full Paste");
        // 此处可处理完整内容，比如记录日志、数据统计等
        // TextField会自动按maxLength截断内容，不影响原有业务逻辑
      }
    },
  );
}

该回调在用户触发粘贴动作时触发，传入的text为剪贴板中的完整内容，与maxLength限制无关。之后TextField会自动执行截断逻辑，onChanged仍会收到截断后的文本，不影响原有流程。

方法二：兼容低版本Flutter的方案 #

若你的Flutter版本低于3.3，可通过自定义上下文菜单结合剪贴板监听实现：

1. 先实现剪贴板内容获取方法：

// 在_DummyPageState类中添加
Future<void> _getFullPasteContent() async {
  final clipboardData = await Clipboard.getData(Clipboard.kTextPlain);
  if (clipboardData?.text != null) {
    final fullText = clipboardData!.text!;
    log("完整粘贴内容: $fullText", name: "Full Paste");
    // 处理完整内容逻辑
  }
}

2. 自定义TextField的上下文菜单，替换默认粘贴按钮：

@override
Widget build(context) {
  return TextField(
    controller: _controllers,
    maxLength: 10,
    onChanged: (val) {
      log(val, name: "Form Change");
      ref.read(formStateProvider.notifier).change(index, val);
    },
    contextMenuBuilder: (context, editableTextState) {
      return AdaptiveTextSelectionToolbar(
        anchors: editableTextState.contextMenuAnchors,
        children: [
          // 自定义粘贴按钮，先获取完整内容再执行粘贴
          TextButton(
            onPressed: () async {
              await _getFullPasteContent();
              editableTextState.pasteText();
              Navigator.pop(context);
            },
            child: const Text('粘贴'),
          ),
          // 保留其他默认菜单选项
          ...AdaptiveTextSelectionToolbar.getAdaptiveButtons(
            context,
            editableTextState,
          ).where((button) => button.child != const Text('粘贴')),
        ],
      );
    },
  );
}

此方式通过替换默认粘贴按钮，先获取完整剪贴板内容，再执行默认粘贴操作，既拿到完整内容，又不影响TextField的截断逻辑。

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