https://ko.react.dev/reference/react/useDeferredValue UI ์ผ๋ถ€์˜ ์—…๋ฐ์ดํŠธ๋ฅผ ์ง€์—ฐ์‹œํ‚ฌ ์ˆ˜ ์žˆ๋Š” React ํ›…

const deferredValue = useDeferredValue(value)

Parameter

  • value : ์ง€์—ฐ์‹œํ‚ค๋ ค๋Š” ๊ฐ’. ์–ด๋–ค ํƒ€์ž…์ด๋“  ๋  ์ˆ˜ ์žˆ๋‹ค

Returns

  • value : ์ง€์—ฐ๋œ ๊ฐ’
    • ์ดˆ๊ธฐ ๋ Œ๋”๋ง ์ค‘์—๋Š” ์‚ฌ์šฉ์ž๊ฐ€ ์ œ๊ณตํ•œ ๊ฐ’๊ณผ ๋™์ผํ•จ
    • ์—…๋ฐ์ดํŠธ ๋ฐœ์ƒ ์‹œ React๋Š” ๋จผ์ € ์ด์ „ ๊ฐ’์œผ๋กœ ๋ Œ๋”๋ง์„ ์œ ์ง€ํ•˜๊ณ , ๋ฐฑ๊ทธ๋ผ์šด๋“œ์—์„œ ๋‹ค์‹œ ์ƒˆ ๊ฐ’์œผ๋กœ ๋ฆฌ๋ Œ๋”๋ง์„ ์‹œ๋„

Caveats

  • ๋ Œ๋”๋ง ์ค‘์— ์ƒˆ ๊ฐ์ฒด๋ฅผ ์ƒ์„ฑํ•˜๊ณ  ๋ฐ”๋กœ useDeferredValue์— ์ „๋‹ฌํ•˜๋ฉด ๋งค ๋ฆฌ๋ Œ๋”๋ง๋งˆ๋‹ค ๊ฐ’์ด ๋‹ฌ๋ผ์ ธ ๋งค๋ฒˆ ๋ฐฑ๊ทธ๋ผ์šด๋“œ ๋ฆฌ๋ Œ๋”๋ง์ด ๋ฐœ์ƒํ•œ๋‹ค.
  • useDeferredValue๋Š” ๋ฐฑ๊ทธ๋ผ์šด๋“œ์—์„œ ๋ฆฌ๋ Œ๋”๋ง ์ค‘, ๋˜ ๋‹ค๋ฅธ ์—…๋ฐ์ดํŠธ๋ฅผ ๋ฐ›์œผ๋ฉด ๊ทธ ๋ฐฑ๊ทธ๋ผ์šด๋“œ ๋ฆฌ๋ Œ๋”๋ง์„ ์ค‘๋‹จํ•  ์ˆ˜ ์žˆ๋‹ค.
    • ex) ๋ฆฌ๋ Œ๋”๋ง ๋˜๋Š” ์‹œ๊ฐ„๋ณด๋‹ค ์‚ฌ์šฉ์ž ์ž…๋ ฅ์ด ๋” ๋น ๋ฅด๋ฉด, ์‚ฌ์šฉ์ž ์ž…๋ ฅ์ด ๋ชจ๋‘ ์ข…๋ฃŒ๋œ ํ›„์— ์—…๋ฐ์ดํŠธ ๋จ
  • Suspense ๋Š” ๋ฐ˜์‘ํ•˜์ง€ ์•Š๋Š”๋‹ค. ์ƒˆ๊ฐ’์œผ๋กœ ์ธํ•œ ๋ฐฑ๊ทธ๋ผ์šด๋“œ ์—…๋ฐ์ดํŠธ๋กœ ์ธํ•ด UI๊ฐ€ ์ผ์‹œ ์ค‘๋‹จ๋ผ๋„ ์‚ฌ์šฉ์ž์—๊ฒŒ ํ’€๋ฐฑ์ด ํ‘œ์‹œ ๋˜์ง€ ์•Š๋Š”๋‹ค. ๋ฐฑ๊ทธ๋ผ์šด๋“œ ๋ฆฌ๋ Œ๋”๋ง์ด ์™„๋ฃŒ๋  ๋•Œ๊นŒ์ง€ ๊ธฐ์กด์˜ ๊ฐ’์ด ํ‘œ์‹œ๋œ๋‹ค.
  • useDeferredValue๋Š” ๊ทธ ์ž์ฒด๋กœ ์ถ”๊ฐ€ ๋„คํŠธ์›Œํฌ ์š”์ฒญ์„ ๋ง‰์ง€ ์•Š๋Š”๋‹ค.
  • ๋ฆฌ์•กํŠธ๋Š” ์›๋ž˜์˜ ๋ฆฌ๋ Œ๋”๋ง์„ ์™„๋ฃŒํ•˜์ž๋งˆ์ž, ์ฆ‰์‹œ ์ƒˆ๋กœ์šด ์ง€์—ฐ๋œ ๊ฐ’์œผ๋กœ ๋ฐฑ๊ทธ๋ผ์šด๋“œ ๋ฆฌ๋ Œ๋”๋ง์„ ์‹œ์ž‘ํ•œ๋‹ค. ๊ทธ๋Ÿฌ๋‚˜ ์ด๋ฒคํŠธ๋กœ ์ธํ•œ ์—…๋ฐ์ดํŠธ(ํƒ€์ดํ•‘ ๋“ฑ)๋Š” ๋ฐฑ๊ทธ๋ผ์šด๋“œ ๋ฆฌ๋ Œ๋”๋ง์„ ์ค‘๋‹จํ•˜๊ณ  ์šฐ์„ ์ˆœ์œ„๋ฅผ ๊ฐ–๋Š”๋‹ค.
  • useDeferredValue๋กœ ์ธํ•œ ๋ฐฑ๊ทธ๋ผ์šด๋“œ ๋ฆฌ๋ Œ๋”๋ง์€ ํ™”๋ฉด์— ์ปค๋ฐ‹๋  ๋•Œ๊นŒ์ง€ Effect๋ฅผ ์‹คํ–‰ํ•˜์ง€ ์•Š๋Š”๋‹ค. ๋ฐฑ๊ทธ๋ผ์šด๋“œ ๋ฆฌ๋ Œ๋”๋ง์ด ์ค‘๋‹จ ๋˜๋ฉด ๋ฐ์ดํ„ฐ๊ฐ€ ๋กœ๋“œ๋˜๊ณ  UI๊ฐ€ ์—…๋ฐ์ดํŠธ๋œ ํ›„์— ํ•ด๋‹น Effect๊ฐ€ ์‹คํ–‰๋œ๋‹ค.

๋™์ž‘๋ฐฉ์‹

export default function App() {
  const [query, setQuery] = useState('');
  const deferredQuery = useDeferredValue(query);
  return (
    <>
      <label>
        Search albums:
        <input value={query} onChange={e => setQuery(e.target.value)} />
      </label>
      <Suspense fallback={<h2>Loading...</h2>}>
        <SearchResults query={deferredQuery} />
      </Suspense>
    </>
  );
}
  1. ๋จผ์ € React๋Š” query๊ฐ€ ์—…๋ฐ์ดํŠธ ๋˜์–ด๋„ deferredQuery๋Š” ์ด์ „ ๊ฐ’์„ ์œ ์ง€ํ•œ๋‹ค. ๋”ฐ๋ผ์„œ ์ƒˆ๋กœ์šด query๋ฅผ ์‚ฌ์šฉํ•˜๋Š” ์ปดํฌ๋„ŒํŠธ๋“ค์€ ๋ฆฌ๋ Œ๋”๋ง๋˜์ง€๋งŒ, deferredQuery๋ฅผ ์‚ฌ์šฉํ•˜๋Š” ๊ณณ์€ ์ด์ „ ๊ฐ’์„ ๊ณ„์† ์œ ์ง€ํ•œ๋‹ค. (๋ถ€๋ชจ๊ฐ€ ๋ฆฌ๋ Œ๋”๋งํ•˜๋‹ˆ SearchResults๋„ ๋ฆฌ๋ Œ๋”๋ง์€ ๋ฐœ์ƒํ•œ๋‹ค.)
  2. ๋™์‹œ์— ๋ฐฑ๊ทธ๋ผ์šด๋“œ์—์„œ๋Š” ์ƒˆ๋กœ ๋ณ€๊ฒฝ๋œ deferredQuery๋กœ ๋ฆฌ๋ Œ๋”๋ง์„ ์ง„ํ–‰ํ•œ๋‹ค.
  3. ๋ฐฑ๊ทธ๋ผ์šด๋“œ ๋ฆฌ๋ Œ๋”๋ง์ด ์™„๋ฃŒ๋˜๋ฉด ํ™”๋ฉด์— ์ปค๋ฐ‹ํ•œ๋‹ค.

Usage

Showing stale content while fresh content is loading

useDeferredValue๋Š” ์ง€์—ฐ๋˜๋Š” ๋™์•ˆ ์ด์ „ ํ™”๋ฉด์„ ๋…ธ์ถœํ•˜๋ฉฐ, Suspense ํด๋ฐฑ๋„ ๋„์šฐ์ง€ ์•Š๋Š”๋‹ค. ๋”ฐ๋ผ์„œ ์˜ค๋ž˜ ๊ฑธ๋ฆฌ๋Š” ๊ฑธ ๋ฆฌ๋ Œ๋”๋งํ•  ๋•Œ ์ด์ „ ๊ฐ’์œผ๋กœ ํ™”๋ฉด์„ ๋„์šฐ๊ธฐ ์œ„ํ•ด ์‚ฌ์šฉํ•  ์ˆ˜ ์žˆ๋‹ค.

Indicating that the content is stale

UI๊ฐ€ ์ง€์—ฐ๋˜๋Š” ๋™์•ˆ ํ˜„์žฌ ํ™”๋ฉด์ด ์˜ค๋ž˜๋œ ๋‚ด์šฉ์ด๋ผ๋Š” ๊ฒƒ์„ ๋ณด์—ฌ์ค„ ์ˆ˜๋„ ์žˆ๋‹ค.

export default function App() {
  const [query, setQuery] = useState('');
  const deferredQuery = useDeferredValue(query);
  const isStale = query !== deferredQuery;
  return (
    <>
      <label>
        Search albums:
        <input value={query} onChange={e => setQuery(e.target.value)} />
      </label>
      <Suspense fallback={<h2>Loading...</h2>}>
        <div style={{
          opacity: isStale ? 0.5 : 1,
          transition: isStale ? 'opacity 0.2s 0.2s linear' : 'opacity 0s 0s linear'
        }}>
          <SearchResults query={deferredQuery} />
        </div>
      </Suspense>
    </>
  );
}

Deferring re-rendering for a part of the UI

๋ฌด๊ฑฐ์šด ์ปดํฌ๋„ŒํŠธ๋ฅผ ๋ฆฌ๋ Œ๋”๋ง ์‹œํ‚ฌ ๋•Œ, ๊ทธ ์ปดํฌ๋„ŒํŠธ๊ฐ€ ๋ฆฌ๋ Œ๋”๋งํ•˜๋Š” ๋™์•ˆ ๋‚˜๋จธ์ง€ UI๋ฅผ ์ฐจ๋‹จํ•˜์ง€ ์•Š๋„๋ก ์ตœ์ ํ™”๋ฅผ ์œ„ํ•ด ์‚ฌ์šฉํ•  ์ˆ˜ ์žˆ๋‹ค.

์ด๋•Œ ๊ทธ ๋ฌด๊ฑฐ์šด ์ปดํฌ๋„ŒํŠธ๋ฅผ memo๋กœ ๊ฐ์‹ธ์•ผํ•œ๋‹ค. ๊ทธ๋ ‡์ง€ ์•Š์œผ๋ฉด ์–ด์จŒ๋“  ๋ถ€๋ชจ ์ปดํฌ๋„ŒํŠธ๊ฐ€ ์—…๋ฐ์ดํŠธ๋˜๋ฉด ๋‹ค์‹œ ๋ Œ๋”๋งํ•ด์•ผํ•˜๋ฏ€๋กœ ์ตœ์ ํ™”์˜ ์ทจ์ง€๊ฐ€ ๋ฌด์ƒ‰ํ•ด์ง„๋‹ค.

import { useState, memo } from 'react';
import SlowList from './SlowList.js';
 
export default function App() {
  const [text, setText] = useState('');
  return (
    <>
      <input value={text} onChange={e => setText(e.target.value)} />
      <SlowList text={text} />
    </>
  );
}
 
 
const SlowList = memo(function SlowList({ text }) {
  // Log once. The actual slowdown is inside SlowItem.
  console.log('[ARTIFICIALLY SLOW] Rendering 250 <SlowItem />');
 
  let items = [];
  for (let i = 0; i < 250; i++) {
    items.push(<SlowItem key={i} text={text} />);
  }
  return (
    <ul className="items">
      {items}
    </ul>
  );
});

review