Fullstack CourseLearn by building
Back to week 2

Topic

Manipulating the DOM with refs

Definition

DOM refs provide imperative access to a rendered DOM element for focused integration work such as focus, scroll, or measurement.

In simpler words

Most UI should be declarative, but a ref is the right bridge when the browser API needs the real element.

Ref assignment, focus management, and avoiding DOM conflicts.

After this you can

  • Focus an input or scroll to an important result accessibly.
  • Explain the trade-off to a teammate using a small example.
  • Name at least one common bug pattern for this topic.

Understand Manipulating the DOM with refs

Ref assignment, focus management, and avoiding DOM conflicts.

Start by identifying which value or browser behavior changes. Then describe the UI from that current input instead of editing the DOM as a separate source of truth.

Manipulating the DOM with refs in code

const inputRef = useRef<HTMLInputElement>(null);
<button onClick={() => inputRef.current?.focus()}>Focus</button>;

Read the example from data and control flow to the resulting UI. Keep the component boundary small.

Apply Manipulating the DOM with refs

Keep rendering as a calculation. Put user-triggered changes in event handlers, preserve UI memory in state, and reserve external synchronization for Effects or the server-state layer.

Name values by their UI meaning, test the loading and error path when data is remote, and avoid keeping two editable copies of the same value.

Ask before adding code: is this local UI memory, shared client state, or Nest-owned server state?

Where bugs hide

Definition

High-bug areas are places where a small API misuse looks correct but produces stale UI, duplicate work, or silent failures.

In simpler words

Each mistake below shows Wrong vs Right code — compare them side by side.

When something misbehaves, match the symptom to a pattern below before rewriting the feature.

Prefer fixing the ownership or update path over adding another Effect or sync step.

Mistake: Write display text via ref

// Wrong
ref.current!.textContent = title;

// Right
return <p ref={ref}>{title}</p>;

Declare UI from state; refs are for imperative browser APIs.

Mistake: focus() every render

// Wrong
function Field() {
  const ref = useRef(null);
  ref.current?.focus();
  return <input ref={ref} />;
}

// Right
useEffect(() => { ref.current?.focus(); }, []);
// or on user action

Unconditional focus fights the user and accessibility.

Mistake: Stale DOM node after unmount

// Wrong
// keep element reference in a module variable

// Right
// read ref.current only while mounted; null on cleanup if needed

Do not use DOM nodes after unmount.

Live playground

Manipulating the DOM with refs sandbox

Change one input at a time and predict the next render.

inputRef.current?.focus()

Keep in mind

  • Keep the formal definition in mind; it explains which tool belongs where.
  • Prefer one source of truth over synchronized copies of the same value.
  • When behavior surprises you, trace: input → update → render → committed UI.
  • Study the Wrong vs Right examples in “Where bugs hide” before you merge.

Test

Check your understanding

At least 10 questions — mix of concept, syntax, practical, and logic. Score ≥ 80% (enforced by the API) to save progress.

Checking your session…

10 questions · concept 3 · syntax 3 · practical 2 · logic 2

Concept1. Which statement best defines Manipulating the DOM with refs?
Syntax2. Which implementation matches Manipulating the DOM with refs?
Practical3. When building a feature, when is Manipulating the DOM with refs the right choice?
Logic4. What reasoning keeps Manipulating the DOM with refs predictable as values change?
Concept5. Which statement best defines Manipulating the DOM with refs?
Syntax6. Which implementation matches Manipulating the DOM with refs?
Practical7. When building a feature, when is Manipulating the DOM with refs the right choice?
Logic8. What reasoning keeps Manipulating the DOM with refs predictable as values change?
Concept9. Which statement best defines Manipulating the DOM with refs?
Syntax10. Which implementation matches Manipulating the DOM with refs?