Conv.docs

React 및 TypeScript 일반 규칙

코드 품질 원칙

  • 명확하고 가독성 높은 React와 TypeScript 코드 작성
  • 최신 버전의 React, TypeScript, 및 핵심 라이브러리 활용
  • 정확하고 사실적인 코드 설계로 버그 최소화
  • 요청된 기능을 완전하게 구현 (필요한 모든 코드 작성)

React 컴포넌트 설계

  • 컴포넌트를 작고 재사용 가능한 단위로 분리
  • 단일 책임 원칙(SRP) 준수
  • 상태 관리는 필요한 가장 낮은 레벨에서 수행
// 좋은 컴포넌트 예시
const UserProfile = ({ user }) => {
  return (
    <div className="profile">
      <Avatar user={user} />
      <UserInfo user={user} />
      <UserActions userId={user.id} />
    </div>
  );
};

함수형 컴포넌트 및 훅 사용

  • 클래스 컴포넌트보다 함수형 컴포넌트 선호
  • 상태 로직 재사용을 위한 커스텀 훅 작성
  • 훅 규칙 준수 (최상위에서만 호출, React 함수 내에서만 호출)
// 커스텀 훅 예시
function useUserData(userId) {
  const [user, setUser] = useState(null);
  const [loading, setLoading] = useState(true);
  const [error, setError] = useState(null);

  useEffect(() => {
    // 사용자 데이터 로딩 로직
  }, [userId]);

  return { user, loading, error };
}

타입 안전성

  • Props와 상태에 명시적 타입 지정
  • 타입 추론 활용하되, 필요시 명시적 타입 제공
  • any 타입 사용 지양, 명확한 타입 정의
interface ButtonProps {
  label: string;
  onClick: () => void;
  disabled?: boolean;
  variant?: 'primary' | 'secondary' | 'outline';
}

const Button: React.FC<ButtonProps> = ({
  label,
  onClick,
  disabled = false,
  variant = 'primary'
}) => {
  // 구현
};

폼 및 사용자 입력 처리

  • 제어 컴포넌트 방식 선호
  • 폼 유효성 검사를 위한 라이브러리 활용 (react-hook-form 등)
  • 사용자 친화적인 에러 메시지 제공

성능 최적화

  • 불필요한 리렌더링 방지 (React.memo, useMemo, useCallback)
  • 지연 로딩 및 코드 분할 적용
  • 효율적인 데이터 구조 및 알고리즘 사용

접근성 (A11y)

  • 시맨틱 HTML 요소 사용
  • aria 속성 적절히 활용
  • 키보드 네비게이션 지원
  • 색상 대비 고려

관련 규칙

React 및 TypeScript 개발 시 다음 규칙들을 함께 참조하세요:

  • 디렉토리 구조: 디렉토리 구조 규칙 - 컴포넌트 및 파일 구조
  • 성능 최적화: 성능 최적화 규칙 - React 성능 향상 기법
  • TypeScript 활용: TypeScript 활용 규칙 - TypeScript 타입 시스템 활용
  • 코딩 스타일: 코딩 컨벤션 규칙 - 일관된 코딩 패턴
  • 네이밍 패턴: 네이밍 컨벤션 규칙 - 컴포넌트 및 함수 네이밍