| id | title | permalink | next | redirect_from | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
getting-started |
Podstawowe informacje |
docs/getting-started.html |
add-react-to-a-website.html |
|
Ta podstrona to przegląd dokumentacji Reacta oraz powiązanych zasobów.
React to biblioteka JavaScript służąca do budowy interfejsów. Dowiedz się czym tak naprawdę jest React na naszej stronie głównej lub w tutorialu.
React został zaprojektowany z myślą o stopniowym wdrażaniu. Dzięki temu możesz użyć tak wiele lub tak mało Reacta, jak tego potrzebujesz. W zależności czy potrzebujesz jedynie spróbować Reacta i dodać trochę interakcyjności do prostej strony HTML, czy zacząć skomplikowaną aplikację zasilaną Reactem, linki w tej sekcji pomogą Ci zacząć.
Jeśli jesteś zainteresowany wypróbowaniem Reacta, możesz w tym celu użyć playgroundów online. Wypróbuj szablonów Hello World na CodePen lub CodeSandbox.
Jeśli wolisz użyć swojego własnego edytora tekstu, możesz także ściągnąć ten plik HTML, edytować go, następnie otworzyć lokalnie w swojej przeglądarce. Pamiętaj jednak, że wykonuje on transformację kodu, więc zalecamy go jedynie do prostych przykładów.
Możesz dodać Reacta do swojej strony HTML w ciągu minuty. Możesz stopniowo rozszerzać jego ilość lub używać go jedynie do kilku dynamicznych widgetów.
Gdy zaczynasz projekt w Reakcie, prosta strona HTML ze script tagami wciąż może być najlepszą opcją. Zajmie Ci to tylko minutę!
Podczas gdy twoja aplikacja się rozwija, możesz zacząć myśleć o bardziej zintegrowanym ustawieniu. Jest kilka JavaScriptowych narzędzi, które polecamy do rozwoju większych aplikacji. Każda z nich może wymagać drobnej lub żadnej konfiguracji i skorzystać z pełni mocy ekosystemu React.
Ludzie zaczynają z Reactem przychodząc z różnych środowisk i doświadczeń z językami programowania. Niezależnie czy preferujesz bardziej techniczne, czy praktyczne podejście, mamy nadzieję, że uznasz tę sekcję za pomocną.
- Jeśli preferujesz naukę przez praktykę, zacznij z naszymi praktycznymi tutorialami.
- Jeśli wolisz naukę konceptów krok po kroku, zacznij z przewodnikiem po głównych konceptach.
Jak każda technologia, z którą nie jest się zaznajomionym, React ma swoją krzywą uczenia. Z odrobiną praktyki i cierpliwości, zrozumiesz na czym polega.
Strona główna Reacta zawiera kilka małych przykładów z edytorem kodu live. Nawet jeśli nie wiesz jeszcze nic o React, spróbuj zmienić kod i zobaczyć jakie to przyniesie efekty.
Jeśli wydaje Ci się, że dokumentacja Reacta prowadzi Cię w zbyt szybkim tempie, sprawdz ten przegląd Reacta napisany przez Tanię Rascię. Wprawdzi Cię to w najistotniejsze koncepty Reacta w szczegółach, zachowując styl zrozumiały dla początkujących. Gdy będziesz gotowy, spróbuj ponownie przeczytać naszą dokumentację!
Jeśli zaczynając z Reactem, przychodzisz ze środowiska graficznego, te źródła mogą być świetnym miejscem do startu.
Dokumentacja Reacta zakłada znajomość języka programowania JavaScript na pewnym poziomie. Nie musisz być ekspertem, jednakże nauka zarówno Reacta jak i JavaScript w tym samym czasie może być nieco cięższa.
Proponujemy zapoznanie się z przeglądem informacji o JavaScript, by sprawdzić swoją wiedzę. Powinno Ci to zająć około 30 minut do godziny, jednak sprawi to, że nauka Reacta będzie bardziej komfortowa.
Podpowiedź
Kiedykolwiek jesteś zdezorientowany czymś w JavaScript, MDN oraz javascript.info są świetnymi źródłami nauki. Istnieją także fora internetowe, gdzie możesz zapytać o pomoc.
Jeśli preferujesz naukę przez praktykę sprawdź nasze praktyczne tutoriale. W tym tutorialu, budujemy grę w kółko i krzyżyk w Reakcie. Jeśli kusi Cię, by opuścić ten tutorial, ponieważ nie budujesz gier -- daj mu szansę. Techniki, których nauczysz się w tym tutorialu są fundamentami do zbudowania każdej aplikacji w Reakcie, a zrozumienie ich zapewni Ci dogłębne zrozumienie tematu.
Jeśli preferujesz naukę konceptów krok po kroku, nasz przewodnik po głównych konceptach jest najlepszym miejscem do startu. Każdy kolejny rozdział jest oparty o wiedzy nabytej w poprzednim, więc upewnij się, że nie pomijasz niczego.
Wielu użytkowników Reacta ceni sobie czytanie Myślenie w Reakcie za możliwość zrozumienia koncepcji. To prawdopodobnie najstarszy przewodnik po Reactcie, jednakże jest on wciąż aktualny.
Czasem ludzie preferują książki i kursy wideo stworzone przez innych użytkowników, uznając je bardziej pomocnymi. Tworzymy listę rekomendowanych źródeł, z których część jest darmowa.
Kiedy będziesz się już czuł komfortowo z głównymi konceptami i spędził odpowiednio dużo czasu nad pracą w Reakcie, możesz być zainteresowany bardziej zaawansowanymi koncepcjami. Ta sekcja zapozna Cię z przydatnymi, acz rzadziej używanymi cechami jak context lub refs.
Ta sekcja dokumentacji jest pożyteczna, jeśli chcesz dowiedzieć się więcej o API Reacta. Na przykład, React.Component referencja API pozwoli Ci w szczegółach zrozumieć działanie setState(), oraz jak działają metody z cyklu życia komponentu.
Słownik 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 wykonywanie zapytań AJAX, stan komponentu, oraz struktura plików.
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 informacjach 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 obserwował jedynie bloga.
Nie każde nowe wydanie Reacta potrzebuje osobnego posta na blogu, jednak możesz znaleźć informację o każdym wydaniu w pliku CHANGELOG.md w repozytorium Reacta
Ta dokumentacja zawsze odzwierciedla najnowszą stabilną wersję Reacta. Od Reacta 16, możesz także znaleźć starsze wersje w dokumentacji na osobnej podstronie. Pamiętaj jednak, że dokumentacje do starszych wersji nie są dalej rozwijane.
Jeśli czegoś brakuje w dokumentacji lub któraś część nie jest wystarczająco jasna, proszę załóż nowe 'Issue' w repozytorium dokumentacji z Twoimi sugestiami do usprawnień, lub wyślij tweeta do @reactjs. Chętnie dowiemy się co sądzisz!