xonecas.io
556
Bn

bees-nest / files

bees-nest / .opencode / skills / vercel-react-best-practices / rules / rerender-use-ref-transient-values.md

1.7 KB
1---
2title: Use useRef for Transient Values
3impact: MEDIUM
4impactDescription: avoids unnecessary re-renders on frequent updates
5tags: rerender, useref, state, performance
6---
7
8## Use useRef for Transient Values
9
10When a value changes frequently and you don't want a re-render on every update (e.g., mouse trackers, intervals, transient flags), store it in `useRef` instead of `useState`. Keep component state for UI; use refs for temporary DOM-adjacent values. Updating a ref does not trigger a re-render.
11
12**Incorrect (renders every update):**
13
14```tsx
15function Tracker() {
16  const [lastX, setLastX] = useState(0)
17
18  useEffect(() => {
19    const onMove = (e: MouseEvent) => setLastX(e.clientX)
20    window.addEventListener('mousemove', onMove)
21    return () => window.removeEventListener('mousemove', onMove)
22  }, [])
23
24  return (
25    <div
26      style={{
27        position: 'fixed',
28        top: 0,
29        left: lastX,
30        width: 8,
31        height: 8,
32        background: 'black',
33      }}
34    />
35  )
36}
37```
38
39**Correct (no re-render for tracking):**
40
41```tsx
42function Tracker() {
43  const lastXRef = useRef(0)
44  const dotRef = useRef<HTMLDivElement>(null)
45
46  useEffect(() => {
47    const onMove = (e: MouseEvent) => {
48      lastXRef.current = e.clientX
49      const node = dotRef.current
50      if (node) {
51        node.style.transform = `translateX(${e.clientX}px)`
52      }
53    }
54    window.addEventListener('mousemove', onMove)
55    return () => window.removeEventListener('mousemove', onMove)
56  }, [])
57
58  return (
59    <div
60      ref={dotRef}
61      style={{
62        position: 'fixed',
63        top: 0,
64        left: 0,
65        width: 8,
66        height: 8,
67        background: 'black',
68        transform: 'translateX(0px)',
69      }}
70    />
71  )
72}
73```