0Pricing
TypeScript Academy · 강의

useState 및 useReducer 형식 지정

React 상태 훅에 형식 매개변수를 추가합니다.

useState 및 useReducer 형식 지정은(는) CoddyKit의 무료 TypeScript Academy 강의입니다. 이것은 4개 중 2번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 TypeScript Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. TypeScript Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

환영합니다

이 단원에서는 React와 함께 TypeScript로 useState와 useReducer의 형식을 지정하는 방법을 다룹니다.

컴포넌트 속성 인터페이스

React 컴포넌트의 속성 인터페이스를 정의하여 컴포넌트 사용 규약을 문서화하고 준수하도록 합니다.
interface ButtonProps {
  label: string;
  onClick: () => void;
  disabled?: boolean;
}

function Button({ label, onClick, disabled }: ButtonProps) {
  return <button onClick={onClick} disabled={disabled}>{label}</button>;
}

FC와 명시적 반환 형식

React.FC는 자식 요소와 기타 형식을 자동으로 추가합니다. 명시적 반환 형식(JSX.Element | null)이 더 명확한 경우가 많습니다.
const Card: React.FC<{title: string}> = ({ title }) => <div>{title}</div>;

// Or explicit:
function Card2({ title }: { title: string }): JSX.Element {
  return <div>{title}</div>;
}

useState 형식 지정

useState는 초기 값에서 형식을 추론합니다. 초기 값이 null이거나 모호할 때는 형식 매개변수를 제공하십시오.
const [count, setCount] = useState(0);           // number
const [name, setName] = useState('');            // string
const [user, setUser] = useState<User | null>(null); // explicit

useReducer 형식 지정

useReducer는 판별 가능한 유니온 동작 형식과 함께 사용할 때 가장 효과적입니다.
type Action = { type: 'increment' } | { type: 'decrement' } | { type: 'reset'; value: number };
function reducer(state: number, action: Action): number {
  switch (action.type) {
    case 'increment': return state + 1;
    case 'decrement': return state - 1;
    case 'reset': return action.value;
  }
}

DOM용 useRef 형식 지정

DOM 요소에 사용하는 useRef에는 형식 인수가 필요합니다. 요소가 아직 존재하지 않으므로 null로 초기화하십시오.
const inputRef = useRef<HTMLInputElement>(null);

// Use:
if (inputRef.current) {
  inputRef.current.focus();
}

이벤트 처리기 형식 지정

React 이벤트 형식에는 React.ChangeEvent, React.MouseEvent, React.FormEvent가 포함됩니다.
function handleChange(e: React.ChangeEvent<HTMLInputElement>) {
  console.log(e.target.value);
}
function handleClick(e: React.MouseEvent<HTMLButtonElement>) {
  e.preventDefault();
}

제네릭 컴포넌트

제네릭 컴포넌트는 유연하고 형식이 안전한 목록과 선택 상자를 위해 형식 매개변수를 받습니다.
function List<T extends { id: number }>({ items }: { items: T[] }) {
  return <ul>{items.map(i => <li key={i.id}>{JSON.stringify(i)}</li>)}</ul>;
}

TypeScript에서 forwardRef 사용

forwardRef에는 참조 요소 형식과 속성 형식 모두에 대한 형식 매개변수가 필요합니다.
const Input = React.forwardRef<HTMLInputElement, InputProps>(
  ({ label, ...props }, ref) => (
    <label>{label}<input {...props} ref={ref} /></label>
  )
);

사용자 정의 훅 반환 형식

튜플 반환값이 any[]로 추론되는 것을 방지하려면 사용자 정의 훅의 반환값 형식을 명시적으로 지정하십시오.
function useToggle(init: boolean): [boolean, () => void] {
  const [state, setState] = useState(init);
  return [state, () => setState(s => !s)];
}

TypeScript를 사용한 컨텍스트

undefined를 포함하는 유니온으로 React 컨텍스트의 형식을 지정하여 컨텍스트 사용자가 컨텍스트를 확인하도록 하십시오.
const AuthContext = React.createContext<User | undefined>(undefined);
function useAuth(): User {
  const ctx = useContext(AuthContext);
  if (!ctx) throw new Error('useAuth must be used within AuthProvider');
  return ctx;
}

빠른 확인

HTML 입력 요소를 가리키는 참조에 올바른 형식은 무엇입니까?

복습

인터페이스로 React 속성의 형식을 지정하고, 형식 매개변수와 함께 useState를 사용하며, React 이벤트 형식으로 이벤트를 지정하고, DOM 요소 제네릭으로 참조를 지정하고, 두 형식 매개변수와 함께 forwardRef를 사용하는 방법을 배웠습니다. 제네릭 컴포넌트를 사용하면 형식이 안전하고 재사용 가능한 UI를 만들 수 있습니다.

자주 묻는 질문

“useState 및 useReducer 형식 지정” 강의는 무료인가요?

네 — “useState 및 useReducer 형식 지정” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 TypeScript Academy 강의 전체를 잠금 해제할 수 있습니다. TypeScript Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

“useState 및 useReducer 형식 지정”에서 뭘 배우나요?

React 상태 훅에 형식 매개변수를 추가합니다. 브라우저에서 직접 실행하는 실습 코드로 TypeScript Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.

TypeScript Academy을(를) 시작하는 데 경험이 필요한가요?

사전 경험은 필요하지 않습니다. CoddyKit의 TypeScript Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 2번째 강의입니다.

“useState 및 useReducer 형식 지정” 강의는 얼마나 걸리나요?

대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.

이 TypeScript Academy 강의에서 코드를 작성하고 실행할 수 있나요?

네. 모든 TypeScript Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.

이 강의의 모든 강의

  1. React 컴포넌트 Props 형식 지정
  2. useState 및 useReducer 형식 지정
  3. useRef 및 이벤트 핸들러 형식 지정
  4. 제네릭 컴포넌트 및 forwardRef
← TypeScript Academy(으)로 돌아가기