React Hook Form의 Controller와 Register 함수: 활용 방법 및 비교

 

출처: https://www.react-hook-form.com/media/

살펴보기

React Hook Form은 간편하게 폼을 다룰 수 있는 라이브러리로, 폼 상태를 자동으로 관리하고 입력 요소를 간단하게 처리할 수 있게 도와줍니다. 이 라이브러리에서는 주로 사용되는 Controller 함수와 Register 함수에 대해 알아보겠습니다.

 

소개 및 기본 개념 설명

React Hook Form에서의 Controller와 Register 함수는 모두 폼 요소를 등록하고 폼 상태를 제어하는 데 사용됩니다. Controller 함수는 주로 외부 라이브러리와 통합할 때 유용하며, Register 함수는 직접적으로 폼 요소를 등록할 때 사용됩니다.

 

코드 작성 방법

Controller 함수

import { useForm, Controller } from 'react-hook-form';

const MyForm = () => {
  const { control, handleSubmit } = useForm();

  const onSubmit = (data) => {
    // 폼 제출 처리...
  };

  return (
    <form onSubmit={handleSubmit(onSubmit)}>
      {/* Controller 함수를 사용하여 입력 요소 등록 */}
      <Controller
        name="username"
        control={control}
        render={({ field }) => <input {...field} />}
      />

      {/* 나머지 폼 요소들... */}
    </form>
  );
};

 

Register 함수

import { useForm } from 'react-hook-form';

const MyForm = () => {
  const { register, handleSubmit } = useForm();

  const onSubmit = (data) => {
    // 폼 제출 처리...
  };

  return (
    <form onSubmit={handleSubmit(onSubmit)}>
      {/* Register 함수를 사용하여 입력 요소 직접 등록 */}
      <input {...register('username')} />

      {/* 나머지 폼 요소들... */}
    </form>
  );
};

 

두 함수의 차이 비교하기

편의성, 유연성, 성능 면에서의 비교

• Controller의 편의성:
  • 외부 라이브러리와의 연동이 간편하며, 컴포넌트 간의 상태를 쉽게 전달할 수 있습니다.
• Register의 편의성:
  • 직접적인 등록으로 렌더링 효율이 높습니다.
• 둘의 유연성:
  • Controller는 외부 라이브러리와의 통합에 유리하나, 사용자 정의 요소에 적용하기 어렵습니다.
  • Register는 직접적인 등록으로 자유도가 높으며, 사용자 정의 요소에 적용 가능합니다.
• 성능 면에서의 차이:
  • 큰 규모의 폼이나 동적인 상황에서 Controller는 렌더링 성능에 유리할 수 있습니다.
  • 작은 규모의 폼에서는 Register가 직접적으로 등록되어 렌더링 성능이 우수할 수 있습니다.

 

예제 코드

이제 간단한 예제를 통해 Controller와 Register 함수의 활용법을 자세히 살펴보겠습니다.

 

Controller 함수의 예제

// 커스텀 컴포넌트와의 연동
const UsernameInput = ({ field }) => (
  <div>
    <label>Username:</label>
    <input {...field} />
  </div>
);

const MyFormWithController = () => {
  const { control, handleSubmit } = useForm();

  const onSubmit = (data) => {
    // 폼 제출 처리...
  };

  return (
    <form onSubmit={handleSubmit(onSubmit)}>
      {/* Controller 함수를 사용하여 커스텀 컴포넌트 등록 */}
      <Controller
        name="username"
        control={control}
        render={({ field }) => <UsernameInput field={field} />}
      />

      {/* 나머지 폼 요소들... */}
    </form>
  );
};

 

Register 함수의 예제

const MyFormWithRegister = () => {
  const { register, handleSubmit } = useForm();

  const onSubmit = (data) => {
    // 폼 제출 처리...
  };

  return (
    <form onSubmit={handleSubmit(onSubmit)}>
      {/* Register 함수를 사용하여 직접적인 등록 */}
      <label>Username:</label>
      <input {...register('username')} />

      {/* 나머지 폼 요소들... */}
    </form>
  );
};

이런 예제들을 통해 Controller는 외부 컴포넌트와의 통합에, Register는 직접적인 등록에 적합하다는 것을 확인할 수 있습니다.

 

종합적인 비교 및 결론 도출

두 함수를 종합적으로 비교한 결과, 프로젝트의 특정 요구사항과 상황에 따라 적절한 함수를 선택해야 합니다.

• Controller:
  • 외부 라이브러리와의 연동이 필요한 경우
  • 커스텀 컴포넌트와의 상태 관리가 필요한 경우
• Register:
  • 직접적인 등록으로 렌더링 효율이 중요한 경우
  • 단순한 폼 상태 관리가 목적인 경우

 

사용자의 선택 가이드

프로젝트의 성격과 요구사항에 따라 사용자가 어떤 함수를 선택해야 하는지에 대한 간단한 가이드입니다.

• Controller 선택 시:
  • 외부 라이브러리와의 통합이 필요한 경우
  • 커스텀 컴포넌트와의 연동이 많은 경우
• Register 선택 시:
  • 직접적인 등록으로 렌더링 효율이 중요한 경우
  • 단순한 폼 상태 관리가 주요 목적인 경우

 

React Hook Form: Controller 함수 사용 권장

React Hook Form에서의 Controller 함수와 Register 함수 중에서 선택해야 할 때, 대부분의 상황에서는 Controller 함수를 사용하는 것이 권장됩니다. 여러 이유로 인해 Controller 함수가 프로젝트의 일관성, 확장성, 그리고 협업 측면에서 더 많은 이점을 제공하기 때문입니다.

 

1. 일관성과 코드 통일화
   • Controller 함수를 통일적으로 사용함으로써 프로젝트 내에서 코드 일관성을 유지할 수 있습니다. 개발자들이 동일한 방법으로 코드를 작성하면서 협업이 더 원활해집니다. 특히 프로젝트 내에서 외부 라이브러리와의 통합이 필요한 경우, Controller 함수는 일관된 패턴으로 코드를 작성할 수 있게 도와줍니다.
2. 외부 라이브러리와의 통합
   • Controller 함수는 외부 라이브러리와의 연동에 용이합니다. 외부 라이브러리를 자주 활용하는 프로젝트에서는 Controller 함수를 통해 간단하게 폼 상태를 관리하면서 외부 라이브러리와의 통합을 쉽게 할 수 있습니다.
3. 커스텀 컴포넌트와의 모듈화
   • Controller 함수를 사용하면 커스텀 컴포넌트와의 상태 관리가 용이해집니다. 커스텀 컴포넌트를 활용하는 상황에서는 Controller 함수를 통해 상태를 전달하고 관리하는 것이 코드의 모듈화와 재사용성을 높일 수 있습니다.
4. 프로젝트의 확장성
   • 프로젝트의 규모가 커지거나 더 복잡한 상태 관리가 필요한 경우, Controller 함수는 더 많은 확장성을 제공합니다. 폼이나 상태 관리가 더 복잡해질 경우, Controller 함수를 사용하는 것이 미래에 대비하는데 도움이 됩니다.

 

결론

일관성, 코드 통일화, 그리고 프로젝트의 확장성을 고려할 때, Controller 함수를 사용하여 React Hook Form을 구현하는 것이 좋습니다. 이는 팀 내에서 통일된 방식으로 코드를 작성하면서 협업을 강화하고, 미래의 프로젝트 확장에 대비하는 효과를 가져올 것입니다.

 

추천글

React Hook Form의 useWatch와 watch 함수, 제대로 알고 쓰자!

React Hook Form의 useWatch와 watch 함수, 제대로 알고 쓰자!