https://ko.react.dev/reference/react/Suspense
์์์ด ๋ก๋ฉ์ ์๋ฃํ ๋๊น์ง fallback์ ํ์ํ๋ค
<Suspense fallback={<Loading/>}>
<SomeComponent/>
</Suspense>Props
children: ๋ ๋๋งํ๋ ค๋ ์ค์ UI. ๋ ๋๋ง ๋์children์ด ์ผ์์ค๋จ๋๋ฉด Suspense ๊ฒฝ๊ณ๊ฐ fallback์ผ๋ก ์ ํ๋๋ค.fallback:children์ด ์ผ์์ค๋จ๋๋ ๋์ ๋์ฒดํ UI.fallback๋ํ ์ค๋จ๋๋ฉด ๊ฐ์ฅ ๊ฐ๊น์ด ์์Suspense๊ฐ ํ์ฑํ๋๋ค.
Caveats
- React๋ ์ฒ์ ๋ง์ดํธ ํ๊ธฐ ์ ์ ์ผ์ ์ค๋จ๋ ๋ ๋๋ง์ state๋ฅผ ๋ณด์กดํ์ง ์๋๋ค. ์ปดํฌ๋ํธ ๋ก๋ ํ ์ผ์ ์ค๋จ๋ ๋ ๋๋ง์ ์ฒ์๋ถํฐ ๋ค์ ์๋ํ๋ค.
- Suspense๊ฐ ์ฝํ
์ธ ๋ฅผ ํ์ํ๊ณ ์๋ค๊ฐ ๋ค์ ์ผ์ ์ค๋จ๋๋ฉด, ๊ทธ๊ฒ์ด
startTransition์ด๋useDeferredValue๋ก ์ธํ ๊ฒ์ด ์๋ ๊ฒฝ์ฐfallback์ด ๋ค์ ํ์๋๋ค. - React๊ฐ ๋ค์ ์ผ์ ์ค๋จ๋์ด ์ฝํ
์ธ ๋ฅผ ์จ๊ฒจ์ผํ๋ ๊ฒฝ์ฐ, ์ฝํ
์ธ ํธ๋ฆฌ์์
useLayoutEffect๋ฅผ ํด๋ฆฐ์ ํ๋ค. ์ดํ ๋ค์ ํ์ํ ์ค๋น๊ฐ ๋๋ฉดuseLayoutEffect๋ฅผ ๋ค์ ์คํํจ์ผ๋ก์จ ์ฝํ ์ธ ๊ฐ ์จ๊ฒจ์ ธ์๋ ๋์ DOM ๋ ์ด์์์ ์ธก์ ํ๋ Effect๊ฐ ํด๋น ์์ ์ ์๋ํ์ง ์๋๋ก ํ๋ค. - React์๋ Suspense์ ํตํฉ๋ ์คํธ๋ฆฌ๋ฐ ์๋ฒ ๋ ๋๋ง ๋ฐ ์ ํ์ Hydration๊ณผ ๊ฐ์ ์ต์ ํ๊ฐ ํฌํจ๋์ด ์๋ค.
Suspense ๋ฐ๋ ์กฐ๊ฑด
์ค์ง Suspense๋ฅผ ๋์ ํ ๋ฐ์ดํฐ ์์ค์์๋ง Suspense ๋ฅผ ํ์ฑํํ ์ ์๋ค.
- Relay ๋ฐ next.js์ ๊ฐ์ Suspense ๋์ ํ๋ ์์ํฌ๋ฅผ ์ฌ์ฉํ ๋ฐ์ดํฐ ํจ์นญ
- lazy๋ฅผ ์ฌ์ฉํ ์ง์ฐ ๋ก๋ฉ ์ปดํฌ๋ํธ ์ฝ๋
- use๋ฅผ ์ฌ์ฉํด์ Promise ๊ฐ ์ฝ๊ธฐ
Effect๋ ์ด๋ฒคํธ ํธ๋ค๋ฌ ๋ด๋ถ์์ ๋ฐ์ดํฐ ํจ์นญ์ ํ๋ ๊ฒฝ์ฐ๋ ๊ฐ์งํ์ง ์๋๋ค. ํ๋ ์์ํฌ๋ฅผ ์ ์ธํ Suspense์ ์ฌ์ฉ์ ํ์ฌ๋ก์ฌ ์ง์๋์ง ์๋๋ค.
Usage
Revealing content together at once
Suspense ์๋ ์ปดํฌ๋ํธ๋ ๊ทธ ์ค ํ๋๋ง ์ผ์ ์ค๋จ๋์ด๋ ์ ์ฒด๊ฐ fallback์ผ๋ก ๋์ฒด๋๋ค.
<Suspense fallback={<Loading />}>
<Biography artistId={artist.id} />
<Panel>
<Albums artistId={artist.id} />
</Panel>
</Suspense>Revealing nested content as it loads
์ปดํฌ๋ํธ๊ฐ ์ผ์ ์ค๋จ๋๋ฉด ๊ฐ์ฅ ๊ฐ๊น์ด Suspense๊ฐ fallback์ ํ์ํ๋ค. ์ด๋ฅผ ์ค์ฒฉํ์ฌ ๋ก๋ฉ ์ํ์ค๋ฅผ ๋ง๋ค ์ ์๋ค.
<Suspense fallback={<BigSpinner />}>
<Biography />
<Suspense fallback={<AlbumsGlimmer />}>
<Panel>
<Albums />
</Panel>
</Suspense>
</Suspense>- Biography๊ฐ ์๋ฃ๋๋ฉด ๋จผ์ ํ์ํ๊ณ , Album์ด ์๋ฃ๋ ๋๊น์ง ๋๋ฒ์งธ Suspense๋ ์์ ์ fallback์ ํ์ํ๋ค.
Showing stale content while fresh content is loading
useDeferredValue์ ์ฌ์ฉํ์ฌ ์
๋ฐ์ดํธ๋ฅผ ์ฐ๊ธฐํ๊ณ fallback ๋์ ์ด์ ๊ฒฐ๊ณผ๋ฅผ ๊ณ์ ํ์ํ ์๋ ์๋ค.
import { Suspense, useState, useDeferredValue } from 'react';
import SearchResults from './SearchResults.js';
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 }}>
<SearchResults query={deferredQuery} />
</div>
</Suspense>
</>
);
}
startTransition๋ ๋ง์ฐฌ๊ฐ์ง๋ก ํ ์ ์๋ค.
Preventing already revealed content from hiding
startTransition์ ์ฌ์ฉํ์ฌ ์
๋ฐ์ดํธ ๋ฐ์ ์ ์ด๋ฏธ ํ์๋ ์ฝํ
์ธ ๋ฅผ fallback ๋์ ๊ณ์ ํ์ํ ์ ์๋ค.
import { Suspense, startTransition, useState } from 'react';
import IndexPage from './IndexPage.js';
import ArtistPage from './ArtistPage.js';
import Layout from './Layout.js';
export default function App() {
return (
<Suspense fallback={<BigSpinner />}>
<Router />
</Suspense>
);
}
function Router() {
const [page, setPage] = useState('/');
function navigate(url) {
startTransition(() => {
setPage(url);
});
}
let content;
if (page === '/') {
content = (
<IndexPage navigate={navigate} />
);
} else if (page === '/the-beatles') {
content = (
<ArtistPage
artist={{
id: 'the-beatles',
name: 'The Beatles',
}}
/>
);
}
return (
<Layout>
{content}
</Layout>
);
}
function BigSpinner() {
return <h2>๐ Loading...</h2>;
}