React:使用forwardRef封装的权限组件Can如何向内部children传递ref
Can 组件 ref 透传实现方案
现有实现的核心问题:
当前的Can组件虽然通过forwardRef拿到了外部传入的ref,但组件内部直接原样返回children的逻辑,完全没有把收到的ref和最终渲染的真实节点做绑定,因此外部传入的ref根本无法指向内部包裹的子组件实例。
具体改造逻辑:
通过React提供的cloneElementAPI,在权限校验通过、需要渲染children的场景下,克隆原有的children元素,将Can组件收到的ref作为props挂载到克隆后的子元素上,完成ref的透传。
改造后的完整代码:
import { forwardRef, cloneElement, isValidElement } from 'react'; const Can = forwardRef(({ requiredPermissions, children }, ref) => { const { user: { role }, userPermissions, } = useAuth(); // 权限不满足直接返回空节点 if (!userHasPermission(role, userPermissions, requiredPermissions)) { return null; } // 校验children合法性,避免非元素场景克隆报错 if (!isValidElement(children)) { return children; } // 克隆子元素,将外部传入的ref绑定到子节点上 return cloneElement(children, { ref: ref }); }); export default Can;
改造后的使用方式:
不需要在children内部单独写ref,可以直接把ref传给Can组件本身,最终ref会自动指向内部渲染的目标组件/原生DOM:
示例用法
// 直接给Can传入ref,和普通组件用法完全一致 const submitRef = useRef(null); <Can requiredPermissions="form:submit" ref={submitRef}> <Button htmlType="submit">提交表单</Button> </Can>
实际使用注意事项:
- 被Can包裹的目标组件必须是可接收ref的类型:如果是函数组件,本身需要通过
forwardRef做ref暴露,否则ref无法正常拿到组件实例 - 如果存在children本身已经携带ref的场景,需要在克隆逻辑里做ref合并,不要直接覆盖原有ref:可以通过回调函数的方式,同时将原children的ref和Can传入的ref做赋值处理
- 权限校验不通过、组件返回null时,React会自动将对应ref的current值置为null,不需要额外做ref清理逻辑
内容的提问来源于stack exchange,提问作者Sammy
相关产品推荐
相关产品推荐

