React
v16.2.0GitHub

리스트와 키

자바스크립트의 리스트를 어떻게 변환하는 지 살펴봅시다.

아래 코드에서 map() 함수를 사용해서 numbers 배열을 얻은 뒤 그 값을 두배로 만들려고 합니다. map() 이 반황하는 새 배열을 doubled 변수에 할당하고 로그를 남겨봅니다.

const numbers = [1, 2, 3, 4, 5];
const doubled = numbers.map((number) => number * 2);
console.log(doubled);

콘솔에는 [2,4,6,8,10] 이라고 찍힐 겁니다.

React에서 배열을 요소 리스트로 변환하는 건 거의 동일합니다.

다수 컴포넌트 렌더링

요소 컬렉션을 만들고 중괄호 {} 를 사용하여 JSX에 포함 시키는 것이 가능합니다.

아래 예제에서는 자바스크립트 map() 함수를 사용해서 numbers 배열을 순회합니다. 그리고 개별 아이템에 <li> 요소를 반환합니다. 마지막으로, 요소 배열 결과를 listItems 에 할당합니다.

const numbers = [1, 2, 3, 4, 5];
const listItems = numbers.map((number) =>
  <li>{number}</li>
);

전체 listItems 배열을 <ul> 요소 안에 삽입한 뒤 DOM에서 렌더링 합니다.

ReactDOM.render(
  <ul>{listItems}</ul>,
  document.getElementById('root')
);

Try it on CodePen.

이 코드는 1부터 5까지의 숫자로 이루어진 리스트입니다.

기본 리스트 컴포넌트

보통 리스트를 컴포넌트 안에서 렌더링합니다.

이전 예제를 numbers 배열을 받아서 순서없는 목록을 출력하는 컴포넌트로 리팩토링할 수 있습니다.

function NumberList(props) {
  const numbers = props.numbers;
  const listItems = numbers.map((number) =>
    <li>{number}</li>
  );
  return (
    <ul>{listItems}</ul>
  );
}

const numbers = [1, 2, 3, 4, 5];
ReactDOM.render(
  <NumberList numbers={numbers} />,
  document.getElementById('root')
);

이 코드를 실행하면, 리스트 아이템에 키를 넣어야한다는 경고가 표시됩니다. “키(key)“는 요소 리스트를 만들 때 포함해야하는 특수한 문자열 속성입니다. 다음 섹션에서 이 중요성에 대해 더 살펴봅니다.

numbers.map() 안의 리스트 아이템들에 key 를 할당하여 키 이슈를 해결해봅시다.

function NumberList(props) {
  const numbers = props.numbers;
  const listItems = numbers.map((number) =>
    <li key={number.toString()}>
      {number}
    </li>
  );
  return (
    <ul>{listItems}</ul>
  );
}

const numbers = [1, 2, 3, 4, 5];
ReactDOM.render(
  <NumberList numbers={numbers} />,
  document.getElementById('root')
);

Try it on CodePen.

키

키는 React가 어떤 아이템이 바뀌었는 지, 혹은 추가되었는 지, 혹은 삭제되었는 지를 인식하는 데 도움을 줍니다.요소에 안정적인 ID를 제공하려면 배열 내부 요소에 키를 주어야합니다.

const numbers = [1, 2, 3, 4, 5];
const listItems = numbers.map((number) =>
  <li key={number.toString()}>
    {number}
  </li>
);

키를 선택하는 가장 좋은 방법은 리스트 아이템의 형제 중 리스트 아이템을 고유하게 식별할 수 있는 문자열을 사용하는 것입니다. 대부분의 경우 데이터의 ID를 키로 사용합니다.

const todoItems = todos.map((todo) =>
  <li key={todo.id}>
    {todo.text}
  </li>
);

만약 렌더링된 아이템에서 사용할 안정적인 ID가 없다면, 아이템 인덱스를 키로 넣어 추후에 다시 정렬할 수도 있습니다.

const todoItems = todos.map((todo, index) =>
  // Only do this if items have no stable IDs
  <li key={index}>
    {todo.text}
  </li>
);

아이템의 순서가 바뀔 수 있는 경우 키에 인덱스를 사용하지 않는 게 좋습니다. 이로 인해 성능이 저하되거나 컴포넌트의 state에 따른 문제가 발생할 수 있습니다. Robin Pokorny가 작성한 아티클인 in-depth explanation on the negative impacts of using an index as a key 를 참고하시길 바랍니다. 만약 리스트 아이템에 명시적으로 키를 지정하지 않으면 React는 기본적으로 인덱스를 키로써 사용합니다.

더 자세히 알고 싶다면 왜 키가 필요한가에 대한 더 깊은 설명 도 있습니다.

키로 컴포넌트 추출하기

키는 주변 배열의 컨텍스트에서만 의미가 있습니다.

예를 들어, ListItem 컴포넌트를 추출 한 경우, ListItem 자체의 루트 <li> 요소가 아닌 배열의 <ListItem /> 요소가 키를 가지고 있어야합니다.

예제: 잘못된 키 사용법

function ListItem(props) {
  const value = props.value;
  return (
    // Wrong! There is no need to specify the key here:
    <li key={value.toString()}>
      {value}
    </li>
  );
}

function NumberList(props) {
  const numbers = props.numbers;
  const listItems = numbers.map((number) =>
    // Wrong! The key should have been specified here:
    <ListItem value={number} />
  );
  return (
    <ul>
      {listItems}
    </ul>
  );
}

const numbers = [1, 2, 3, 4, 5];
ReactDOM.render(
  <NumberList numbers={numbers} />,
  document.getElementById('root')
);

예제: 올바른 키 사용법

function ListItem(props) {
  // Correct! There is no need to specify the key here:
  return <li>{props.value}</li>;
}

function NumberList(props) {
  const numbers = props.numbers;
  const listItems = numbers.map((number) =>
    // Correct! Key should be specified inside the array.
    <ListItem key={number.toString()}
              value={number} />
  );
  return (
    <ul>
      {listItems}
    </ul>
  );
}

const numbers = [1, 2, 3, 4, 5];
ReactDOM.render(
  <NumberList numbers={numbers} />,
  document.getElementById('root')
);

Try it on CodePen.

좋은 규칙은 map() 내부의 요소에는 키가 필요하다는 것입니다.

키는 형제 중에서 고유한 값이어야한다.

배열 내에서 사용하는 키는 형제간에 고유해야합니다. 그러나 글로벌로 유니크할 필요는 없습니다. 두 다른 배열을 생성할 때 동일한 키를 사용할 수 있습니다.

function Blog(props) {
  const sidebar = (
    <ul>
      {props.posts.map((post) =>
        <li key={post.id}>
          {post.title}
        </li>
      )}
    </ul>
  );
  const content = props.posts.map((post) =>
    <div key={post.id}>
      <h3>{post.title}</h3>
      <p>{post.content}</p>
    </div>
  );
  return (
    <div>
      {sidebar}
      <hr />
      {content}
    </div>
  );
}

const posts = [
  {id: 1, title: 'Hello World', content: 'Welcome to learning React!'},
  {id: 2, title: 'Installation', content: 'You can install React from npm.'}
];
ReactDOM.render(
  <Blog posts={posts} />,
  document.getElementById('root')
);

Try it on CodePen.

키는 React에게 힌트를 제공하지만 컴포넌트로 전달되지는 않습니다. 만약 컴포넌트에 동일한 값이 필요하다면 명시적으로 다른 이름의 prop으로 전달하길 바랍니다.

const content = posts.map((post) =>
  <Post
    key={post.id}
    id={post.id}
    title={post.title} />
);

위 예제에서 Post 컴포넌트는 props.id 를 읽을 수 있지만, props.key 는 읽을 수 없습니다.

JSX에서 map() 포함하기

위 예제에서 별도의 listItems 변수를 선언하고 이를 JSX에 포함시켰습니다.

function NumberList(props) {
  const numbers = props.numbers;
  const listItems = numbers.map((number) =>
    <ListItem key={number.toString()}
              value={number} />
  );
  return (
    <ul>
      {listItems}
    </ul>
  );
}

JSX는 중괄호를 이용하면 모든 표현식을 포함 할 수 있기 때문에 map() 도 인라인으로 포함시킬 수 있습니다.

function NumberList(props) {
  const numbers = props.numbers;
  return (
    <ul>
      {numbers.map((number) =>
        <ListItem key={number.toString()}
                  value={number} />
      )}
    </ul>
  );
}

Try it on CodePen.

때로는 코드가 더 명확해질 수도 있지만 이 스타일도 악용될 수 있습니다. 자바스크립트와 마찬가지로 가독성을 위해 변수로 추출해야할 지에 대한건 개발자가 판단해야합니다. map() 바디가 너무 중첩되어있다면, 컴포넌트로 추출 하는 것이 좋습니다.

Edit this page