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>
</>
);
}- ๋จผ์ React๋ query๊ฐ ์
๋ฐ์ดํธ ๋์ด๋ deferredQuery๋ ์ด์ ๊ฐ์ ์ ์งํ๋ค. ๋ฐ๋ผ์ ์๋ก์ด query๋ฅผ ์ฌ์ฉํ๋ ์ปดํฌ๋ํธ๋ค์ ๋ฆฌ๋ ๋๋ง๋์ง๋ง, deferredQuery๋ฅผ ์ฌ์ฉํ๋ ๊ณณ์ ์ด์ ๊ฐ์ ๊ณ์ ์ ์งํ๋ค. (๋ถ๋ชจ๊ฐ ๋ฆฌ๋ ๋๋งํ๋
SearchResults๋ ๋ฆฌ๋ ๋๋ง์ ๋ฐ์ํ๋ค.) - ๋์์ ๋ฐฑ๊ทธ๋ผ์ด๋์์๋ ์๋ก ๋ณ๊ฒฝ๋ deferredQuery๋ก ๋ฆฌ๋ ๋๋ง์ ์งํํ๋ค.
- ๋ฐฑ๊ทธ๋ผ์ด๋ ๋ฆฌ๋ ๋๋ง์ด ์๋ฃ๋๋ฉด ํ๋ฉด์ ์ปค๋ฐํ๋ค.
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>
);
});