良好的状态结构可以决定一个组件是易于修改和调试,还是一个持续出错的来源。以下是一些在构建状态结构时应考虑的技巧。
你将学习
- 何时使用单个状态变量与多个状态变量
- 组织状态时应避免什么
- 如何修复状态结构中的常见问题
状态结构原则
当你编写包含某些状态的组件时,你必须选择使用多少个状态变量以及它们的数据形状应该是什么。即使状态结构不佳,也可以编写正确的程序,但是有一些原则可以指导你做出更好的选择。
- 将相关状态分组。如果你总是同时更新两个或多个状态变量,请考虑将它们合并到单个状态变量中。
- 避免状态中的矛盾。当状态以几种状态可能相互矛盾且“不一致”的方式构建时,就会留下出错的余地。尽量避免这种情况。
- 避免冗余状态。如果可以在渲染期间根据组件的 props 或其现有状态变量计算某些信息,则不应将该信息放入该组件的状态中。
- 避免状态中的重复。当相同的数据在多个状态变量之间或嵌套对象内重复时,很难使它们保持同步。尽可能减少重复。
- 避免深度嵌套的状态。深度分层的状态不太方便更新。如果可能,最好以扁平的方式构建状态。
这些原则背后的目标是使状态易于更新而不会引入错误。从状态中移除冗余和重复数据有助于确保其所有部分保持同步。这类似于数据库工程师如何希望“规范化”数据库结构以减少错误的可能性。引用爱因斯坦的话,“使你的状态尽可能简单——但不能更简单”。
现在让我们看看这些原则如何在实践中应用。
将相关状态分组
有时你可能不确定是使用单个状态变量还是多个状态变量。
你应该这样做吗?
const [x, setX] = useState(0);
const [y, setY] = useState(0);
还是这样做?
const [position, setPosition] = useState({ x: 0, y: 0 });
从技术上讲,你可以使用这两种方法中的任何一种。但是,如果两个状态变量总是同时改变,那么最好将它们统一成一个状态变量。这样你就不会忘记始终保持它们同步,就像在这个例子中,移动光标会更新红点的两个坐标。
import { useState } from 'react'; export default function MovingDot() { const [position, setPosition] = useState({ x: 0, y: 0 }); return ( <div onPointerMove={e => { setPosition({ x: e.clientX, y: e.clientY }); }} style={{ position: 'relative', width: '100vw', height: '100vh', }}> <div style={{ position: 'absolute', backgroundColor: 'red', borderRadius: '50%', transform: `translate(${position.x}px, ${position.y}px)`, left: -10, top: -10, width: 20, height: 20, }} /> </div> ) }
在不知道需要多少个状态的情况下,你还会将数据分组到对象或数组中。例如,当你有一个用户可以添加自定义字段的表单时,这很有帮助。
避免状态中的矛盾
这是一个带有isSending
和isSent
状态变量的酒店反馈表单。
import { useState } from 'react'; export default function FeedbackForm() { const [text, setText] = useState(''); const [isSending, setIsSending] = useState(false); const [isSent, setIsSent] = useState(false); async function handleSubmit(e) { e.preventDefault(); setIsSending(true); await sendMessage(text); setIsSending(false); setIsSent(true); } if (isSent) { return <h1>Thanks for feedback!</h1> } return ( <form onSubmit={handleSubmit}> <p>How was your stay at The Prancing Pony?</p> <textarea disabled={isSending} value={text} onChange={e => setText(e.target.value)} /> <br /> <button disabled={isSending} type="submit" > Send </button> {isSending && <p>Sending...</p>} </form> ); } // Pretend to send a message. function sendMessage(text) { return new Promise(resolve => { setTimeout(resolve, 2000); }); }
这段代码虽然有效,但它留下了产生“不可能”状态的漏洞。例如,如果你忘记同时调用setIsSent
和setIsSending
,你可能会遇到isSending
和isSent
同时为true
的情况。组件越复杂,就越难以理解发生了什么。
由于isSending
和isSent
不应该同时为true
,最好用一个status
状态变量来代替它们,该变量可以取以下三种有效状态之一:'typing'
(初始状态)、'sending'
和'sent'
import { useState } from 'react'; export default function FeedbackForm() { const [text, setText] = useState(''); const [status, setStatus] = useState('typing'); async function handleSubmit(e) { e.preventDefault(); setStatus('sending'); await sendMessage(text); setStatus('sent'); } const isSending = status === 'sending'; const isSent = status === 'sent'; if (isSent) { return <h1>Thanks for feedback!</h1> } return ( <form onSubmit={handleSubmit}> <p>How was your stay at The Prancing Pony?</p> <textarea disabled={isSending} value={text} onChange={e => setText(e.target.value)} /> <br /> <button disabled={isSending} type="submit" > Send </button> {isSending && <p>Sending...</p>} </form> ); } // Pretend to send a message. function sendMessage(text) { return new Promise(resolve => { setTimeout(resolve, 2000); }); }
你仍然可以声明一些常量以提高可读性。
const isSending = status === 'sending';
const isSent = status === 'sent';
但它们不是状态变量,所以你不必担心它们彼此不同步。
避免冗余状态
如果可以在渲染过程中根据组件的props或其现有的状态变量计算某些信息,则不应该将该信息放入该组件的状态中。
例如,考虑这个表单。它有效,但你能找到任何冗余的状态吗?
import { useState } from 'react'; export default function Form() { const [firstName, setFirstName] = useState(''); const [lastName, setLastName] = useState(''); const [fullName, setFullName] = useState(''); function handleFirstNameChange(e) { setFirstName(e.target.value); setFullName(e.target.value + ' ' + lastName); } function handleLastNameChange(e) { setLastName(e.target.value); setFullName(firstName + ' ' + e.target.value); } return ( <> <h2>Let’s check you in</h2> <label> First name:{' '} <input value={firstName} onChange={handleFirstNameChange} /> </label> <label> Last name:{' '} <input value={lastName} onChange={handleLastNameChange} /> </label> <p> Your ticket will be issued to: <b>{fullName}</b> </p> </> ); }
此表单具有三个状态变量:firstName
、lastName
和fullName
。但是,fullName
是冗余的。你总是可以在渲染过程中根据firstName
和lastName
计算fullName
,因此将其从状态中移除。
你可以这样做
import { useState } from 'react'; export default function Form() { const [firstName, setFirstName] = useState(''); const [lastName, setLastName] = useState(''); const fullName = firstName + ' ' + lastName; function handleFirstNameChange(e) { setFirstName(e.target.value); } function handleLastNameChange(e) { setLastName(e.target.value); } return ( <> <h2>Let’s check you in</h2> <label> First name:{' '} <input value={firstName} onChange={handleFirstNameChange} /> </label> <label> Last name:{' '} <input value={lastName} onChange={handleLastNameChange} /> </label> <p> Your ticket will be issued to: <b>{fullName}</b> </p> </> ); }
在这里,fullName
不是状态变量。相反,它是在渲染过程中计算的。
const fullName = firstName + ' ' + lastName;
因此,更改处理程序无需执行任何特殊操作来更新它。当你调用setFirstName
或setLastName
时,你会触发重新渲染,然后下一个fullName
将根据最新的数据计算。
深入探讨
一个常见的冗余状态示例如下所示
function Message({ messageColor }) {
const [color, setColor] = useState(messageColor);
这里,color
状态变量被初始化为messageColor
prop。问题是如果父组件稍后传递不同的messageColor
值(例如,'red'
而不是'blue'
),则color
状态变量将不会更新!状态仅在第一次渲染期间初始化。
这就是为什么在状态变量中“镜像”某些prop会导致混淆的原因。相反,直接在代码中使用messageColor
prop。如果你想给它一个更短的名称,可以使用一个常量。
function Message({ messageColor }) {
const color = messageColor;
这样它就不会与父组件传递的prop不同步。
将props“镜像”到状态中只有在你想要忽略特定prop的所有更新时才有意义。按照约定,以initial
或default
开头命名prop以明确其新值将被忽略。
function Message({ initialColor }) {
// The `color` state variable holds the *first* value of `initialColor`.
// Further changes to the `initialColor` prop are ignored.
const [color, setColor] = useState(initialColor);
避免状态中的重复
这个菜单列表组件允许你从多个选项中选择一个旅行零食。
import { useState } from 'react'; const initialItems = [ { title: 'pretzels', id: 0 }, { title: 'crispy seaweed', id: 1 }, { title: 'granola bar', id: 2 }, ]; export default function Menu() { const [items, setItems] = useState(initialItems); const [selectedItem, setSelectedItem] = useState( items[0] ); return ( <> <h2>What's your travel snack?</h2> <ul> {items.map(item => ( <li key={item.id}> {item.title} {' '} <button onClick={() => { setSelectedItem(item); }}>Choose</button> </li> ))} </ul> <p>You picked {selectedItem.title}.</p> </> ); }
目前,它将选定的项目作为对象存储在selectedItem
状态变量中。但是,这不太好:selectedItem
的内容与items
列表中的某个项目相同。这意味着项目本身的信息在两个地方都重复了。
为什么这是一个问题?让我们使每个项目都可编辑。
import { useState } from 'react'; const initialItems = [ { title: 'pretzels', id: 0 }, { title: 'crispy seaweed', id: 1 }, { title: 'granola bar', id: 2 }, ]; export default function Menu() { const [items, setItems] = useState(initialItems); const [selectedItem, setSelectedItem] = useState( items[0] ); function handleItemChange(id, e) { setItems(items.map(item => { if (item.id === id) { return { ...item, title: e.target.value, }; } else { return item; } })); } return ( <> <h2>What's your travel snack?</h2> <ul> {items.map((item, index) => ( <li key={item.id}> <input value={item.title} onChange={e => { handleItemChange(item.id, e) }} /> {' '} <button onClick={() => { setSelectedItem(item); }}>Choose</button> </li> ))} </ul> <p>You picked {selectedItem.title}.</p> </> ); }
请注意,如果你首先点击某个项目的“选择”,然后再编辑它,输入会更新,但底部的标签不会反映这些编辑。这是因为你重复了状态,并且忘记更新selectedItem
。
虽然你也可以更新selectedItem
,但一个更简单的解决方法是消除重复。在这个例子中,与其使用selectedItem
对象(这会在items
中的对象中创建重复),不如在状态中保存selectedId
,然后通过在items
数组中搜索具有该ID的项目来获取selectedItem
。
import { useState } from 'react'; const initialItems = [ { title: 'pretzels', id: 0 }, { title: 'crispy seaweed', id: 1 }, { title: 'granola bar', id: 2 }, ]; export default function Menu() { const [items, setItems] = useState(initialItems); const [selectedId, setSelectedId] = useState(0); const selectedItem = items.find(item => item.id === selectedId ); function handleItemChange(id, e) { setItems(items.map(item => { if (item.id === id) { return { ...item, title: e.target.value, }; } else { return item; } })); } return ( <> <h2>What's your travel snack?</h2> <ul> {items.map((item, index) => ( <li key={item.id}> <input value={item.title} onChange={e => { handleItemChange(item.id, e) }} /> {' '} <button onClick={() => { setSelectedId(item.id); }}>Choose</button> </li> ))} </ul> <p>You picked {selectedItem.title}.</p> </> ); }
以前的状态是这样的重复:
items = [{ id: 0, title: 'pretzels'}, ...]
selectedItem = {id: 0, title: 'pretzels'}
但更改后,它变成了这样:
items = [{ id: 0, title: 'pretzels'}, ...]
selectedId = 0
重复消失了,你只保留了必要的状态!
现在,如果你编辑选定的项目,下面的消息会立即更新。这是因为setItems
会触发重新渲染,而items.find(...)
会找到标题已更新的项目。你不需要在状态中保存选定的项目,因为只有选定的ID是必要的。其余可以在渲染过程中计算。
避免深度嵌套状态
想象一下一个包含行星、大陆和国家的旅行计划。你可能会倾向于使用嵌套的对象和数组来构建其状态,例如在这个例子中
export const initialTravelPlan = { id: 0, title: '(Root)', childPlaces: [{ id: 1, title: 'Earth', childPlaces: [{ id: 2, title: 'Africa', childPlaces: [{ id: 3, title: 'Botswana', childPlaces: [] }, { id: 4, title: 'Egypt', childPlaces: [] }, { id: 5, title: 'Kenya', childPlaces: [] }, { id: 6, title: 'Madagascar', childPlaces: [] }, { id: 7, title: 'Morocco', childPlaces: [] }, { id: 8, title: 'Nigeria', childPlaces: [] }, { id: 9, title: 'South Africa', childPlaces: [] }] }, { id: 10, title: 'Americas', childPlaces: [{ id: 11, title: 'Argentina', childPlaces: [] }, { id: 12, title: 'Brazil', childPlaces: [] }, { id: 13, title: 'Barbados', childPlaces: [] }, { id: 14, title: 'Canada', childPlaces: [] }, { id: 15, title: 'Jamaica', childPlaces: [] }, { id: 16, title: 'Mexico', childPlaces: [] }, { id: 17, title: 'Trinidad and Tobago', childPlaces: [] }, { id: 18, title: 'Venezuela', childPlaces: [] }] }, { id: 19, title: 'Asia', childPlaces: [{ id: 20, title: 'China', childPlaces: [] }, { id: 21, title: 'India', childPlaces: [] }, { id: 22, title: 'Singapore', childPlaces: [] }, { id: 23, title: 'South Korea', childPlaces: [] }, { id: 24, title: 'Thailand', childPlaces: [] }, { id: 25, title: 'Vietnam', childPlaces: [] }] }, { id: 26, title: 'Europe', childPlaces: [{ id: 27, title: 'Croatia', childPlaces: [], }, { id: 28, title: 'France', childPlaces: [], }, { id: 29, title: 'Germany', childPlaces: [], }, { id: 30, title: 'Italy', childPlaces: [], }, { id: 31, title: 'Portugal', childPlaces: [], }, { id: 32, title: 'Spain', childPlaces: [], }, { id: 33, title: 'Turkey', childPlaces: [], }] }, { id: 34, title: 'Oceania', childPlaces: [{ id: 35, title: 'Australia', childPlaces: [], }, { id: 36, title: 'Bora Bora (French Polynesia)', childPlaces: [], }, { id: 37, title: 'Easter Island (Chile)', childPlaces: [], }, { id: 38, title: 'Fiji', childPlaces: [], }, { id: 39, title: 'Hawaii (the USA)', childPlaces: [], }, { id: 40, title: 'New Zealand', childPlaces: [], }, { id: 41, title: 'Vanuatu', childPlaces: [], }] }] }, { id: 42, title: 'Moon', childPlaces: [{ id: 43, title: 'Rheita', childPlaces: [] }, { id: 44, title: 'Piccolomini', childPlaces: [] }, { id: 45, title: 'Tycho', childPlaces: [] }] }, { id: 46, title: 'Mars', childPlaces: [{ id: 47, title: 'Corn Town', childPlaces: [] }, { id: 48, title: 'Green Hill', childPlaces: [] }] }] };
现在假设你想添加一个按钮来删除你已经去过的地方。你会怎么做?更新嵌套状态涉及到从发生更改的部分一直向上复制对象。删除深度嵌套的地方将涉及到复制其整个父级位置链。这样的代码可能非常冗长。
如果状态嵌套太深,难以更新,请考虑将其“扁平化”。 以下是一种重构此数据的方法。与其采用树状结构,其中每个place
都包含其子位置的数组,不如让每个位置都包含其子位置 ID 的数组。然后,建立一个从每个位置 ID 到相应位置的映射。
这种数据重构可能会让你想起数据库表
export const initialTravelPlan = { 0: { id: 0, title: '(Root)', childIds: [1, 42, 46], }, 1: { id: 1, title: 'Earth', childIds: [2, 10, 19, 26, 34] }, 2: { id: 2, title: 'Africa', childIds: [3, 4, 5, 6 , 7, 8, 9] }, 3: { id: 3, title: 'Botswana', childIds: [] }, 4: { id: 4, title: 'Egypt', childIds: [] }, 5: { id: 5, title: 'Kenya', childIds: [] }, 6: { id: 6, title: 'Madagascar', childIds: [] }, 7: { id: 7, title: 'Morocco', childIds: [] }, 8: { id: 8, title: 'Nigeria', childIds: [] }, 9: { id: 9, title: 'South Africa', childIds: [] }, 10: { id: 10, title: 'Americas', childIds: [11, 12, 13, 14, 15, 16, 17, 18], }, 11: { id: 11, title: 'Argentina', childIds: [] }, 12: { id: 12, title: 'Brazil', childIds: [] }, 13: { id: 13, title: 'Barbados', childIds: [] }, 14: { id: 14, title: 'Canada', childIds: [] }, 15: { id: 15, title: 'Jamaica', childIds: [] }, 16: { id: 16, title: 'Mexico', childIds: [] }, 17: { id: 17, title: 'Trinidad and Tobago', childIds: [] }, 18: { id: 18, title: 'Venezuela', childIds: [] }, 19: { id: 19, title: 'Asia', childIds: [20, 21, 22, 23, 24, 25], }, 20: { id: 20, title: 'China', childIds: [] }, 21: { id: 21, title: 'India', childIds: [] }, 22: { id: 22, title: 'Singapore', childIds: [] }, 23: { id: 23, title: 'South Korea', childIds: [] }, 24: { id: 24, title: 'Thailand', childIds: [] }, 25: { id: 25, title: 'Vietnam', childIds: [] }, 26: { id: 26, title: 'Europe', childIds: [27, 28, 29, 30, 31, 32, 33], }, 27: { id: 27, title: 'Croatia', childIds: [] }, 28: { id: 28, title: 'France', childIds: [] }, 29: { id: 29, title: 'Germany', childIds: [] }, 30: { id: 30, title: 'Italy', childIds: [] }, 31: { id: 31, title: 'Portugal', childIds: [] }, 32: { id: 32, title: 'Spain', childIds: [] }, 33: { id: 33, title: 'Turkey', childIds: [] }, 34: { id: 34, title: 'Oceania', childIds: [35, 36, 37, 38, 39, 40, 41], }, 35: { id: 35, title: 'Australia', childIds: [] }, 36: { id: 36, title: 'Bora Bora (French Polynesia)', childIds: [] }, 37: { id: 37, title: 'Easter Island (Chile)', childIds: [] }, 38: { id: 38, title: 'Fiji', childIds: [] }, 39: { id: 40, title: 'Hawaii (the USA)', childIds: [] }, 40: { id: 40, title: 'New Zealand', childIds: [] }, 41: { id: 41, title: 'Vanuatu', childIds: [] }, 42: { id: 42, title: 'Moon', childIds: [43, 44, 45] }, 43: { id: 43, title: 'Rheita', childIds: [] }, 44: { id: 44, title: 'Piccolomini', childIds: [] }, 45: { id: 45, title: 'Tycho', childIds: [] }, 46: { id: 46, title: 'Mars', childIds: [47, 48] }, 47: { id: 47, title: 'Corn Town', childIds: [] }, 48: { id: 48, title: 'Green Hill', childIds: [] } };
现在状态已“扁平化”(也称为“规范化”),更新嵌套项变得更容易。
为了删除一个位置,现在只需要更新两层状态
- 其父级位置的更新版本应从其
childIds
数组中排除已删除的 ID。 - 根“表”对象的更新版本应包含父位置的更新版本。
以下是如何操作的示例
import { useState } from 'react'; import { initialTravelPlan } from './places.js'; export default function TravelPlan() { const [plan, setPlan] = useState(initialTravelPlan); function handleComplete(parentId, childId) { const parent = plan[parentId]; // Create a new version of the parent place // that doesn't include this child ID. const nextParent = { ...parent, childIds: parent.childIds .filter(id => id !== childId) }; // Update the root state object... setPlan({ ...plan, // ...so that it has the updated parent. [parentId]: nextParent }); } const root = plan[0]; const planetIds = root.childIds; return ( <> <h2>Places to visit</h2> <ol> {planetIds.map(id => ( <PlaceTree key={id} id={id} parentId={0} placesById={plan} onComplete={handleComplete} /> ))} </ol> </> ); } function PlaceTree({ id, parentId, placesById, onComplete }) { const place = placesById[id]; const childIds = place.childIds; return ( <li> {place.title} <button onClick={() => { onComplete(parentId, id); }}> Complete </button> {childIds.length > 0 && <ol> {childIds.map(childId => ( <PlaceTree key={childId} id={childId} parentId={id} placesById={placesById} onComplete={onComplete} /> ))} </ol> } </li> ); }
你可以根据需要嵌套状态,但是将其“扁平化”可以解决许多问题。它使状态更容易更新,并有助于确保你不会在嵌套对象的各个部分中出现重复。
深入探讨
理想情况下,你还应该从“表”对象中删除已删除的项目(及其子项!)以改进内存使用。此版本执行此操作。它还使用 Immer 使更新逻辑更简洁。
{ "dependencies": { "immer": "1.7.3", "react": "latest", "react-dom": "latest", "react-scripts": "latest", "use-immer": "0.5.1" }, "scripts": { "start": "react-scripts start", "build": "react-scripts build", "test": "react-scripts test --env=jsdom", "eject": "react-scripts eject" }, "devDependencies": {} }
有时,你还可以通过将一些嵌套状态移动到子组件中来减少状态嵌套。这对于不需要存储的短暂 UI 状态(例如项目是否被悬停)非常有效。
总结
- 如果两个状态变量总是同时更新,请考虑将它们合并为一个。
- 仔细选择状态变量,以避免创建“不可能”的状态。
- 以减少出错几率的方式来构建你的状态。
- 避免冗余和重复的状态,这样你就无需保持同步。
- 除非你特别想要阻止更新,否则不要将 props 放入状态。
- 对于像选择这样的 UI 模式,请在状态中保留 ID 或索引,而不是对象本身。
- 如果更新深度嵌套状态很复杂,尝试将其扁平化。
挑战 1的 4: 修复未更新的组件
这个Clock
组件接收两个 props:color
和time
。当你在选择框中选择不同的颜色时,Clock
组件从其父组件接收不同的color
prop。但是,由于某种原因,显示的颜色没有更新。为什么?修复此问题。
import { useState } from 'react'; export default function Clock(props) { const [color, setColor] = useState(props.color); return ( <h1 style={{ color: color }}> {props.time} </h1> ); }