0Pricing
React Academy · 강의

useFieldArray로 동적 필드 다루기

useFieldArray 훅을 사용해 동적 양식 필드를 추가하고 삭제하며 순서를 바꿉니다.

useFieldArray로 동적 필드 다루기은(는) CoddyKit의 무료 React Academy 강의입니다. 이것은 4개 중 4번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 React Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. React Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

환영합니다

이 레슨에서는 React Hook Form의 useFieldArray 훅을 사용하여 필드의 동적 목록을 포함하는 폼을 만듭니다. 항목을 추가하고 제거하며 순서를 변경하는 작업을 수행합니다.

useFieldArray란 무엇인가요?

useFieldArray는 React Hook Form 내부의 필드 배열을 관리합니다. 필드 목록을 조작할 수 있도록 append, prepend, remove, swap, move, insert 메서드를 제공합니다.
import { useFieldArray } from 'react-hook-form';

const { fields, append, remove } = useFieldArray({
  control,
  name: 'phoneNumbers',
});

설정: useForm의 control

useFieldArray에는 useForm에서 가져온 `control` 객체가 필요합니다. register 및 handleSubmit과 함께 구조 분해 할당으로 가져옵니다.
const { register, control, handleSubmit } = useForm({
  defaultValues: { phoneNumbers: [{ value: '' }] },
});

필드 렌더링

`fields`를 순회하여 각 항목을 렌더링합니다. React 키로 필드의 `id`를 사용하고 인덱스는 사용하지 않습니다. 배열 경로 구문으로 각 필드를 등록합니다.
return fields.map((field, index) => (
  <div key={field.id}>
    <input
      {...register(`phoneNumbers.${index}.value`)}
    />
    <button onClick={() => remove(index)}>Remove</button>
  </div>
));

새 필드 추가

기본값 객체와 함께 append()를 호출하여 목록 끝에 새 필드를 추가합니다. 폼이 해당 필드를 자동으로 등록합니다.
<button onClick={() => append({ value: '' })}>
  Add Phone Number
</button>

필드 제거

특정 위치의 필드를 삭제하려면 remove(index)를 호출합니다. 이후의 모든 필드는 한 칸씩 앞으로 이동하고 등록 정보도 자동으로 업데이트됩니다.
<button onClick={() => remove(index)}>Delete</button>

최소 필드 검증

Zod 스키마에서 .min()으로 배열의 길이를 검증하여 필드가 하나 이상 존재하도록 할 수 있습니다.
const schema = z.object({
  emails: z.array(z.object({ value: z.string().email() }))
           .min(1, 'At least one email required'),
});

필드 교환 및 이동

두 필드를 서로 바꾸려면 `swap(indexA, indexB)`를 사용하고, 필드의 위치를 변경하려면 `move(from, to)`를 사용합니다. 이러한 기능은 끌어서 놓기로 정렬할 수 있는 필드 목록을 만드는 데 사용됩니다.
swap(0, 2); // swap first and third items
move(3, 0); // move item at index 3 to the top

중첩된 useFieldArray

다단계 동적 폼을 만들기 위해 하나의 useFieldArray 안에 다른 useFieldArray를 중첩할 수 있습니다. 예를 들어 각 항목에 하위 항목이 있는 송장을 만들 수 있습니다.

배열 데이터 제출

제출할 때 handleSubmit은 전체 배열을 데이터 객체의 일부로 전달합니다. 필드 구조와 일치하는 객체 배열인 data.phoneNumbers에서 해당 배열에 접근할 수 있습니다.
const onSubmit = (data) => {
  console.log(data.phoneNumbers);
  // [{ value: '555-1234' }, { value: '555-5678' }]
};

간단한 확인

useFieldArray 필드를 렌더링할 때 배열 인덱스가 아닌 field.id를 React 키로 사용해야 하는 이유는 무엇인가요?

복습

useFieldArray는 fields 배열과 append/remove/swap/move 메서드를 제공합니다. React 키로 field.id를 사용하고, 'fieldName.index.subfield' 구문으로 필드를 등록하며, Zod의 min/max로 배열을 검증합니다.

과정 완료

축하합니다! **React Hook Form으로 폼 관리하기**를 완료하셨습니다. 이제 RHF로 성능이 뛰어난 폼을 만들고, Zod 스키마 검증을 적용하며, 동적 필드 배열을 만들 수 있습니다.

자주 묻는 질문

“useFieldArray로 동적 필드 다루기” 강의는 무료인가요?

네 — “useFieldArray로 동적 필드 다루기” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 React Academy 강의 전체를 잠금 해제할 수 있습니다. React Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

“useFieldArray로 동적 필드 다루기”에서 뭘 배우나요?

useFieldArray 훅을 사용해 동적 양식 필드를 추가하고 삭제하며 순서를 바꿉니다. 브라우저에서 직접 실행하는 실습 코드로 React Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.

React Academy을(를) 시작하는 데 경험이 필요한가요?

사전 경험은 필요하지 않습니다. CoddyKit의 React Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 4번째 강의입니다.

“useFieldArray로 동적 필드 다루기” 강의는 얼마나 걸리나요?

대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.

이 React Academy 강의에서 코드를 작성하고 실행할 수 있나요?

네. 모든 React Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.

이 강의의 모든 강의

  1. React Hook Form 시작하기
  2. 유효성 검사 규칙과 오류 메시지
  3. Zod로 스키마 유효성 검사하기
  4. useFieldArray로 동적 필드 다루기
← React Academy(으)로 돌아가기