You need to enable JavaScript to run this app. Material UI Autocomplete结合React Hook Form与Recoil的异常问题
优惠活动
大模型
产品
解决方案
定价
更多

Material UI Autocomplete结合React Hook Form与Recoil的异常问题

问题根因定位
  1. 自定义Autocomplete封装未正确对接React Hook Form(RHF)的Controller受控逻辑:完全未使用Controller自动注入的field绑定参数,反而单独通过watch取值、手动设置默认值,这是freeSolo模式下状态错乱、下拉面板异常的核心原因。
  2. 远程typeahead场景缺少必要配置:没有关闭MUI Autocomplete默认的本地选项过滤逻辑,远程返回的选项列表会被前端本地逻辑二次筛选,导致列表不随输入动态更新;同时输入变更的触发未和Recoil请求链路打通,空值、重复值的判断存在边界漏洞。
  3. 校验触发逻辑冗余:手动在onInputChange中调用setValue触发校验,和Controller本身的状态同步逻辑形成冲突,反而造成状态循环更新、弹层异常保持打开。
分步修正方案

1. 重构可复用Autocomplete组件的封装逻辑

核心调整:

  • 直接使用Controller render props自动注入的field参数,替代手动watch取值、设置默认值的旧逻辑
  • 打通onChange(选择下拉选项触发)和onInputChange(手动输入触发)的逻辑,适配freeSolo模式
  • 完整保留业务侧传入的自定义回调、配置,不做无意义的覆盖

修正后的组件代码:

import {
  AutocompleteProps,
  Autocomplete as MuiAutocomplete,
} from '@material-ui/lab'
import {get} from 'lodash'
import React, {ReactNode, useCallback} from 'react'
import {
  Controller,
  ControllerProps,
  FieldError,
  useFormContext,
} from 'react-hook-form'
import {useRenderInput} from './hooks'

interface Props
  extends Pick<ControllerProps, 'rules'>,
    Omit<
      AutocompleteProps<string, false, false, true>,
      'error' | 'renderInput'
    > {
  helperText?: ReactNode
  label?: string
  name: string
}

export const Autocomplete = ({
  helperText,
  label,
  name,
  rules,
  ...props
}: Props) => {
  const {control, errors} = useFormContext()
  const error: FieldError | undefined = get(errors, name)
  const required = get(rules, 'required') !== undefined

  const renderAutocompleteInput = useRenderInput({
    error: error !== undefined,
    helperText: get(error, 'message', helperText),
    label,
    required,
  })

  return (
    <Controller
      control={control}
      name={name}
      rules={rules}
      render={({field: {onChange, value}}) => (
        <MuiAutocomplete
          // 关闭本地过滤逻辑,适配远程typeahead场景
          filterOptions={(options) => options}
          {...props}
          value={value || ''}
          // 选择下拉选项时直接同步值到RHF
          onChange={(_, option) => onChange(option || '')}
          renderInput={renderAutocompleteInput}
        />
      )}
    />
  )
}

2. 调整父组件的调用逻辑

核心调整:

  • 删除冗余的手动setValue调用,Controller已经自动将输入值同步到RHF,无需手动干预
  • 给Recoil触发的接口请求增加300ms防抖,避免高频输入造成的接口压力
  • 配置RHF的校验模式,设置mode: 'onChange'即可实现输入时实时触发必填、正则校验,无需手动调用校验方法

修正后的父组件核心代码:

// 初始化表单时开启onChange校验模式,实现输入实时校验
const { control } = useForm({
  mode: 'onChange',
  defaultValues: {
    trainID: ''
  }
})

const setTrainType = useSetRecoilState(TrainType)
const trainsList = useRecoilValue(Trains)
const trainOptions = useMemo(() => trainsList.map(trainIDFormatted), [trainsList])

// 增加防抖处理,避免每敲一个字符就触发Recoil状态更新和接口请求
const debouncedTrainTypeChange = useDebounce((inputVal: string) => {
  const capitalized = capitalize(inputVal)
  if (!capitalized) {
    setTrainType(undefined)
    return
  }
  // 仅将输入内容的首字符传给Recoil,触发对应接口请求
  setTrainType(capitalized.charAt(0))
}, 300)

const handleInputChange = useCallback(
  (_e: unknown, inputValue: string, reason: string) => {
    // 仅处理手动输入触发的事件,忽略选中、清空类事件
    if (reason !== 'input') return
    debouncedTrainTypeChange(inputValue)
  },
  [debouncedTrainTypeChange]
)

<Autocomplete
  autoSelect
  freeSolo
  disabled={disabled}
  helperText=" "
  label="Select a train"
  name="trainID"
  options={trainOptions}
  rules={{
    pattern: {
      message: 'Must match train ID pattern',
      value: /^(?:[A-Z]-?[A-Z ]{6}-?[0-9 ]-?[0-9 ]{2}[A-Z ])?$/,
    },
    required: 'Train is required',
  }}
  onInputChange={handleInputChange}
/>
效果验证
  • typeahead联动:关闭本地过滤后,远程返回的trainOptions会直接展示在下拉面板;输入内容通过防抖更新Recoil的TrainType值,触发对应接口请求返回最新列表,输入内容变化时列表同步更新
  • freeSolo适配:输入值通过Controller直接同步到RHF,组件内部状态和外部展示完全一致,不会出现下拉面板持续打开的异常,支持输入自定义的非预设值
  • 实时校验:表单设置mode: 'onChange'后,每次值变化都会自动执行必填校验、正则pattern匹配,错误信息会自动展示在helperText区域,无需手动触发校验

界面效果


内容的提问来源于stack exchange,提问作者npabs18

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.29 02:15:03