React新文档切记不要滥用Ref
目录
- 引言
- 为什么是逃生舱?
- 失控的Ref
- 如何限制失控
- 人为取消限制
- useImperativeHandle
- 总结
引言
React
新文档有个很有意思的细节:useRef
、useEffect
这两个API
的介绍,在文档中所在的章节叫Escape Hatches
(逃生舱)。
显然,正常航行时是不需要逃生舱的,只有在遇到危险时会用到。
如果开发者过多依赖这两个API
,可能是误用。
在React新文档:不要滥用effect哦中我们谈到useEffect
的正确使用场景。
今天,我们来聊聊Ref
的使用场景。
为什么是逃生舱?
先思考一个问题:为什么ref
、effect
被归类到逃生舱中?
这是因为二者操作的都是脱离React控制的因素。
effect
中处理的是副作用。比如:在useEffect
中修改了document.title
。
document.title
不属于React
中的状态,React
无法感知他的变化,所以被归类到effect
中。
同样,使DOM聚焦需要调用element.focus()
,直接执行DOM API
也是不受React
控制的。
虽然他们是脱离React控制的因素,但为了保证应用的健壮,React
也要尽可能防止他们失控。
失控的Ref
对于Ref
,什么叫失控呢?
首先来看不失控的情况:
- 执行
ref.current
的focus
、blur
等方法 - 执行
ref.current.scrollIntoView
使element
滚动到视野内 - 执行
ref.current.getBoundingClientRect
测量DOM
尺寸
这些情况下,虽然我们操作了DOM
,但涉及的都是React控制范围外的因素,所以不算失控。
但是下面的情况:
- 执行
ref.current.remove
移除DOM
- 执行
ref.current.appendChild
插入子节点
同样是操作DOM
,但这些属于React控制范围内的因素,通过ref
执行这些操作就属于失控的情况。
举个例子,下面是React文档中的例子:
按钮1点击后会插入/移除 P节点,按钮2点击后会调用DOM API
移除P节点:
export default function Counter() { const [show, setShow] = useState(true); const ref = useRef(null); return ( <div> <button onClick={() => { setShow(!show); }}> Toggle with setState </button> <button onClick={() => { ref.current.remove(); }}> Remove from the DOM </button> {show && <p ref={ref}>Hello world</p>} </div> ); }
按钮1通过React
控制的方式移除P节点。
按钮2直接操作DOM
移除P节点。
如果这两种移除P节点的方式混用,那么先点击按钮1再点击按钮2就会报错:
这就是使用Ref操作DOM造成的失控情况导致的。
如何限制失控
现在问题来了,既然叫失控了,那就是React
没法控制的(React
总不能限制开发者不能使用DOM API
吧?),那如何限制失控呢?
在React
中,组件可以分为:
- 高阶组件
- 低阶组件
低阶组件指那些基于DOM封装的组件,比如下面的组件,直接基于input
节点封装:
function MyInput(props) { return <input {...props} />; }
在低阶组件中,是可以直接将ref
指向DOM
的,比如:
function MyInput(props) { const ref = useRef(null); return <input ref={ref} {...props} />; }
高阶组件指那些基于低阶组件封装的组件,比如下面的Form
组件,基于Input
组件封装:
function Form() { return ( <> <MyInput/> </> ) }
高阶组件无法直接将ref
指向DOM
,这一限制就将ref失控的范围控制在单个组件内,不会出现跨越组件的ref失控。
以文档中的示例为例,如果我们想在Form
组件中点击按钮,操作input
聚焦:
function MyInput(props) { return <input {...props} />; } function Form() { const inputRef = useRef(null); function handleClick() { inputRef.current.focus(); } return ( <> <MyInput ref={inputRef} /> <button onClick={handleClick}> input聚焦 </button> </> ); }
点击后,会报错:
这是因为在Form
组件中向MyInput
传递ref
失败了,inputRef.current
并没有指向input
节点。
究其原因,就是上面说的为了将ref失控的范围控制在单个组件内,React默认情况下不支持跨组件传递ref。
人为取消限制
如果一定要取消这个限制,可以使用forwardRef API
显式传递ref
:
const MyInput = forwardRef((props, ref) => { return <input {...props} ref={ref} />; }); function Form() { const inputRef = useRef(null); function handleClick() { inputRef.current.focus(); } return ( <> <MyInput ref={inputRef} /> <button onClick={handleClick}> Focus the input </button> </> ); }
使用forwardRef
(forward
在这里是传递的意思)后,就能跨组件传递ref
。
在例子中,我们将inputRef
从Form
跨组件传递到MyInput
中,并与input
产生关联。
在实践中,一些同学可能觉得forwardRef
这一API
有些多此一举。
但从ref失控的角度看,forwardRef
的意图就很明显了:既然开发者手动调用forwardRef
破除防止ref失控的限制,那他应该知道自己在做什么,也应该自己承担相应的风险。
同时,有了forwardRef
的存在,发生ref相关错误后也更容易定位错误。
useImperativeHandle
除了限制跨组件传递ref外,还有一种防止ref失控的措施,那就是useImperativeHandle
,他的逻辑是这样的:
既然ref失控是由于使用了不该被使用的DOM方法(比如appendChild),那我可以限制ref中只存在可以被使用的方法。
用useImperativeHandle
修改我们的MyInput
组件:
const MyInput = forwardRef((props, ref) => { const realInputRef = useRef(null); useImperativeHandle(ref, () => ({ focus() { realInputRef.current.focus(); }, })); return <input {...props} ref={realInputRef} />; });
现在,Form
组件中通过inputRef.current
只能取到如下数据结构:
{ focus() { realInputRef.current.focus(); }, }
就杜绝了开发者通过ref取到DOM后,执行不该被使用的API,出现ref失控的情况。
总结
正常情况,Ref
的使用比较少,他是作为逃生舱而存在的。
为了防止错用/滥用导致ref失控
,React
限制默认情况下,不能跨组件传递ref。
为了破除这种限制,可以使用forwardRef
。
为了减少ref
对DOM
的滥用,可以使用useImperativeHandle
限制ref
传递的数据结构。
以上就是React新文档切记不要滥用Ref的详细内容,更多关于React新文档Ref的资料请关注我们其它相关文章!