React
新文档有个很有意思的细节:useRef
、useEffect
这两个API
文档所在章节的介绍称为Escape Hatches
(逃生舱)。
显然,正常航行时是不需要逃生舱的,只有在遇到危险时会用到。
如果开发者过于依赖这两个API
,可能是误用。
在React新文件:不要滥用effect我们在哦中谈到useEffect
正确使用场景。
今天,我们来谈谈Ref
使用场景。
为什么是逃生舱?
先想一个问题:为什么ref
、effect
被归类到中?
这是因为两者都在操作。
effect
中处理的是。比如:在useEffect
中修改了document.title
。
document.title
不属于React
中的状态,React
无法感知他的变化,因此被归类为effect
中。
同样,需要调用element.focus()
,直接执行DOM API
也是不受React
控制的。
虽然他们是,但是,为了保证应用的强度,React
尽量防止他们失控。
失控的Ref
对于Ref
,什么是失控?
首先来看的情况:
执行
ref.current
的focus
、blur
等方法执行
ref.current.scrollIntoView
使element
滚进视野执行
ref.current.getBoundingClientRect
测量DOM
尺寸
在这种情况下,虽然我们已经操作了DOM
,但都涉及到,所以不算失控。
但以下情况:
执行
ref.current.remove
移除DOM
执行
ref.current.appendChild
插入子节点
同样是操作DOM
,但这些属于,通过ref
执行这些操作是失控的。
例如,下面是React文档中的例子[1]:
点击后插入/删除 P节点,点击后会调用DOM API
移除P节点:
exportdefaultfunctionCounter(){ const[show,setShow]=useState(true); constref=useRef(null); return( <div> <button onClick={()=>{ setShow(!show); }}> TogglewithsetState </button> <button onClick={()=>{ ref.current.remove(); }}> RemovefromtheDOM </button> {show&&<pref={ref}>Helloworld</p>} </div> ); }
通过React
去除P节点的控制方法。
直接操作DOM
移除P节点。
如果这两种如果混合,先点击再点击就会报错:

这就是导致的。
如何限制失控?
现在问题来了,既然叫了,那就是React
没法控制的(React
开发限制开发者不能使用DOM API
嗯?),如何限制失控?
在React
组件可分为:
高阶组件
低阶组件
指那些,例如,以下组件直接基于input
节点封装:
functionMyInput(props){ return<input{...props}/>; }
在中,可直接将ref
指向DOM
的,比如:
functionMyInput(props){ constref=useRef(null); return<inputref={ref}{...props}/>; }
指那些,比如下面的Form
组件,基于Input
组件封装:
functionForm(){ return( <> <MyInput/> </> ) }
无法直接将ref
指向DOM
,这个限制就要到了在单个组件中控制范围,会出现跨越组件的。
以文档中的示例[2]为例,如果我们想在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
节点。
究其原因,就是上面说的。
人为取消限制
如果一定要取消这个限制,可以使用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
有些多此一举。
但从的角度看,forwardRef
的意图就很明显了:既然开发者手动调用forwardRef
破除,那他应该知道自己在做什么,也应该自己承担相应的风险。
同时,有了forwardRef
的存在,发生后也更容易定位错误。
useImperativeHandle
除了外,还有一种,那就是useImperativeHandle
,他的逻辑是这样的:
既然是由于(比如appendChild),那我可以限制。
用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
的使用比较少,他是作为而存在的。
为了防止错用/滥用导致ref失控
,React
限制。
为了破除这种限制,可以使用forwardRef
。
为了减少ref
对DOM
的滥用,可以使用useImperativeHandle
限制ref
传递的数据结构。
参考资料
[1]
React文档中的例子: https://codesandbox.io/s/sandpack-project-forked-s33q3c
[2]文档中的示例: https://codesandbox.io/s/sandpack-project-forked-7zqgmd