在 React 專案中,我們經常會使用到 React 自帶的幾個內建 Hooks,如 useState,useContext 和useEffect。但有時,我們可能希望有一個特定目的的 Hook :例如取得資料 useData,取得連接 useConnect 等。雖然在 React 中找不到這些 Hooks,但 React 提供了非常靈活的方式讓你為自己的需求來創建自己的自訂 Hooks。
在React 中你必須遵循以下命名約定:
React Component: React 元件名稱必須以大寫字母開頭,如StatusBar 和SaveButton。 React元件也需要 回傳 一些React知道如何渲染的東西,像是 JSX
。
React Hook: Hook 名必須以use 開頭,後面跟著一個大寫字母,例如useState (內建)或useStatus (自訂)。與 React 元件不同的是自訂 Hook 可以傳回任意值。
這個命名約定確保你始終可以查看元件,並了解其狀態、效果以及其他React 特性可能「隱藏」的位置。例如,如果你在元件中看到 getColor() 函數調用,你可以確定它不可能包含 React state,因為其名稱不以use開頭。但是,像 useStatus() 這樣的函數呼叫很可能包含對其他 Hooks 的呼叫!
The code inside them describes what they want to do rather than how to do it .
自訂Hooks 的核心是共享元件之間的邏輯。使用自訂 Hooks 能夠減少重複的邏輯,更重要的是,自訂 Hooks 內部的程式碼描述了它們想做什麼,而不是如何做。當你將邏輯提取到自訂Hooks 中時,你可以隱藏如何處理某些"外部系統"或瀏覽器API 的呼叫的細節,元件的程式碼表達的是你的意圖,而不是實作細節。 下面是一個簡單的範例:
import { useState } from 'react'; function useCounter(initialValue) { const [count, setCount] = useState(initialValue); function increment() { setCount(count + 1); } return [count, increment]; }
這個自訂Hook 叫做 useCounter
,它接受一個初始值作為參數,並且傳回一個數組,包含目前的計數值和一個增加計數的函數。
使用自訂 Hook 非常簡單,只需要在函數元件中呼叫它。以下是使用 useCounter
的範例:
import React from 'react'; import useCounter from './useCounter'; function Counter() { const [count, increment] = useCounter(0); return ( <div> <p>Count: {count}</p> <button onClick={increment}>Increment</button> </div> ); }
在這個範例中,我們匯入了 useCounter
,並在元件中呼叫它。我們將傳回的陣列解構為 count
和 increment
,然後在元件中使用它們。
自訂 Hooks 允許共享有狀態邏輯,但不能共享狀態本身。每個對 Hook 的呼叫都完全獨立於對同一個 Hook 的其他呼叫。
以上面的useCounter
為例:
import useCounter from './useCounter'; function Counter() { const [count1, increment1] = useCounter(0); const [count2, increment2] = useCounter(100); return ( <div> <p>Count1: {count1}</p> <button onClick={increment1}>Increment1</button> <p>Count2: {count2}</p> <button onClick={increment2}>Increment2</button> </div> ); }
當我們點擊Increment2
時,並不會影響count1
,因為每一個 useCounter
的呼叫都是獨立的,其內部狀態也是獨立的。
以實現特定功能或目的,與具體業務無關:
該hook 返回視窗寬度的值。
import { useState, useEffect } from 'react'; function useWindowWidth() { const [windowWidth, setWindowWidth] = useState(window.innerWidth); useEffect(() => { const handleResize = () => setWindowWidth(window.innerWidth); window.addEventListener('resize', handleResize); return () => window.removeEventListener('resize', handleResize); }, []); return windowWidth; }
該 hook 允許你在本機儲存中儲存和檢索值。
import { useState } from 'react'; function useLocalStorage(key, initialValue) { const [storedValue, setStoredValue] = useState(() => { try { const item = window.localStorage.getItem(key); return item ? JSON.parse(item) : initialValue; } catch (error) { console.log(error); return initialValue; } }); const setValue = (value) => { try { setStoredValue(value); window.localStorage.setItem(key, JSON.stringify(value)); } catch (error) { console.log(error); } }; return [storedValue, setValue]; }
該 hook 允許你從 API 取得資料。
import { useState, useEffect } from 'react'; function useFetch(url) { const [data, setData] = useState(null); const [error, setError] = useState(null); const [isLoading, setIsLoading] = useState(true); useEffect(() => { const fetchData = async () => { try { const response = await fetch(url); const json = await response.json(); setData(json); } catch (error) { setError(error); } finally { setIsLoading(false); } }; fetchData(); }, [url]); return { data, error, isLoading }; }
該 hook 允許你管理模態對話方塊的狀態。
//useFetch.js import {useState, useEffect} from 'react' //don't forget to give a url parameter for the function. const useFetch = (url)=>{ const [data, setData] = useState([]) const getData = async ()=>{ const response = await fetch(url) const userdata = await response.json() setData(userdata) } useEffect(()=>{ getData() },[url]) //return data that we will need in other components. return {data}; } export default useFetch;
由於 Hook 本身就是函數,因此我們可以在它們之間傳遞訊息。下面我們以useUserInfo
取得使用者資訊為例:
//useUserInfo.jsx import { useEffect,useState } from 'react' const useUserInfo = (userId) => { const [userInfo, setUserInfo] = useState({}) useEffect(() => { fetch('/user') .then(res => res.json()) .then(data => setUserInfo(data)) }, [userId]) return userInfo } //Home.jsx ... const Home = ()=>{ const [userId,setUserId] = useState('103') const useInfo = useUserInfo(userId) return ( <> <div>name:{userInfo.name}</div> <div>age:{userInfo.age}</div> ... </> ) }
我們將使用者id 保存在userId
狀態變數中,當使用者進行某一動作#setUserId
時,由於 useState
為我們提供了 userId
狀態變數的最新值,因此我們可以將它傳遞給自訂的 useUserInfo
Hook :
const [userId,setUserId] = useState('103') const userInfo = useUserInfo(userId)
此時,我們的userInfo
會隨著userId 的改變而更新。
This section describes an experimental API that has not yet been released in a stable version of React. 本節描述了一個尚未在 React 穩定版本中發布的 實驗性 API。
你可能希望让组件自定义其行为,而不是完全地将逻辑封装 Hooks 中,我们可以通过将 event handlers
作为参数传递给 Hooks,下面是一个聊天室的例子:useChatRoom
接受一个服务端 url 和 roomId,当调用这个 Hook 的时候,会进行连接,
export function useChatRoom({ serverUrl, roomId }) { useEffect(() => { const options = { serverUrl: serverUrl, roomId: roomId }; const connection = createConnection(options); connection.connect(); connection.on('message', (msg) => { showNotification('New message: ' + msg); }); return () => connection.disconnect(); }, [roomId, serverUrl]); }
假设当连接成功时,你想将此逻辑移回你的组件:
export default function ChatRoom({ roomId }) { const [serverUrl, setServerUrl] = useState('https://localhost:1234'); useChatRoom({ roomId: roomId, serverUrl: serverUrl, onReceiveMessage(msg) { showNotification('New message: ' + msg); } }); // ...
要做到这一点,改变你的自定义 Hook ,把 onReceiveMessage
作为它的命名选项之一:
export function useChatRoom({ serverUrl, roomId, onReceiveMessage }) { useEffect(() => { const options = { serverUrl: serverUrl, roomId: roomId }; const connection = createConnection(options); connection.connect(); connection.on('message', (msg) => { onReceiveMessage(msg); }); return () => connection.disconnect(); }, [roomId, serverUrl, onReceiveMessage]); // ✅ All dependencies declared }
这可以工作,但是当你的自定义 Hook 接受事件处理程序时,你还可以做一个改进。
在 onReceiveMessage
上添加依赖并不理想,因为它会导致每次组件重新渲染时聊天都重新连接。将此事件处理程序包装到 EffectEvent
中以将其从依赖项中移除:
import { useEffect, useEffectEvent } from 'react'; // ... export function useChatRoom({ serverUrl, roomId, onReceiveMessage }) { const onMessage = useEffectEvent(onReceiveMessage); useEffect(() => { const options = { serverUrl: serverUrl, roomId: roomId }; const connection = createConnection(options); connection.connect(); connection.on('message', (msg) => { onMessage(msg); }); return () => connection.disconnect(); }, [roomId, serverUrl]); // ✅ All dependencies declared }
现在不会在每次重新渲染聊天室组件时进行重新连接。
自定义 Hooks 可以帮助你迁移到更好的开发范式。通过将一些通用逻辑封装在自定义 Hooks 中,你可以使组件代码保持简洁并专注于核心意图,这有助于减少重复性的代码,并使你的代码更易于维护和更新,从而使你能够更快速地开发新功能。
对于 Effect 而言,这样可以使数据在 Effects 中流动的过程变得非常明确。这让你的组件能够专注于意图,而不是 Effects 的具体实现。当 React 添加新功能时,你可以删除那些 Effects 而不影响任何组件。就像设计系统一样,你可能会发现从应用程序组件中提取常见习惯用法到自定义 Hooks 中是有非常帮助的。这将使你的组件代码专注于意图,并允许你避免频繁编写原始 Effects,这也是 React 开发者所推崇的。
(學習影片分享:程式設計基礎影片)
以上是深入理解React的自訂Hook的詳細內容。更多資訊請關注PHP中文網其他相關文章!