Component
FormStack
여러 필드의 간격과 반응형 열 배치를 담당합니다.
Playground
옵션을 조절하며 화면과 사용 코드를 함께 확인하세요.
PC 1280px
Controls
Code
Props
@amineslab/ui에서 FormStack를 가져옵니다.
FormStack
필드 간격과 반응형 열 배치를 적용합니다.
Managed fields
기본 입력부터 날짜·시간 필드까지 같은 id·ARIA·변경 콜백 계약을 사용하는 어댑터입니다.
@amineslab/ui/forms/react-hook-form (optional)
React Hook Form을 사용하는 앱에서 같은 managed field를 Controller 규칙으로 연결합니다.
Examples
자주 쓰는 조합을 살펴보고, 필요한 예시의 코드를 펼쳐 확인하세요.
관리 필드와 날짜 계약
Text·Password·Number·Phone·Checkbox·Radio·Select·Combobox와 Date·Time·DateRange 필드가 같은 접근성 관계와 반응형 날짜 표면을 공유합니다.
자동으로 생성된 id와 설명 관계를 확인할 수 있습니다.
체크박스도 필드 설명과 필수 마커를 공유합니다.
RHF compound 구조 (optional)
React Hook Form을 사용하는 앱은 optional subpath의 Form compound와 field adapters를 사용해 같은 오류·설명·반응형 날짜 계약을 유지합니다.
사용 기준
권장하는 사용
- FormStack의 자식은 자유롭게 구성합니다.
- TextField·TextareaField처럼 라벨과 설명을 포함한 필드는 바로 넣으세요.
- Input·Textarea를 직접 쓰며 라벨·설명·오류를 묶고 싶을 때만 FormField를 사용합니다.
- FormActions로 저장·취소를 붙일 수 있습니다.
- 페이지 전체에 PC 카드와 모바일 하단 액션이 필요할 때 FormSurface로 감쌉니다.
- 값과 검증 상태는 native form 또는 폼 라이브러리가 관리합니다.
피해야 할 사용
- 겉모양만으로 사용을 결정하지 마세요.
- 의미와 키보드 동작, 모바일에서의 흐름을 함께 확인하세요.
접근성
화면에 맞는 이름을 제공하고, 키보드만으로 작업을 마칠 수 있는지 확인하세요.
Tab: 라벨이 연결한 실제 컨트롤로 이동합니다.