Primi Passi
Questa pagina offre una panoramica sulla documentazione di React e sulle risorse correlate.
React è una libreria JavaScript per lo sviluppo d’interfacce utente. Impara cos’è React cominciando dalla nostra homepage o dal tutorial.
Prova React
React è stato progettato sin dal principio per la sua graduale adozione, per questo puoi utilizzare quel poco o quel tanto di React di cui hai bisogno. Se vuoi avere un assaggio di React, aggiungere un po’ di interattività ad una semplice pagina HTML, o se vuoi cominciare lo sviluppo di un’intera app complessa basata su React, i link in questa sezione ti aiuteranno nei primi passi.
Online Playgrounds
Se ti interessa giocare con il codice React, puoi utilizzare uno dei “Parchi Giochi” disponibili online. Prova un template “Hello World” su CodePen, CodeSandbox, o Stackblitz.
Se invece preferisci utilizzare il tuo editor di testo, puoi scaricare questo file HTML, modificarlo ed aprirlo nel tuo browser dal tuo filesystem. Dato che viene eseguita una lenta trasformazione del codice a runtime, raccomandiamo l’uso di questa modalità solo per semplici demo.
Aggiungere React ad un Sito
Puoi aggiungere React ad una pagina HTML in un minuto. Potrai a quel punto espandere la sua presenza o mantenerlo confinato in pochi widgets isolati.
Creare una Nuova App React
Quando si deve incominciare un nuovo progetto React, una semplice pagina HTML con script tags potrebbe ancora essere la migliore opzione. Richiede solo un minuto per il setup!
Man mano che la tua applicazione cresce, potresti voler considerare un setup più integrato. Esistono diverse toolchains JavaScript che raccomandiamo per lo sviluppo di applicazioni più complesse. Ognuna di esse può funzionare con poche impostazioni oppure senza dover impostare nulla permettendoti di ottenere tutti i vantaggi del ricco ecosistema di React. Impara come.
Impara React
Le persone che si avvicinano a React hanno background e stili di apprendimento differenti. A prescindere dal fatto che tu preferisca un approccio più teorico o pratico, speriamo che questa sezione ti sia di aiuto.
- Se preferisci imparare facendo, inizia dal nostro tutorial pratico.
- Se preferisci imparare i concetti passo passo, inizia dalla nostra guida ai concetti principali.
Come ogni nuova tecnologia, anche React ha una curva di apprendimento. Con la pratica ed un po’ di pazienza, lo imparerai fino in fondo, garantito.
Primi Esempi
L’Homepage di React contiene alcuni piccoli esempi di codice, affiancati da un editor in tempo reale. Anche se non sai nulla riguardo React, prova a cambiare qualcosa nel codice per vedere che effetto ha nel risultato.
React per i Principianti
Se ritieni che la documentazione di React vada troppo veloce per i tuoi gusti, dai uno sguardo a questa panoramica di React scritta da Tania Rascia. Essa dà una introduzione sui concetti di React più importanti in modo dettagliato e semplice. Quando hai finito, prova di nuovo con la nostra documentazione!
React per i Designers
Se hai un background in design, queste risorse sono un ottimo punto di partenza.
Risorse JavaScript
La documentazione di React assume un po’ di familiarità con la programmazione nel linguaggio JavaScript. Non hai bisogno di essere un esperto, ma è più difficile imparare React e JavaScript contemporaneamente.
Ti raccomandiamo di dare un’occhiata a questa panoramica su JavaScript per verificare il tuo livello di conoscenza. Ti richiederà tra 30 minuti ed un’ora per completarla ma alla fine ti sentirai più confidente nell’apprendimento di React.
Suggerimento
Ogni qual volta troverai che qualche concetto in JavaScript non ti sia chiaro, MDN e javascript.info sono degli ottimi siti da visitare. Esistono anche forum di supporto della comunità dove puoi chiedere aiuto.
Tutorial Pratico
Se preferisci imparare facendo, dà uno sguardo al nostro tutorial pratico. In esso, sviluppiamo un gioco tic-tac-toe (tris) in React. Potresti avere la tentazione di non seguire il tutorial perché normalmente non sviluppi giochi — ma dagli una possibilità. Le tecniche che imparerai nel tutorial sono fondamentali per la costruzione di ogni app in React, impararle ti darà una comprensione molto più profonda.
Guide Passo-Passo
Se preferisci imparare i concetti passo dopo passo, la nostra guida ai concetti principali è il posto migliore per cominciare. Ogni nuovo capitolo in essa si basa sui concetti introdotti nei capitoli precedenti facendo sì che non ti perderai nulla via via che prosegui.
Pensare in React
Molti utilizzatori di React danno molto credito alla lettura di Pensare in React come il momento in cui hanno “fatto pace” con React. Probabilmente si tratta della più vecchia guida a React ma è ancora del tutto rilevante.
Corsi Raccomandati
Alcuni talvolta trovano che libri di terze parti e videocorsi siano di maggiore aiuto rispetto alla documentazione ufficiale. Manteniamo una lista delle risorse comunemente raccomandate, alcune delle quali sono gratuite.
Concetti Avanzati
Una volta che hai imparato i concetti principali ed utilizzato React per un po’, potrai trovare interessanti alcuni temi più avanzati. Questa sezione ti introdurrà alle funzioni più potenti ma meno utilizzate in React come context e refs.
API di Riferimento
Questa sezione della documentazione è utile quando devi imparare in dettaglio una specifica API di React. Ad esempio, l’API di riferimento di React.Component
offre dettagli su come funziona setState()
e su per cosa e come, i vari metodi di lifecycle, possono essere utilizzati.
Glossario e FAQ
Il glossario contiene una panoramica dei temini più comuni che troverai nella documentazione di React. Esiste anche una sezione con le FAQ (domande frequenti) dove potrai trovare brevi domande e risposte riguardo i temi più comuni, inclusi creare richieste AJAX, stato dei componenti e struttura dei file.
Rimanere Aggiornati
Il blog di React è la fonte ufficiale per gli aggiornamenti dal team di React. Ogni annuncio importante, incluse note di rilascio o di obsolescenza, verranno postate qui inizialmente.
Puoi inoltre seguire l’account @reactjs su Twitter, ma non ti perderai nulla di essenziale leggendo solo il blog.
Non tutte le release di React meritano un blog post, potrai comunque trovare la lista dei cambiamenti per ogni release nel file CHANGELOG.md
nella repository di React, oltre che nella pagina Releases.
Documentazione Versionata
Questa documentazione riflette sempre l’ultima versione stabile di React. A partire da React 16, puoi trovare le vecchie versioni della documentazione in una pagina separata. Nota che la documentazione per le versioni precedenti viene salvata al momento del rilascio, non riceve più aggiornamenti in seguito.
Manca Qualcosa?
Se ritieni che la documentazione abbia delle lacune, oppure se trovi che alcune parti non siano chiare, per favore crea una issue nel repository della documentazione con i tuoi suggerimenti, oppure invia un tweet all’account @reactjs. Adoriamo ricevere feedback!