중급

폼과 입력 검증

Form, TextFormField, validator로 사용자 입력을 안전하게 받습니다.

개념 먼저 보기

폼과 입력 검증의 기본 개념부터 잡기

폼과 입력 검증 문서는 먼저 용어의 뜻을 잡고, 그 다음 Flutter 코드에서 어디에 쓰이는지 연결해서 읽는 것이 좋습니다.

아래 항목들은 이 문서에서 다루는 내용을 작은 단위로 나눈 것입니다. 각 항목을 읽은 뒤 예제를 보면 코드가 훨씬 덜 추상적으로 느껴집니다.

종류별로 하나씩

폼과 입력 검증에서 나눠 볼 핵심 요소

폼 구성

Form은 여러 입력 필드를 하나의 검증 단위로 묶습니다.

언제 쓰나: TextEditingController는 입력 값을 직접 제어할 때 사용합니다.

Flutter에서: GlobalKey<FormState>로 validate와 save를 호출할 수 있습니다.

// 폼과 입력 검증 예제입니다.
// 먼저 코드의 큰 흐름을 보고, 주석을 따라 각 줄의 역할을 확인하세요.
validator: (value) {
  if (value == null || value.isEmpty) {
    return '이름을 입력하세요';
  }
  return null;
}

검증 UX

오류 메시지는 사용자가 바로 수정할 수 있을 만큼 구체적이어야 합니다.

언제 쓰나: 필수값, 길이, 형식, 서버 중복 검사를 나누어 생각합니다.

Flutter에서: 입력 중 검증과 제출 시 검증의 균형을 맞춥니다.

// 폼과 입력 검증 예제입니다.
// 먼저 코드의 큰 흐름을 보고, 주석을 따라 각 줄의 역할을 확인하세요.
validator: (value) {
  if (value == null || value.isEmpty) {
    return '이름을 입력하세요';
  }
  return null;
}

부연 설명

폼 구성

Form은 여러 입력 필드를 하나의 검증 단위로 묶습니다.
TextEditingController는 입력 값을 직접 제어할 때 사용합니다.
GlobalKey<FormState>로 validate와 save를 호출할 수 있습니다.

부연 설명

검증 UX

오류 메시지는 사용자가 바로 수정할 수 있을 만큼 구체적이어야 합니다.
필수값, 길이, 형식, 서버 중복 검사를 나누어 생각합니다.
입력 중 검증과 제출 시 검증의 균형을 맞춥니다.

깊게 이해하기

폼과 입력 검증 문서는 Flutter 앱을 만들 때 반복해서 마주치는 개념을 독립적으로 정리한 페이지입니다. 먼저 용어의 의미를 잡고, 그 다음 실제 코드에서 어디에 배치되는지 연결해 보면 학습 속도가 빨라집니다.

이 주제는 단독으로 외우기보다 앞뒤 문서와 함께 보는 것이 좋습니다. 예를 들어 문법 주제는 위젯 코드에서 어떻게 드러나는지, 배포 주제는 실제 앱 운영 흐름에서 어떤 결정을 요구하는지 함께 확인하세요.

상세 예제

아래 예제는 이 문서의 핵심 개념을 실제 프로젝트에서 작은 단위로 적용하는 형태입니다.

validator: (value) {
  if (value == null || value.isEmpty) {
    return '이름을 입력하세요';
  }
  return null;
}

실무에서 주의할 점

처음에는 가장 단순한 구현으로 시작하고, 반복되는 시점에 구조를 정리하세요.
예제 코드를 그대로 외우기보다 입력, 출력, 책임을 나누어 읽어 보세요.
새 문서를 추가할 때는 같은 형식으로 요약, 핵심 설명, 예제, 체크리스트를 유지하세요.

실습 체크리스트

Form key 만들기validator 작성제출 버튼에서 validate 호출

validator

validator: (value) {
  if (value == null || value.isEmpty) {
    return '이름을 입력하세요';
  }
  return null;
}