React新文檔：不要濫用Ref哦～

React新文檔有個(gè)很有意思的細(xì)節(jié)：useRef、useEffect這兩個(gè)API的介紹，在文檔中所在的章節(jié)叫Escape Hatches（逃生艙）。

顯然，正常航行時(shí)是不需要逃生艙的，只有在遇到危險(xiǎn)時(shí)會(huì)用到。

如果開發(fā)者過多依賴這兩個(gè)API，可能是誤用。

在React新文檔：不要濫用effect哦中我們談到useEffect的正確使用場(chǎng)景。

今天，我們來聊聊Ref的使用場(chǎng)景。

為什么是逃生艙？

先思考一個(gè)問題：為什么ref、effect被歸類到「逃生艙」中？

這是因?yàn)槎卟僮鞯亩际?strong style="color: #916dd5;font-weight: bold;">「脫離React控制的因素」。

effect中處理的是「副作用」。比如：在useEffect中修改了document.title。

document.title不屬于React中的狀態(tài)，React無法感知他的變化，所以被歸類到effect中。

同樣，「使DOM聚焦」需要調(diào)用element.focus()，直接執(zhí)行DOM API也是不受React控制的。

雖然他們是「脫離React控制的因素」，但為了保證應(yīng)用的健壯，React也要盡可能防止他們失控。

失控的Ref

對(duì)于Ref，什么叫失控呢？

首先來看「不失控」的情況：

• 執(zhí)行ref.current的focus、blur等方法

• 執(zhí)行ref.current.scrollIntoView使element滾動(dòng)到視野內(nèi)

• 執(zhí)行ref.current.getBoundingClientRect測(cè)量DOM尺寸

這些情況下，雖然我們操作了DOM，但涉及的都是「React控制范圍外的因素」，所以不算失控。

但是下面的情況：

• 執(zhí)行ref.current.remove移除DOM

• 執(zhí)行ref.current.appendChild插入子節(jié)點(diǎn)

同樣是操作DOM，但這些屬于「React控制范圍內(nèi)的因素」，通過ref執(zhí)行這些操作就屬于失控的情況。

舉個(gè)例子，下面是React文檔中的例子^[1]：

「按鈕1」點(diǎn)擊后會(huì)插入/移除 P節(jié)點(diǎn)，「按鈕2」點(diǎn)擊后會(huì)調(diào)用DOM API移除P節(jié)點(diǎn)：

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節(jié)點(diǎn)。

「按鈕2」直接操作DOM移除P節(jié)點(diǎn)。

如果這兩種「移除P節(jié)點(diǎn)」的方式混用，那么先點(diǎn)擊「按鈕1」再點(diǎn)擊「按鈕2」就會(huì)報(bào)錯(cuò)：

這就是「使用Ref操作DOM造成的失控情況」導(dǎo)致的。

如何限制失控

現(xiàn)在問題來了，既然叫「失控」了，那就是React沒法控制的（React總不能限制開發(fā)者不能使用DOM API吧？），那如何限制失控呢？

在React中，組件可以分為：

• 高階組件

• 低階組件

「低階組件」指那些「基于DOM封裝的組件」，比如下面的組件，直接基于input節(jié)點(diǎn)封裝：

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失控」的范圍控制在單個(gè)組件內(nèi)，不會(huì)出現(xiàn)跨越組件的「ref失控」。

以文檔中的示例^[2]為例，如果我們想在Form組件中點(diǎn)擊按鈕，操作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>
    </>
  );
}

點(diǎn)擊后，會(huì)報(bào)錯(cuò)：

這是因?yàn)樵?code style="font-size: 14px;word-wrap: break-word;padding: 2px 4px;border-radius: 4px;margin: 0 2px;background-color: rgba(27,31,35,.05);font-family: Operator Mono, Consolas, Monaco, Menlo, monospace;word-break: break-all;color: #916dd5;font-weight: bolder;background: none;">Form組件中向MyInput傳遞ref失敗了，inputRef.current并沒有指向input節(jié)點(diǎn)。

究其原因，就是上面說的「為了將ref失控的范圍控制在單個(gè)組件內(nèi)，React默認(rèn)情況下不支持跨組件傳遞ref」。

人為取消限制

如果一定要取消這個(gè)限制，可以使用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在這里是「?jìng)鬟f」的意思）后，就能跨組件傳遞ref。

在例子中，我們將inputRef從Form跨組件傳遞到MyInput中，并與input產(chǎn)生關(guān)聯(lián)。

在實(shí)踐中，一些同學(xué)可能覺得forwardRef這一API有些多此一舉。

但從「ref失控」的角度看，forwardRef的意圖就很明顯了：既然開發(fā)者手動(dòng)調(diào)用forwardRef破除「防止ref失控的限制」，那他應(yīng)該知道自己在做什么，也應(yīng)該自己承擔(dān)相應(yīng)的風(fēng)險(xiǎn)。

同時(shí)，有了forwardRef的存在，發(fā)生「ref相關(guān)錯(cuò)誤」后也更容易定位錯(cuò)誤。

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} />;
});

現(xiàn)在，Form組件中通過inputRef.current只能取到如下數(shù)據(jù)結(jié)構(gòu)：

{
  focus() {
    realInputRef.current.focus();
  },
}

就杜絕了「開發(fā)者通過ref取到DOM后，執(zhí)行不該被使用的API，出現(xiàn)ref失控」的情況。

總結(jié)

正常情況，Ref的使用比較少，他是作為「逃生艙」而存在的。

為了防止錯(cuò)用/濫用導(dǎo)致ref失控，React限制「默認(rèn)情況下，不能跨組件傳遞ref」。

為了破除這種限制，可以使用forwardRef。

為了減少ref對(duì)DOM的濫用，可以使用useImperativeHandle限制ref傳遞的數(shù)據(jù)結(jié)構(gòu)。

參考資料