React z TypeScript: typy, których naprawdę potrzebujesz

React z TypeScript

React z TypeScript: propsy, stan, zdarzenia, refy, context | We.Inc

Ściąga z typami React w TypeScript z wyszukiwarką: propsy, children, useState, zdarzenia, refy, context, reducery i komponenty generyczne, każdy z kodem do skopiowania.

W React z TypeScript najczęściej typujesz propsy komponentu, a resztą zajmuje się inferencja. Opisz propsy interfejsem, użyj React.ReactNode dla children, przekaż argument typu do useState, gdy wartość początkowa jest zbyt wąska, i wybieraj typy zdarzeń, takie jak React.ChangeEvent<HTMLInputElement>, dla handlerów. Pliki z JSX mają rozszerzenie .tsx.

Najczęściej używane typy

  • Co typujesz
  • Typ
  • Wszystko, co można wyrenderować jako children
  • React.ReactNode
  • Dokładnie jeden element JSX
  • React.ReactElement
  • Handler zmiany w polu input
  • React.ChangeEvent<HTMLInputElement>
  • Handler kliknięcia przycisku
  • React.MouseEvent<HTMLButtonElement>
  • Handler wysłania formularza
  • React.FormEvent<HTMLFormElement>
  • Prop stylu inline
  • React.CSSProperties
  • Wszystkie propsy natywnego elementu
  • React.ComponentProps<"button">

Wyszukaj w ściądze to, co próbujesz otypować, na przykład handler kliknięcia albo ref, i skopiuj linijkę. Dalej znajdziesz dłuższe przykłady dla contextu, reducerów i komponentów generycznych.

  • Wpisz w pole wyszukiwania słowo, takie jak event, ref lub children.
  • Jeśli lista jest długa, zawęź ją według grupy.
  • Skopiuj fragment kodu obok pasującego wiersza.
  • Przeczytaj przykłady poniżej, aby poznać wzorce wymagające więcej niż jednej linijki.
  • Pozwól działać inferencji. useState(0) to już number; dodawaj argument typu tylko dla unii, wartości nullable lub pustych tablic.
  • Nie oznaczaj komponentów jako React.FC z przyzwyczajenia. Zwykła funkcja z otypowanymi propsami jest krótsza i jawnie obsługuje children.
  • Najedź w edytorze na atrybut, taki jak onChange, aby zobaczyć dokładny typ zdarzenia, którego oczekuje React, a potem skopiuj go do swojego handlera.
  • Zainstaluj @types/react i @types/react-dom jako zależności deweloperskie; frameworki takie jak Next.js dodają je za Ciebie.

Najczęściej zadawane pytania

Jak otypować children?

Dodaj children: React.ReactNode do interfejsu propsów. ReactNode obejmuje ciągi znaków, liczby, elementy, tablice i null. Używaj React.ReactElement tylko wtedy, gdy komponent musi otrzymać pojedynczy element JSX.

Dlaczego moja wartość useState ma typ never[]?

Pusta tablica nie daje kompilatorowi niczego do wywnioskowania. Przekaż typ elementu: useState<string[]>([]). To samo dotyczy wartości początkowych null, jak w useState<User | null>(null).

Jak otypować ref do elementu DOM?

Wywołaj useRef<HTMLInputElement>(null) i podepnij go przez ref={inputRef}. Odczytuj inputRef.current ze sprawdzeniem null, bo ma wartość null, dopóki React nie zamontuje elementu, i ponownie po jego odmontowaniu.

Jak przekazać ref do własnego komponentu?

Aktualna dokumentacja React pokazuje komponent funkcyjny, który otrzymuje ref jako zwykły prop i umieszcza go na wewnętrznym elemencie. Otypuj ten prop jako React.Ref<HTMLInputElement>. Starszy kod zamiast tego opakowuje komponent w forwardRef.

Jaką wartość domyślną powinien mieć createContext?

Gdy nie ma sensownej wartości domyślnej, użyj createContext<Value | null>(null) i opakuj useContext w mały hook, który rzuca błąd, jeśli wartość to null. Każdy konsument dostaje wtedy typ bez null i czytelny błąd, gdy brakuje providera.

Najpierw propsy, reszta przyjdzie sama

  • Większość błędów typów w kodzie React zaczyna się na granicy komponentu. Napisz interfejs dla propsów, zdestrukturyzuj je w sygnaturze, a kompilator sprawdzi każde miejsce, w którym komponent jest używany.
  • Opcjonalne propsy dostają znak zapytania i zwykle wartość domyślną w destrukturyzacji, na przykład size = "md". Propsy będące unią, jak variant: "primary" | "ghost", dają autouzupełnianie i odrzucają literówki.

Zdarzenia i formularze

  • Każdy handler otrzymuje syntetyczne zdarzenie React otypowane według elementu, z którego pochodzi. Używaj event.currentTarget, aby odczytać element, do którego podpięty jest handler; jego typ pochodzi z argumentu generycznego.
  • Jeśli wolisz otypować cały handler, React eksportuje też typy handlerów, na przykład React.ChangeEventHandler<HTMLInputElement>.

Komponenty generyczne

  • Lista lub select działający z elementami dowolnego typu może przyjmować parametr typu. Dane wywołującego ustalają typ, a render props otrzymują poprawnie otypowane elementy bez rzutowań.

Przykłady krok po kroku

Komponent z otypowanymi propsami i children

Opcjonalne propsy dostają wartości domyślne w sygnaturze; children przyjmuje wszystko, co da się wyrenderować.

Context z bezpiecznym hookiem

Hook rzuca czytelny błąd poza providerem i zwraca wartość różną od null wewnątrz niego.

useReducer z unią rozróżnialną

W każdym case akcja jest zawężona, więc action.item istnieje tylko tam, gdzie powinien.

Generyczny komponent listy

T jest ustalany przez elementy przekazane przez wywołującego, więc renderItem otrzymuje właściwy typ.

Ustawianie fokusu na polu przez prop ref

Rodzic tworzy ref; dziecko umieszcza go na prawdziwym polu input.

Props

Obiekt propsów

Props

Children dowolnego rodzaju

Props

Tylko jeden element jako dziecko

Props

Wariant ograniczony do kilku wartości

Props

Przekazanie natywnych propsów przycisku

Props

Prop stylu

Props

Prop z callbackiem

State

Stan liczbowy (wywnioskowany)

State

Stan, który może być null

State

Stan z pustą tablicą

State

Unia statusów

State

Setter przekazany jako prop

Events

Zmiana w polu tekstowym

Events

Zmiana w polu select

Events

Kliknięcie przycisku

Events

Wysłanie formularza

Events

Naciśnięcie klawisza

Events

Typ całego handlera

Refs

Ref do elementu DOM

Refs

Ref przechowujący id timera

Refs

Ref otrzymany jako prop

Context

Context bez wartości domyślnej

Reducer

Unia akcji

Wszystkie

Propsy

Stan

Zdarzenia

Refy

Context

Reducer

Ściąga React TypeScript

Szukaj w ściądze

event, ref, children...

Filtruj według grupy

Kopiuj

Pokazano {n} z {v} wierszy

Brak pasujących wierszy. Spróbuj krótszego słowa.

Rozpocznij darmowy okres próbny · 7 dni za darmo, dziś $0

Powiązane: Poradniki

Produkt

Dla kogo

Funkcje

Zasoby

Firma

Mapa strony