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
- Biblioteki UI dla React
- React vs React Native
- Ściąga regex
- Jak usunąć adres URL z wyszukiwarki Google
- robots.txt Disallow all
- robots.txt dla botów AI
- SEO dla dekarzy
- Sales tax w sklepie internetowym
Produkt
Dla kogo
- Dla agencji
- Dla freelancerów
- Dla firm hostingowych
- Dla platform SaaS
- Dla startupów
- Usługi finansowe
- Rozwiązania dla ochrony zdrowia
Funkcje
Zasoby
- Blog
- Centrum pomocy
- Darmowe narzędzia dla firm
- Free UI Components
- Szablony
- Kolekcje szablonów
- Przykłady stron
- Poradniki
- Porównania
- Alternatywy
- Najlepsze
- Recenzje
- Przewodniki po cenach
- Zastosowania
- Słownik i poradniki
- Integracje
- Dla programistów
- Benchmark
- Windows App