Flutter TextFormField如何在用户交互后触发用户名唯一性校验
实现方案
核心逻辑是监听输入框焦点状态,在用户结束输入、输入框失去焦点时手动触发校验,同时修正原代码中异步接口调用时序错误的问题,具体实现步骤如下:
- 首先在State类中定义表单字段key和焦点监听对象
final _usernameFieldKey = GlobalKey<FormFieldState>(); final _usernameFocusNode = FocusNode();
- 在initState中监听焦点变化,失去焦点时先调用用户名查重接口,接口返回后再触发校验
@override void initState() { super.initState(); _usernameFocusNode.addListener(() async { // 仅在输入框失去焦点时触发校验逻辑 if (!_usernameFocusNode.hasFocus) { final inputValue = _usernameFieldKey.currentState?.value; // 空输入直接触发校验走必填项判断 if (inputValue == null || inputValue.isEmpty) { _usernameFieldKey.currentState?.validate(); return; } // 先异步调用用户名查重接口,等结果更新到Provider后再触发校验 await Provider.of<Store>(context, listen: false).usernameExistence(inputValue, 'no'); _usernameFieldKey.currentState?.validate(); } }); }
- 修改TextFormField的配置,关闭自带的自动校验,绑定我们定义的key和焦点对象
TextFormField( key: _usernameFieldKey, focusNode: _usernameFocusNode, cursorColor: Theme.of(context).primaryColor, autovalidateMode: AutovalidateMode.disabled, decoration: InputDecoration( suffixIcon: SuffixIcon(), labelText: '选择和你商品相关的合适用户名', hintText: 'SweetCandies', labelStyle: TextStyle(color: Colors.black), focusedBorder: UnderlineInputBorder( borderSide: BorderSide( color: Theme.of(context).primaryColor, ), ), ), validator: (value) { if (value == null || value.isEmpty) { return '必填项'; } if (Provider.of<Store>(context, listen: false).nameExistence) { return '该用户名已被占用'; } return null; }, onSaved: (value) { Provider.of<Store>(context, listen: false) .storeInformation['name'] = value!; }, )
- 页面销毁时释放焦点对象避免内存泄漏
@override void dispose() { _usernameFocusNode.dispose(); super.dispose(); }
原代码问题说明:原来的validator中直接调用异步查重接口,因为validator是同步执行的,接口还没返回就已经完成了状态判断,会导致校验结果是上一次请求的结果,出现判断错误。把异步逻辑移到校验前执行,等接口结果更新后再触发校验就可以解决这个问题。
内容的提问来源于stack exchange,提问作者Mohamad Jabaly
相关产品推荐
相关产品推荐

