https://ko.react.dev/reference/react/useTransition
UI๋ฅผ ์ฐจ๋จํ์ง ์๊ณ state๋ฅผ ์ ๋ฐ์ดํธํ ์ ์๋ React ํ
const [isPending, startTransition] = useTransition();Parameter
- ๋งค๊ฐ๋ณ์๋ฅผ ๋ฐ์ง ์์
Returns
- ๊ฐ์ด ๋๊ฐ ๋ค์ด์๋ ๋ฐฐ์ด ๋ฐํ
isPending: ์งํ ์ค์ธ ํธ๋์ง์ ์ด ์๋์ง ์ฌ๋ถ๋ฅผ ์๋ ค์ฃผ๋ ํ๋๊ทธstartTransition: state ์ ๋ฐ์ดํธ๋ฅผ ํธ๋์ง์ ์ผ๋ก ํ์ํ ์ ์๋ ํจ์
startTransition ํจ์
startTransition ์์์ ์ํ ์
๋ฐ์ดํธ๋ฅผ ์ํํ๋ฉด state ์
๋ฐ์ดํธ๋ฅผ transition์ผ๋ก mark ํ ์ ์๋ค.
function selectTab(nextTab) {
startTransition(() => {
setTab(nextTab);
});
}- Parameter
scope- ํ๋ ์ด์์ set ํจ์๋ฅผ ํธ์ถํด์ ์ผ๋ถ state๋ฅผ ์ ๋ฐ์ดํธํ๋ ํจ์
- React๋ ๋งค๊ฐ๋ณ์ ์์ด scope๋ฅผ ์ฆ์ ํธ์ถํ๊ณ , ํธ์ถ ์ค์ ๋๊ธฐ์ ์ผ๋ก ์์ฝ๋ state ์
๋ฐ์ดํธ๋ฅผ ํธ๋์ง์
์ผ๋ก mark ํ๋ค.
- ์ง์ ์ ์ผ๋ก set ํจ์๋ฅผ ํธ์ถํ์ง ์๊ณ , ๋ค๋ฅธ ํจ์์ ํธ์ถํ๋๋ฐ ๊ทธ ํจ์ ์์์ set ํจ์๋ฅผ ํธ์ถํ๋ ๋ฑ ๊ฐ์ ์ ์ธ ๊ฒฝ์ฐ์๋ ํธ๋์ง์ ์ผ๋ก mark ๋๋ค.
- ์ด ๊ณผ์ ์ ๋ ผ๋ธ๋กํน์ด๊ณ , ์์น์๋ ๋ก๋ฉ์ ํ์ํ์ง ์๋๋ค.
Caveats
useTransiton์ ํ ์ด๋ฏ๋ก ์ปดํฌ๋ํธ๋ ์ปค์คํ ํ ๋ด๋ถ์์๋ง ํธ์ถ ๊ฐ๋ฅํ๋ค. ๋ค๋ฅธ ๊ณณ์์ ํธ์ถํ๊ณ ์ถ์ผ๋ฉด ๋ ๋ฆฝํ startTransition์ ์ฌ์ฉํ๋ผ- ํด๋น state์ set ํจ์์ ์ ๊ทผ ๊ฐ๋ฅํ ๋๋ง ํธ๋์ง์ ์ผ๋ก ๊ฐ์ ์ ์๋ค. prop์ด๋ ์ปค์คํ ํ ๊ฐ์ ๋ํ ์๋ต์ผ๋ก ํธ๋์ง์ ์ ์์ํ๋ ค๋ฉด useDeferredValue๋ฅผ ์ฌ์ฉํ๋ผ
startTransition์ ์ ๋ฌ๋๋ ํจ์๋ ๋๊ธฐ์ ์ด์ด์ผํ๋ค.- ํธ๋์ง์
์ผ๋ก ํ์๋ state ์
๋ฐ์ดํธ๋ ๋ค๋ฅธ state ์
๋ฐ์ดํธ์ ์ํด ์ค๋จ๋๋ค.
- ex) ํธ๋์ง์ ๋ด์์ ์ฐจํธ ์ปดํฌ๋ํธ๋ฅผ ์ ๋ฐ์ดํธํ ๋ค์, ์ฐจํธ๊ฐ ๋ค์ ๋ ๋๋ง๋๋ ๋์ค์ ์ ๋ ฅ์ ์์ํ๋ฉด React๋ ์ ๋ ฅ ์ ๋ฐ์ดํธ๋ฅผ ์ฒ๋ฆฌํ ํ ์ฐจํธ ์ปดํฌ๋ํธ์์ ๋ ๋๋ง ์์ ์ ๋ค์ ์์ํ๋ค
- ํธ๋์ง์ ์ ๋ฐ์ดํธ๋ก ํ ์คํธ ์ ๋ ฅ์ ์ ์ดํ๋๋ฐ ์ฌ์ฉํ ์ ์๋ค
- ์งํ์ค์ธ ํธ๋์ง์ ์ด ์ฌ๋ฌ ๊ฐ์ผ ๊ฒฝ์ฐ, React๋ ํ์ฌ ํธ๋์ง์ ์ ํจ๊ป ์ผ๊ด ์ฒ๋ฆฌํ๋ค. (์ด๋ ์ดํ ๋ฆด๋ฆฌ์ฆ์์ ์ ๊ฑฐ๋ ์๋ ์๋ค)
Usage
Marking a state update as a non-bloking transition
- ์ํ ์
๋ฐ์ดํธ๋ฅผ ํธ๋์ง์
์ผ๋ก mark ํ๋ฉด ๋ฆฌ๋ ๋๋ง ๋์ค์๋ UI๊ฐ ๋ฐ์์ฑ์ ์ ์งํ๋ค
- ex) ์ฌ์ฉ์๊ฐ ํญ์ ํด๋ฆญํ๋ค๊ฐ ๋ค์ ๋ฐ๊ฟ ๊ฒฝ์ฐ ์ฒซ๋ฒ์ฌ ๋ฆฌ๋ ๋๋ง์ด ์๋ฃ๋ ๋๊น์ง ๊ธฐ๋ค๋ฆฌ์ง ์๊ณ ๋ ๋ค๋ฅธ ํญ์ ํด๋ฆญํ ์ ์๋ค
Updating the parent component in a transition
๋ค์๊ณผ ๊ฐ์ด prop์ผ๋ก ๋์ด์จ ํจ์๋ฅผ startTransition์์ ํธ์ถํด๋ onClick ๋ด๋ถ์ ์ํ ์
๋ฐ์ดํธ๊ฐ ํธ๋์ง์
์ผ๋ก mark ๋๋ค
export default function TabButton({ children, isActive, onClick }) {
const [isPending, startTransition] = useTransition();
return (
<button onClick={() => {
startTransition(() => {
onClick();
});
}}/>
)
}Displaying a pending visual state during the transition
isPending์ ์งํ ์ค์ธ ํธ๋์ง์
์ด ์์๋ true๊ฐ ๋๋ฏ๋ก, ๋ค์๊ณผ ๊ฐ์ด ํธ๋์ง์
์ด ์งํ๋๊ณ ์์์ ์ฌ์ฉ์์๊ฒ ์๋ฆด ์ ์๋ค
export default function TabButton({ children, isActive, onClick }) {
const [isPending, startTransition] = useTransition();
if (isPending) {
return <b className="pending">{children}</b>;
}
...Preventing unwanted loading indicators
Suspense๋ฅผ ์ฌ์ฉํ๋ฉด ์ปดํฌ๋ํธ ์ค๋จ ์ ๊ฐ์ฅ ๊ฐ๊น์ด ๋ก๋ฉ ํด๋ฐฑ์ด ๋ํ๋๋ค. ํ์ง๋ง ์ด๋ฌํ ํด๋ฐฑ์ ๋ง๊ณ ์ถ์ ๋๊ฐ ์๋๋ฐ, ์ด๋ด๋ startTransition์ ์ฌ์ฉํ๋ฉด ํด๋ฐฑ์ ์๋์ธ ์ ์๋ค.
Building a Suspense-enabled router
React ํ๋ ์์ํฌ๋ ๋ผ์ฐํฐ๋ฅผ ๊ตฌ์ถํ๋ ๊ฒฝ์ฐ ํ์ด์ง ๋ค๋น๊ฒ์ด์ ์ ํธ๋์ง์ ์ผ๋ก mark ํ๋ ๊ฒ์ด ์ข๋ค
- ํธ๋์ง์ ์ ์ค๋จ๊ฐ๋ฅํ๊ธฐ์ ์ฌ์ฉ์๋ ๋ค์ ๋ ๋๋ง์ด ์๋ฃ๋ ๋๊น์ง ๊ธฐ๋ค๋ฆฌ์ง ์๊ณ ๋ฐ๋ก ํด๋ฆญํ ์ ์๋ค
- ํธ๋์ง์ ์ ์์น์๋ fallback์ ๋ฐฉ์งํ์ฌ ์ฌ์ฉ์๊ฐ ๋ค๋น๊ฒ์ด์ ์ ๊ฐ์๊ธฐ ์ด๋ํ๋ ๊ฒ์ ๋ฐฉ์งํ ์ ์๋ค
function navigate(url) {
startTransition(() => {
setPage(url);
});
}Troubleshooting
Updating an input in a transition doesnโt work
input์ ์ ์ดํ๋ state ๋ณ์์๋ ํธ๋์ง์ ์ ์ฌ์ฉํ ์ ์๋๋ฐ, ํธ๋์ง์ ์ ๋ ผ๋ธ๋กํน์ด์ง๋ง, ๋ณ๊ฒฝ ์ด๋ฒคํธ์ ๋ํ ์๋ต์ผ๋ก input์ ์ ๋ฐ์ดํธํ๋ ๊ฒ์ ๋๊ธฐ์ ์ผ๋ก ์ด๋ฃจ์ด์ ธ์ผํ๊ธฐ ๋๋ฌธ์ด๋ค.
function handleChange(e) {
// โ Can't use transitions for controlled input state
startTransition(() => {
setText(e.target.value);
});
}ํธ๋์ง์ ์ ์ฌ์ฉํ๊ณ ์ถ์ผ๋ฉด ๋ค์ ๋๊ฐ์ง ๋ฐฉ๋ฒ์ด ์๋ค
- input state์ ํธ๋์ง์ ์คํ์ ์ ๋ฐ์ดํธํ state ๋ณ์๋ฅผ ๊ฐ๊ฐ ์ ์ธํ ์ ์๋ค.
useDeferredValue๋ฅผ ์ฌ์ฉํ ์ ์๋ค.
startTransition์ ์ ๋ฌ๋๋ ํจ์๋ ๋๊ธฐ์ ์ด์ด์ผํ๋ค.
๋ค์์ ์๋์ง๋ง
startTransition(() => {
// โ Setting state *after* startTransition call
setTimeout(() => {
setPage('/about');
}, 1000);
});๋ค์์ ๋๋ค
setTimeout(() => {
startTransition(() => {
// โ
Setting state *during* startTransition call
setPage('/about');
});
}, 1000);