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);

review