You need to enable JavaScript to run this app. 使用react-beautiful-dnd时已用React.forwardRef仍出现MenuItem传ref报错
优惠活动
大模型
产品
解决方案
定价
更多

使用react-beautiful-dnd时已用React.forwardRef仍出现MenuItem传ref报错

报错原因定位
  • ref传递链路中断
    你通过React.forwardRef包裹了RefMenuItem组件,获取到外部传入的ref后直接将其作为prop传给MenuItem。如果使用的是MUI v3及更早版本的MenuItem,这类组件本身是不具备ref透传能力的函数组件,且设计上是通过innerRef属性接收DOM节点引用,而非标准的refprop。你直接传refprop给MenuItem,既会触发「Function components cannot be given refs」的报错,也无法将ref传到最终渲染的DOM节点上,react-beautiful-dnd无法正常识别拖拽目标。
  • 组件嵌套结构违规
    MUI Select的内部实现依赖直接遍历传入的子元素匹配选中值、绑定点击事件,要求MenuItem作为直接子元素传入。你将DragDropContext、Droppable这类拖拽容器嵌套在Select内部,相当于给MenuItem套了多层非预期的父容器,Select无法识别合法子元素,会进一步导致功能失效。
  • 属性透传不完整
    你在RefMenuItem中手动筛选传递给MenuItem的属性,仅传递了onClick和ref,完全遗漏了Select自动注入到MenuItem的selected、value、tabIndex、role等核心props,导致MenuItem的选中态、交互逻辑完全异常。
正确修复方案
  1. 理顺ref传递链路,确保ref能最终落到真实DOM节点上
    • 若使用MUI v4及以上版本:MenuItem本身已内置forwardRef支持,可直接接收refprop,无需额外手动处理
    • 若使用MUI v3及更早版本:不要直接传refprop给MenuItem,改用组件提供的innerRef属性传入ref值,打通传递链路
  2. 调整组件嵌套层级,将DragDropContext移到Select组件的外层,不要把拖拽相关的容器嵌套在Select内部,避免Select无法识别合法子元素
  3. 完善属性透传逻辑,在RefMenuItem中不要手动筛选传递的props,完整透传所有与MenuItem相关的属性,避免遗漏Select注入的核心逻辑

修复后的参考代码:

// 带ref透传的MenuItem组件
const RefMenuItem = React.forwardRef((props, ref) => {
  // 拆分出自定义的拖拽相关属性,避免污染MenuItem的原生props
  const { dragHandleProps, draggableProps, ...restMenuItemProps } = props
  return (
    <MenuItem
      // MUI v3用innerRef,v4及以上用ref,根据实际版本选择对应属性
      innerRef={ref}
      {...restMenuItemProps}
      {...draggableProps}
      {...dragHandleProps}
    >
      {props.children}
    </MenuItem>
  )
})

// 可拖拽的MenuItem项
function DraggableItem({ item, index, onClick, selectedValue }) {
  return (
    <Draggable draggableId={item.id} index={index}>
      {provided => (
        <RefMenuItem
          ref={provided.innerRef}
          onClick={onClick}
          value={item.id}
          selected={selectedValue === item.id}
          dragHandleProps={provided.dragHandleProps}
          draggableProps={provided.draggableProps}
        >
          <DragIndicatorIcon />
          {item.name}
          <CreateIcon />
        </RefMenuItem>
      )}
    </Draggable>
  )
}

// 外层结构调整:将DragDropContext移到Select外部
<DragDropContext onDragEnd={onDragEnd}>
  <Select
    variant='outlined'
    value={selectedValue}
    className={selectClasses}
  >
    <Droppable droppableId='list'>
      {provided => (
        <div ref={provided.innerRef} {...provided.droppableProps}>
          {state.items.map((item, index) => (
            <DraggableItem
              key={item.id}
              item={item}
              index={index}
              onClick={handleAudienceChange}
              selectedValue={selectedValue}
            />
          ))}
          {provided.placeholder}
        </div>
      )}
    </Droppable>
  </Select>
</DragDropContext>
注意事项
  • 确保使用的MUI版本与ref传递方式匹配,避免出现ref传递断链
  • 不要在Select组件内部嵌套非业务相关的容器元素,否则会导致Select的选中逻辑失效
  • react-beautiful-dnd要求provided.innerRef必须绑定到真实DOM节点上,不能绑定到无透传能力的函数组件上

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.11.03 06:45:09