Podstawowe informacje

Ta podstrona to przegląd dokumentacji Reacta oraz powiązanych zasobów.

React to biblioteka JavaScriptowa 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 lub CodeSandbox.

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, napisanie prostej strony w HTMLu ze script tagami może okazać się najlepszą opcją. 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.

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.

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.

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!