React UI Component Guide

컴포넌트별 Props 설계 가이드

Button부터 Modal, Table까지 자주 사용하는 React 컴포넌트의 Props를 역할별로 정리하고, 바로 참고할 수 있는 간단한 JSX 예제를 함께 제공합니다.

Props를 설계할 때 나누는 기준

컴포넌트를 만들기 전에 Props의 역할부터 구분하면 API가 단순해지고 유지보수가 쉬워집니다.

필수 Props없으면 컴포넌트가 성립하지 않는 값
상태 Propsvalue, checked, open처럼 현재 상태를 나타내는 값
이벤트 PropsonClick, onChange, onClose처럼 사용자 동작 처리
스타일 Propsvariant, size, className처럼 모양을 바꾸는 값
검색 결과가 없습니다.

거의 모든 컴포넌트에서 공통으로 고려할 Props

Prop설명필수
children컴포넌트 내부에 표시할 내용선택
className외부에서 CSS 클래스를 추가할 때 사용선택
style인라인 스타일 객체선택
idDOM 식별자와 label 연결 등에 사용선택
disabled사용자 입력과 클릭을 막는 비활성 상태선택
onFocus / onBlur포커스 진입 및 해제 이벤트선택
onKeyDown키보드 조작 이벤트선택
aria-*스크린리더 등 접근성 정보 제공선택
data-*테스트 식별자나 사용자 정의 데이터 저장선택

추천 학습 순서

1. Button2. Input3. Checkbox 4. Radio5. Select6. Textarea 7. Switch8. Badge / Tag9. Modal 10. Tooltip11. Accordion12. Tabs 13. Table14. Pagination