Podstawowe informacje
These docs are old and won’t be updated. Go to react.dev for the new React docs.
The new Quick Start teaches modern React and includes live examples.
Ta podstrona to przegląd dokumentacji Reacta oraz powiązanych zasobów.
React to javascriptowa biblioteka służąca do budowania interfejsów użytkownika. Dowiedz się, czym tak naprawdę jest React, na naszej stronie głównej lub w tutorialu.
Wypróbuj Reacta
Biblioteka React została zaprojektowana z myślą o stopniowym wdrażaniu. Dzięki temu zawarte w niej rozwiązania możesz stosować wybiórczo w zależności od potrzeb. Linki zawarte w tej części przewodnika wprowadzą cię do Reacta. Znajdziesz tu materiały, które pozwolą ci nie tylko dodawać elementy interaktywne do prostych stron HTML, lecz także rozpocząć prace nad bardziej zaawansowanymi aplikacjami bazującymi na Reakcie.
Środowisko doświadczalne
Jeśli chcesz wypróbować Reacta, możesz w tym celu użyć środowisk doświadczalnych online. Wypróbuj szablon “Hello World” na CodePen, CodeSandbox lub Stackblitz
Jeśli wolisz używać swojego własnego edytora tekstu, możesz także ściągnąć ten plik HTML, edytować go, a następnie otworzyć lokalnie w swojej przeglądarce. Pamiętaj jednak, że wykonuje on podczas uruchomienia dość mozolną transformację kodu, więc zalecamy go jedynie do prostych przykładów.
Dodaj Reacta do swojej strony
Możesz dodać Reacta do swojej strony HTML w ciągu minuty. Możesz stopniowo zwiększać jego obecność według potrzeb lub użyć go jedynie do kilku dynamicznych widgetów.
Stwórz nową aplikację reactową
Gdy zaczynasz projekt w Reakcie, najlepiej zacząć od napisania prostej strony w HTML-u przy użyciu tagów <script>. Zajmie ci to tylko minutę!
W miarę jak będziesz rozwijać swoją aplikację, możesz zacząć myśleć o bardziej zintegrowanym środowisku. Istnieje kilka JavaScriptowych narzędzi, które polecamy do rozwoju większych aplikacji. Każde z nich, przy drobnej lub znikomej konfiguracji, pozwoli ci korzystać z pełni mocy systemu Reacta. Kliknij tutaj, aby dowiedzieć się, jak to zrobić.
Ucz się Reacta
Ludzie rozpoczynający przygodę z Reactem wywodzą się z najróżniejszych środowisk, mają też różne sposoby uczenia się. Mamy nadzieję, że ta część przewodnika okaże się pomocna zarówno dla osób o zacięciu teoretycznym jak i dla tych którzy mają podejście bardziej praktyczne.
- Jeśli wolisz naukę przez praktykę, zacznij od naszego przewodnika praktycznego.
- Jeśli zaś bardziej zależy ci na systematycznym opanowaniu podstawowych zagadnień, zacznij swoją przygodę od przewodnika po głównych zagadnieniach.
Jak każda nowa technologia, z którą spotykasz się po raz pierwszy, React także ma swoją krzywą uczenia się. Jednak przy odrobinie praktyki i cierpliwości zrozumiesz, na czym polega.
Podstawowe przykłady
Strona główna Reacta zawiera kilka małych przykładów z edytorem kodu live. Nawet jeśli nie wiesz jeszcze nic o Reakcie, spróbuj zmienić kod i zobaczyć, jak wpłynie to na wynik działania aplikacji.
React dla początkujących
Jeśli wydaje ci się, że dokumentacja Reacta prowadzi cię w zbyt szybkim tempie, sprawdź ten przegląd Reacta napisany przez Tanię Rascię. Wprowadzi cię on szczegółowo w najistotniejsze zagadnienia Reacta, zachowując styl zrozumiały dla początkujących. Gdy już skończysz, spróbuj ponownie przeczytać naszą dokumentację!
React dla designerów
Jeśli zaczynając z Reactem przychodzisz ze środowiska grafików i designerów, te źródła mogą okazać się świetnym punktem startowym.
Źródła JavaScriptowe
Dokumentacja Reacta zakłada znajomość języka programowania JavaScript na pewnym poziomie. Nie musisz być ekspertem, jednakże nauka zarówno Reacta jak i JavaScriptu w tym samym czasie może być nieco trudniejsza.
Proponujemy zapoznanie się z przeglądem informacji o JavaScripcie, by sprawdzić swoją wiedzę. Powinno ci to zająć około 30 minut do godziny, a sprawi, że nauka Reacta będzie bardziej komfortowa.
Podpowiedź
Gdy tylko poczujesz, że pojęcia z języka JavaScript są zbyt zagmatwane, MDN oraz javascript.info mogą okazać się świetnymi źródłami do nauki. Istnieją także fora internetowe, na których możesz poprosić o pomoc.
Praktyczne samouczki
Jeśli preferujesz naukę przez praktykę, sprawdź nasze praktyczne samouczki. W tym rozdziale, za pomocą Reacta, stworzymy od podstaw grę w kółko i krzyżyk. Jeśli nie zajmujesz się tworzeniem gier i kusi cię, by go pominąć — najpierw daj mu szansę. Techniki, których nauczysz się w tym poradniku są fundamentami do zbudowania dowolnej aplikacji w Reakcie, a zrozumienie ich zapewni ci dogłębne poznanie tematu.
Instrukcja krok po kroku
Jeśli wolisz naukę pojęć krok po kroku, zacznij od przewodnika po głównych zagadnieniach. Każdy kolejny rozdział jest tu oparty o wiedzę nabytą w poprzednim, więc radzimy niczego nie pomijać.
Myślenie po reactowemu
Wielu użytkownikom Reacta bardzo pomogła lektura rozdziału pt. Myślenie po reactowemu, bo dzięki niemu coś im w końcu “zaskoczyło” w głowie. To prawdopodobnie najstarszy przewodnik po Reakcie, jednakże jest on wciąż aktualny.
Rekomendowane kursy
Czasem ludzie preferują książki i kursy wideo stworzone przez innych użytkowników, ponieważ są one dla nich bardziej pomocne. Dla takich osób stworzyliśmy listę rekomendowanych źródeł, z których część jest darmowa.
Zaawansowane pojęcia
Kiedy będziesz się już czuć komfortowo z podstawowymi pojęciami, a za sobą będziesz mieć trochę zabawy z kodem w Reakcie, mogą zainteresować cię bardziej zaawansowane zagadnienia. Ta sekcja zapozna cię z przydatnymi, acz rzadziej używanymi funkcjonalnościami, jak konteksty (ang. contexts) czy referencje (ang. refs).
Dokumentacja API
Ta sekcja dokumentacji może okazać się przydatna, jeśli chcesz dowiedzieć się więcej o API Reacta. Na przykład, dokumentacja klasy React.Component pozwoli ci w szczegółach zrozumieć działanie setState() oraz jak działają metody z cyklu życia komponentu.
Słownik pojęć i FAQ
Słownik pojęć zawiera przegląd najczęściej używanych terminów, które napotkasz w dokumentacji Reacta. Istnieje także sekcja FAQ, poświęcona krótkim pytaniom i odpowiedziom na najpopularniejsze tematy, między innymi “Jak wykonać zapytanie AJAX-owe?”, “Co to jest stan komponentu?” oraz “Jak powinna wyglądać struktura plików?”.
Bądź na bieżąco
Blog Reacta jest oficjalnym źródłem aktualizacji i newsów od zespołu Reacta. Wszystkie istotne informacje, w tym notki dotyczące nowych wydań oraz informacje o zdezaktualizowanych elementach, znajdą się tam jako pierwsze.
Możesz obserwować konto @reactjs na Twitterze, jednak nie ominie cię nic ważnego, jeśli będziesz śledzić jedynie bloga.
Nie każde nowe wydanie Reacta wymaga osobnego posta na blogu, jednak informacje o każdym wydaniu zawsze trafiają do pliku CHANGELOG.md w repozytorium Reacta, a także na liście opublikowanych wersji.
Dokumentacje wersji
Ta dokumentacja zawsze odzwierciedla najnowszą stabilną wersję Reacta. Począwszy od Reacta w wersji 16, starsze wersje dokumentacji publikowane są na osobnej podstronie. Pamiętaj jednak, że dokumentacje do starszych wersji nie są już aktualizowane.
Czegoś brakuje?
Jeśli brakuje ci czegoś w dokumentacji lub któraś część nie jest wystarczająco jasna, proszę zgłoś to w repozytorium dokumentacji (w wiadomości zamieszczając swoje sugestie) bądź napisz tweeta do @reactjs. Chętnie dowiemy się, co myślisz!