본문 바로가기

조건부 렌더링

if 문·삼항 연산자·논리곱·null 반환으로 state와 props에 따라 화면에 보여 줄 요소를 고릅니다.

로그인한 사람에게는 로그아웃 버튼을, 로그인하지 않은 사람에게는 로그인 버튼을 보여 줘야 합니다. 장바구니가 비어 있으면 상품 목록 대신 안내 문구가 나와야 합니다. 이렇게 조건에 따라 화면의 일부를 바꾸거나 숨기는 일을 조건부 렌더링(conditional rendering)이라고 합니다. React에는 이를 위한 전용 문법이 없고, 자바스크립트의 조건문과 연산자를 그대로 씁니다.

이 글을 읽고 나면 다음을 할 수 있습니다.

  • if 문, 삼항 연산자, &&로 조건에 따라 다른 JSX를 화면에 그립니다.
  • &&의 왼쪽에 숫자를 두었을 때 화면에 0이 찍히는 버그를 직접 만들어 보고 고칩니다.
  • 부모가 컴포넌트를 빼는 것과 컴포넌트가 null을 돌려주는 것을 구별합니다.

첫 번째 React 앱 만들기에서 만든 Vite 프로젝트를 그대로 씁니다. 2장의 state와 useState 훅 기초와 이벤트 처리에서 배운 useState와 onClick만 알면 됩니다. npm run dev로 개발 서버를 켜 두세요. 이 글부터 시작하는 3장은 조건부 렌더링, 리스트, 폼, 컴포넌트의 생명주기를 차례로 배우고, 마지막 글에서 이를 모아 할 일 목록 앱을 만듭니다.


if 문으로 보여 줄 JSX 고르기

컴포넌트는 자바스크립트 함수이므로, return에 이르기 전에 if 문으로 무엇을 그릴지 정할 수 있습니다. JSX는 값이라서 변수에 담을 수 있다는 점을 이용합니다. 로그인했는지에 따라 인사말과 버튼을 바꾸는 컴포넌트를 만들어 봅니다. src/components 폴더에 LoginControl.jsx 파일을 만듭니다.

src/components/LoginControl.jsx
import { useState } from 'react';

function GuestGreeting() {
  return <h2>로그인해 주세요.</h2>;
}

function UserGreeting({ userName }) {
  return <h2>환영합니다, {userName}님!</h2>;
}

export default function LoginControl() {
  const [isLoggedIn, setIsLoggedIn] = useState(false);

  let greeting;
  if (isLoggedIn) {
    greeting = <UserGreeting userName="김코딩" />;
  } else {
    greeting = <GuestGreeting />;
  }

  let button;
  if (isLoggedIn) {
    button = <button onClick={() => setIsLoggedIn(false)}>로그아웃</button>;
  } else {
    button = <button onClick={() => setIsLoggedIn(true)}>로그인</button>;
  }

  return (
    <div>
      {greeting}
      {button}
    </div>
  );
}

isLoggedIn이 false이면 greeting에는 GuestGreeting이, button에는 로그인 버튼이 담깁니다. return의 JSX는 두 변수를 중괄호에 넣어 그리기만 합니다. 이제 App.jsx에서 이 컴포넌트를 그립니다.

src/App.jsx
import LoginControl from './components/LoginControl';

export default function App() {
  return (
    <div>
      <h1>조건부 렌더링</h1>
      <LoginControl />
    </div>
  );
}

저장하면 "로그인해 주세요."와 "로그인" 버튼이 보입니다. 버튼을 누르면 "환영합니다, 김코딩님!"과 "로그아웃" 버튼으로 바뀌고, 다시 누르면 처음 화면으로 돌아옵니다. 버튼을 누르면 isLoggedIn이 바뀌고, React가 LoginControl 함수를 다시 실행하며, 이번에는 두 if 문이 다른 쪽을 고릅니다. 화면을 직접 고치는 코드는 어디에도 없습니다. state가 바뀌면 그 state로 다시 그린 결과가 화면이 됩니다.

if 문은 JSX의 중괄호 안에는 쓸 수 없습니다. 중괄호 안에는 값으로 계산되는 식(expression)만 올 수 있는데, if는 값을 만들지 않는 문(statement)이기 때문입니다. 그래서 if는 위 코드처럼 return 앞에서 씁니다.


삼항 연산자로 JSX 안에서 고르기

둘 가운데 하나를 고르는 짧은 분기마다 변수를 만들고 if와 else를 적으면 코드가 길어집니다. 삼항 연산자 조건 ? A : B는 조건이 참이면 A, 거짓이면 B가 되는 식입니다. 식이므로 JSX의 중괄호 안에 바로 쓸 수 있습니다.

버튼을 누를 때마다 메시지를 보였다 숨기는 컴포넌트를 만듭니다. src/components 폴더에 MessageChanger.jsx를 만듭니다. 2장에서 만든 같은 이름의 파일이 있다면 내용을 아래 코드로 바꿉니다.

src/components/MessageChanger.jsx
import { useState } from 'react';

export default function MessageChanger() {
  const [showMessage, setShowMessage] = useState(false);

  return (
    <div>
      {showMessage ? (
        <p>지금 메시지가 보입니다.</p>
      ) : (
        <p>메시지가 숨겨져 있습니다.</p>
      )}
      <button onClick={() => setShowMessage(!showMessage)}>
        {showMessage ? '메시지 숨기기' : '메시지 보기'}
      </button>
    </div>
  );
}

삼항 연산자를 두 번 썼습니다. 한 번은 두 <p> 가운데 하나를 고르고, 다른 한 번은 버튼에 적을 글자를 고릅니다. JSX가 여러 줄이면 위처럼 괄호로 감싸 줄을 나눕니다. App.jsx에 이 컴포넌트를 더합니다.

src/App.jsx
import LoginControl from './components/LoginControl';
import MessageChanger from './components/MessageChanger';

export default function App() {
  return (
    <div>
      <h1>조건부 렌더링</h1>
      <LoginControl />
      <MessageChanger />
    </div>
  );
}

처음에는 "메시지가 숨겨져 있습니다."와 "메시지 보기" 버튼이 보이고, 버튼을 누르면 "지금 메시지가 보입니다."와 "메시지 숨기기"로 바뀝니다. 앞 절의 LoginControl도 삼항 연산자로 쓸 수 있습니다. 다만 삼항 연산자 안에 삼항 연산자를 또 넣기 시작하면 읽기 어려워지므로, 그럴 때는 if 문과 변수로 되돌리거나 컴포넌트를 나눕니다.


&&로 조건이 참일 때만 보여 주기

보여 줄 것이 한쪽에만 있는 경우도 많습니다. 경고가 있을 때만 경고 문구를 띄우고, 없을 때는 아무것도 그리지 않는 경우입니다. 삼항 연산자로 조건 ? <p>경고</p> : null이라고 써도 되지만, 논리곱 연산자 &&를 쓰면 더 짧습니다.

자바스크립트에서 A && B는 A가 참으로 평가되면 B를, 그렇지 않으면 A를 결과로 냅니다. 그리고 React는 JSX 안의 false, null, undefined를 만나면 아무것도 그리지 않습니다. 그래서 조건 && <p>경고</p>는 조건이 true이면 <p>를 그리고, false이면 아무것도 그리지 않습니다. src/components 폴더에 AlertControl.jsx를 만듭니다.

src/components/AlertControl.jsx
import { useState } from 'react';

function WarningBanner() {
  return <p>경고: 저장하지 않은 변경이 있습니다.</p>;
}

export default function AlertControl() {
  const [showWarning, setShowWarning] = useState(true);
  const unreadCount = 0;

  return (
    <div>
      {showWarning && <WarningBanner />}
      <button onClick={() => setShowWarning(!showWarning)}>
        {showWarning ? '경고 숨기기' : '경고 보이기'}
      </button>
      {unreadCount && <p>읽지 않은 알림 {unreadCount}건</p>}
    </div>
  );
}

App.jsx에 import AlertControl from './components/AlertControl';을 더하고 <MessageChanger /> 아래에 <AlertControl />을 넣습니다. 경고 문구와 "경고 숨기기" 버튼이 보이고, 버튼을 누르면 문구가 사라지며 버튼의 글자가 "경고 보이기"로 바뀝니다.

이 컴포넌트에는 &&가 하나 더 있습니다. 읽지 않은 알림이 있을 때만 건수를 보여 주려는 줄입니다. 지금 unreadCount는 0입니다. 버튼 아래에는 무엇이 보일까요? 화면을 보기 전에 먼저 예상해 보세요.

결과 확인하기

버튼 아래에 숫자 0이 보입니다. 0 && <p>…</p>에서 왼쪽의 0은 거짓으로 평가되므로, 식의 결과는 false가 아니라 왼쪽 값인 0입니다. React는 false는 그리지 않지만 숫자는 그대로 그리므로 화면에 0이 찍힙니다. unreadCount를 3으로 바꾸면 "읽지 않은 알림 3건"이 제대로 보이기 때문에, 0건일 때만 드러나는 버그입니다.

&&가 언제나 true나 false를 내는 것이 아니라 왼쪽 값을 그대로 낼 수 있다는 점이 원인입니다. 그래서 &&의 왼쪽에는 숫자를 그대로 두지 않고 비교식을 둡니다. 그 줄을 다음과 같이 고칩니다.

src/components/AlertControl.jsx (알림 건수를 보여 주는 줄)
{unreadCount > 0 && <p>읽지 않은 알림 {unreadCount}건</p>}

unreadCount > 0은 false이므로 이제 아무것도 보이지 않습니다. unreadCount를 3으로 바꿔 문구가 나타나는 것도 확인한 뒤 다시 0으로 돌려놓습니다. 배열의 길이로 조건을 줄 때도 같은 이유로 items.length && …가 아니라 items.length > 0 && …라고 씁니다.


컴포넌트가 null을 돌려주기

지금까지는 부모인 AlertControl이 WarningBanner를 넣을지 말지를 정했습니다. 반대로 WarningBanner가 props를 보고 스스로 아무것도 그리지 않게 할 수도 있습니다. 컴포넌트가 null을 돌려주면 React는 그 컴포넌트 자리에 아무것도 그리지 않습니다. AlertControl.jsx에서 두 군데를 고칩니다. WarningBanner가 warn이라는 props를 받게 하고, AlertControl은 && 없이 언제나 WarningBanner를 그리면서 showWarning을 넘깁니다.

src/components/AlertControl.jsx (WarningBanner 함수)
function WarningBanner({ warn }) {
  if (!warn) {
    return null;
  }

  return <p>경고: 저장하지 않은 변경이 있습니다.</p>;
}
src/components/AlertControl.jsx (AlertControl의 JSX에서 WarningBanner를 쓰는 줄)
<WarningBanner warn={showWarning} />

화면의 동작은 앞 절과 같습니다. warn이 false이면 WarningBanner는 첫 if에서 null을 돌려주고 함수를 끝냅니다. 이렇게 조건에 맞지 않을 때 함수의 앞부분에서 일찍 돌려주는 방식을 조기 반환(early return)이라고 합니다.

두 방식은 화면에서는 같아 보이지만 React가 보는 트리는 다릅니다. showWarning && <WarningBanner />에서 조건이 거짓이면 WarningBanner는 트리에 없고, 함수도 호출되지 않습니다. <WarningBanner warn={false} />는 컴포넌트가 트리에 그대로 있고, 함수가 호출되어 null을 돌려줍니다. 지금은 차이가 드러나지 않지만, 컴포넌트가 state를 가지거나 컴포넌트 라이프사이클에서 배울 정리 작업을 가지면 이 차이가 결과를 바꿉니다. 보통은 부모에서 &&로 빼는 쪽이 부모의 JSX만 읽어도 무엇이 보이는지 알 수 있어 더 읽기 쉽습니다.


네 가지 방법 가운데 고르기

네 방법은 모두 같은 일을 하므로, 고르는 기준은 무엇이 가장 읽기 쉬운가입니다.

상황쓰는 방법이 글의 예
조건이 여러 단계이거나, 분기마다 그릴 JSX가 크다return 앞의 if 문LoginControl
참일 때와 거짓일 때 모두 보여 줄 것이 있고 짧다삼항 연산자MessageChanger
참일 때만 보여 주고, 거짓이면 비운다&&showWarning && <WarningBanner />
컴포넌트가 props를 보고 스스로 비운다null 반환if (!warn) return null;
조건식은 원하는 표시 결과에 맞춰 읽기 쉽게 고릅니다

CONDITIONAL OUTPUT

조건식은 원하는 표시 결과에 맞춰 읽기 쉽게 고릅니다

if·삼항식·논리곱은 JSX를 선택하는 문법이고 null은 비어 있는 반환 결과입니다. 순서대로 실행하는 네 단계가 아니며, 로그인과 경고 예에서 표시할 결과를 먼저 정합니다.

조건부 렌더링 선택렌더 조건에서 여러 단계를 검사해야 하면 if로, 아니면 원하는 결과 형태를 판단합니다. 결과 형태는 둘 중 하나→삼항식, 참일 때만→논리곱, 표시 없음→null입니다. 문법을 고르는 읽기 안내이며 반드시 실행하는 순서나 유일한 분류가 아닙니다. null은 if나 삼항식의 결과로도 반환할 수 있습니다.렌더 조건여러 단계검사?if조기 반환원하는표시 결과?예아니요둘 중 하나참일 때만표시 없음삼항식참 · 거짓 결과 선택&&참일 때 결과 포함null표시할 자식 없음
조건부 렌더링 선택 · 모바일렌더 조건에서 여러 단계를 검사해야 하면 if로, 아니면 원하는 결과 형태를 판단합니다. 결과 형태는 둘 중 하나→삼항식, 참일 때만→논리곱, 표시 없음→null입니다. 문법을 고르는 읽기 안내이며 반드시 실행하는 순서나 유일한 분류가 아닙니다. null은 if나 삼항식의 결과로도 반환할 수 있습니다.렌더 조건여러 단계검사?if조기 반환원하는표시 결과?예아니요삼항식둘 중 하나&&참일 때만null표시할 자식 없음

if / 삼항식 · 둘 중 하나

isLoggedIn: false → GuestGreeting
isLoggedIn: true → UserGreeting

LoginControl은 인사말과 버튼을 각각 if로 선택합니다. MessageChanger는 참·거짓 모두 p와 버튼 문구가 있어 삼항식이 간결합니다.

&& / null · 비어 있는 결과

showWarning && <WarningBanner />
if (!warn) return null;

첫 식은 부모가 배너를 포함할지 결정합니다. null 반환은 함수가 실행돼도 자식 화면을 비웁니다. 부모 트리에서 제거하는 것과 상태 보존이 다를 수 있습니다.

숫자 0 && JSX는 0을 표시합니다. 개수 조건은 count > 0처럼 불리언으로 만듭니다. 복잡한 중첩은 변수나 컴포넌트로 분리합니다.

위 그림은 이 표를 질문의 순서로 그린 것입니다. 조건을 여러 단계로 검사해야 하면 if를 쓰고, 그렇지 않으면 무엇을 보여 주고 싶은지에 따라 삼항식(삼항 연산자로 쓴 식), &&, null 가운데 하나를 고릅니다. 그림 아래의 칸은 이 글에서 만든 LoginControl, MessageChanger, WarningBanner가 각각 어느 방법을 썼는지를 다시 적은 것입니다. 이 순서는 문법을 고를 때 참고하는 기준이므로, 한 컴포넌트 안에서 여러 방법을 섞어 써도 됩니다.


더 깊이: 분기가 바뀌어도 state가 남는 경우

React가 state를 이어 줄지 정하는 기준은 JSX에 적은 분기가 아니라, 렌더 결과의 트리에서 컴포넌트가 놓인 위치와 그 타입입니다. 예를 들어 isFancy ? <Counter isFancy={true} /> : <Counter isFancy={false} />는 JSX에서는 서로 다른 두 줄이지만, 어느 쪽이든 부모의 같은 자리에 같은 Counter가 오므로 React는 같은 컴포넌트로 보고 state를 유지합니다. 반대로 같은 자리에 다른 타입이 오면, 예를 들어 Counter가 있던 자리에 p가 오면 React는 Counter와 그 아래 트리 전체의 state를 버립니다(React 문서의 state 보존과 초기화).

그래서 대화 상대를 바꿨는데 입력 중이던 메시지가 그대로 남는 것 같은 문제가 삼항 연산자에서 생기기 쉽습니다. 같은 자리에서 state를 새로 시작하게 하는 방법은 두 가지입니다. 하나는 {isPlayerA && <Counter person="Taylor" />}와 {!isPlayerA && <Counter person="Sarah" />}처럼 && 두 개로 나눠 서로 다른 자리에 렌더링하는 것이고, 다른 하나는 두 분기에 key="Taylor"와 key="Sarah"처럼 서로 다른 key를 주는 것입니다. key는 다음 글에서 목록과 함께 배웁니다.


정리

  • 조건부 렌더링은 자바스크립트의 조건문과 연산자로 합니다. state가 바뀌면 컴포넌트 함수가 다시 실행되어 다른 JSX를 고릅니다.
  • if 문은 JSX의 중괄호 안에 쓸 수 없으므로 return 앞에서 변수에 JSX를 담거나 일찍 반환할 때 씁니다.
  • 삼항 연산자는 둘 가운데 하나를 JSX 안에서 고를 때 씁니다.
  • &&는 참일 때만 보여 줄 때 씁니다. 왼쪽에 숫자 0이 오면 0이 화면에 찍히므로 count > 0처럼 비교식을 둡니다.
  • 컴포넌트가 null을 돌려주면 그 자리에 아무것도 그려지지 않습니다. 이때 컴포넌트는 트리에 남아 있으며, 부모가 &&로 뺀 경우와 다릅니다.
  • 조건부 렌더링의 문법은 React 문서의 조건부 렌더링에도 정리되어 있습니다.

연습 문제

1. 화면에 무엇이 찍힐까

다음 세 줄은 각각 화면에 무엇을 그릴까요? count는 숫자, name은 문자열입니다.

{count && <p>새 메시지</p>}       {/* count가 0일 때 */}
{count && <p>새 메시지</p>}       {/* count가 3일 때 */}
{name !== '' && <p>{name}님</p>}  {/* name이 빈 문자열일 때 */}
해설 보기

첫째 줄은 숫자 0을 그립니다. 0은 거짓으로 평가되므로 &&의 결과가 왼쪽 값 0이고, React는 숫자를 그대로 그립니다. 둘째 줄은 3이 참으로 평가되므로 결과가 오른쪽의 <p>이고, "새 메시지"가 보입니다. 숫자 3은 화면에 나오지 않습니다.

셋째 줄은 아무것도 그리지 않습니다. name !== ''이 false이고, React는 false를 그리지 않습니다. 왼쪽을 비교식으로 만들어 두면 결과가 언제나 true 아니면 false이므로, 첫째 줄과 같은 일이 생기지 않습니다.

2. 중괄호 안의 if 고치기

다음 컴포넌트는 저장하는 순간 문법 오류가 납니다. 이유를 설명하고, 같은 화면이 나오도록 두 가지 방법으로 고쳐 보세요.

export default function Cart({ itemCount }) {
  return (
    <div>
      <h2>장바구니</h2>
      {if (itemCount === 0) { <p>담은 상품이 없습니다.</p> }}
    </div>
  );
}
해설 보기

JSX의 중괄호 안에는 값으로 계산되는 식만 올 수 있는데, if는 문이라서 값이 되지 못합니다. 식인 &&로 바꾸면 한 줄로 고칠 수 있습니다.

export default function Cart({ itemCount }) {
  return (
    <div>
      <h2>장바구니</h2>
      {itemCount === 0 && <p>담은 상품이 없습니다.</p>}
    </div>
  );
}

if 문을 그대로 쓰고 싶다면 return 앞으로 옮겨 변수에 담습니다.

export default function Cart({ itemCount }) {
  let emptyMessage = null;
  if (itemCount === 0) {
    emptyMessage = <p>담은 상품이 없습니다.</p>;
  }

  return (
    <div>
      <h2>장바구니</h2>
      {emptyMessage}
    </div>
  );
}

App.jsx에서 <Cart itemCount={0} />과 <Cart itemCount={2} />를 그려, 앞의 것에만 문구가 보이는지 확인합니다. 왼쪽이 itemCount === 0이라는 비교식이므로 숫자가 화면에 찍히는 일도 없습니다.

3. 부모가 빼는 것과 자식이 비우는 것

본문의 마지막 AlertControl에서 WarningBanner 함수의 첫 줄에 console.log('WarningBanner 실행');을 넣었다고 합시다. "경고 숨기기"를 눌러 showWarning이 false가 될 때 이 로그가 찍힐까요? 그 줄을 {showWarning && <WarningBanner warn={true} />}로 바꾸면 어떻게 될까요?

해설 보기

마지막 코드인 <WarningBanner warn={showWarning} />에서는 로그가 찍힙니다. AlertControl이 다시 렌더링되면서 WarningBanner 함수도 호출되고, 함수는 로그를 찍은 뒤 warn을 검사해 null을 돌려줍니다. 화면에는 아무것도 없지만 컴포넌트는 트리에 있습니다.

&&로 바꾼 코드에서는 로그가 찍히지 않습니다. showWarning이 false이면 식의 결과가 false이고, React는 WarningBanner를 호출할 일이 없습니다. 컴포넌트가 트리에서 빠진 것입니다. 개발 모드에서는 React가 버그를 찾으려고 컴포넌트 함수를 한 번 더 실행하므로 로그가 두 줄씩 보일 수 있습니다. 여기서는 몇 줄인지가 아니라 찍히는지 아닌지를 봅니다.

4. 빈 목록 안내 문구 만들기

이 장의 마지막 글에서 만들 할 일 목록 앱은 할 일이 하나도 없을 때 안내 문구를 보여 줍니다. 그 부품을 미리 만들어 둡니다. src/components/EmptyMessage.jsx에 다음 조건을 만족하는 컴포넌트를 만들어 보세요.

  • 할 일의 개수를 count라는 props로 받습니다.
  • count가 0이면 "아직 할 일이 없습니다. 새 할 일을 추가해 보세요."라는 문단을 그립니다.
  • count가 1 이상이면 아무것도 그리지 않습니다. 숫자가 화면에 찍혀서도 안 됩니다.
해설 보기

컴포넌트가 스스로 비워야 하므로 null을 일찍 돌려줍니다.

src/components/EmptyMessage.jsx
export default function EmptyMessage({ count }) {
  if (count > 0) {
    return null;
  }

  return <p>아직 할 일이 없습니다. 새 할 일을 추가해 보세요.</p>;
}

App.jsx에서 다음과 같이 두 번 그려 확인합니다.

src/App.jsx
import EmptyMessage from './components/EmptyMessage';

export default function App() {
  return (
    <div>
      <h1>할 일 목록</h1>
      <EmptyMessage count={0} />
      <EmptyMessage count={2} />
    </div>
  );
}

안내 문구가 한 번만 보이면 성공입니다. count={0}인 쪽은 문구를 그리고, count={2}인 쪽은 null을 돌려줘 아무것도 그리지 않습니다. return count === 0 && <p>…</p>;처럼 한 줄로 써도 결과는 같습니다. 이 파일은 지우지 말고 그대로 둡니다.

다음 글 리스트와 키에서는 배열 데이터를 화면의 목록으로 그리는 방법과, React가 목록의 항목을 구별하는 key를 배웁니다.