Aggiungere React Ad Un Sito
These docs are old and won’t be updated. Go to react.dev for the new React docs.
See Add React to an Existing Project for the recommended ways to add React.
Utilizza React quel poco o quel tanto che ti basta.
React è stato progettato fin dall’inizio per essere adottato gradualmente e puoi utilizzarlo quel poco o quel tanto che ti basta. Forse devi solamente aggiungere un “pizzico di interattività” a una pagina esistente. I componenti React sono un ottimo modo per farlo.
La maggior parte dei siti non sono applicazioni single-page e non hanno bisogno di esserlo. Prova ad utilizzare React in una piccola parte del tuo sito, con poche righe di codice e nessuno strumento di build. In seguito, puoi espandere gradualmente la sua presenza, oppure puoi mantenerlo confinato ad alcuni widget dinamici.
- Aggiungi React in Un Minuto
- Opzionale: Prova React con JSX (non è necessario alcun bundler!)
Aggiungi React in Un Minuto
In questa sezione, ti mostreremo come aggiungere un componente React ad una pagina HTML esistente. Per allenarti, puoi utilizzare il tuo sito oppure creare una pagina HTML vuota di prova.
Non ci saranno requisiti di installazione da soddisfare o strumenti complicati da utilizzare — per completare questa sezione, ti servono solamente una connessione a internet e un minuto del tuo tempo.
Opzionale: Scarica l’esempio completo (2KB zippato)
Passo 1: Aggiungi un Contenitore DOM all’HTML
Per prima cosa, apri la pagina HTML che vuoi modificare. Aggiungi un tag Abbiamo assegnato a questo Consiglio Puoi posizionare un Successivamente, aggiungi questi tre tag I primi due tag caricano React. Il terzo carica il codice del tuo componente. Crea un file chiamato Apri questo codice iniziale e incollalo nel file appena creato. Consiglio Questo codice definisce un componente React chiamato Dopo il codice iniziale, aggiungi due linee in fondo a Queste due linee di codice servono a trovare il Non c’è nessun passo 4. Hai appena aggiunto il primo componente React al tuo sito internet! Leggi le sezioni successive per avere più consigli su come integrare React. Guarda il codice completo dell’esempio Scarica l’esempio completo (2KB zippato) Di solito, vorrai visualizzare i componenti React in più punti nella pagina HTML. Ecco un esempio che visualizza il bottone “Mi Piace” tre volte e gli passa alcuni dati: Guarda il codice completo dell’esempio Scarica l’esempio completo (2KB zippato) Nota Questa strategia è utile soprattutto quando le parti della pagina realizzate con React sono isolate l’una dall’altra. All’interno del codice React, è più semplice invece utilizzare la composizione di componenti. Prima di rilasciare il tuo sito in produzione, ricordati che il codice JavaScript non minimizzato può rallentare significativamente la pagina per i tuoi utenti. Se minimizzi già gli script dell’applicazione, il tuo sito sarà pronto per la produzione se ti assicuri che l’HTML rilasciato carichi le versioni degli script di React che finiscono con Se invece non hai già un passaggio di minimizzazione dei tuoi script, ecco un modo per introdurlo. Negli esempi precedenti, abbiamo utilizzato solamente caratteristiche supportate nativamente dai browser. Ecco perché abbiamo utilizzato una funzione JavaScript per dire a React cosa visualizzare: Tuttavia, React offre anche la possibilità di utilizzare JSX: Questi due frammenti di codice sono equivalenti. Anche se JSX è completamente opzionale, molte persone trovano che sia utile per scrivere il codice della UI — non solo con React ma anche con altre librerie! Puoi fare esperimenti con JSX utilizzando questo convertitore online. Il modo più veloce di sperimentare JSX nel tuo progetto è aggiungere questo tag Ora puoi utilizzare JSX in qualsiasi tag Questo approccio va bene per imparare e creare demo semplici. Tuttavia, rende lento il tuo sito e non è adatto per la produzione. Quando sei pronto ad andare oltre, rimuovi questo nuovo tag Aggiungere JSX a un progetto non richiede strumenti complicati come un bundler (“impacchettatore”) o un server di sviluppo. Essenzialmente, aggiungere JSX è molto simile ad aggiungere un preprocessore CSS. L’unico requisito è installare Node.js nel tuo computer. Naviga nella cartella del tuo progetto con il terminale e incolla questi due comandi: Consiglio Stiamo utilizzando npm solamente per installare un preprocessore JSX; non ne avrai bisogno per tutto il resto. React e il codice applicativo possono essere lasciati nella forma attuale di tag Congratulazioni! Hai appena aggiunto un setup JSX pronto per la produzione al tuo progetto. Crea una cartella chiamata Nota Se vedi un messaggio di errore che recita qualcosa di simile a “You have mistakenly installed the Non aspettare che il comando termini — questo comando avvia un watcher (“osservatore”) automatico per JSX. Se ora crei un file chiamato Come bonus, questo ti consente anche di utilizzare le caratteristiche della sintassi moderna JavaScript come le classi senza preoccuparti di rompere i vecchi browser. Lo strumento che abbiamo appena utilizzato si chiama Babel, puoi saperne di più dalla sua documentazione (in inglese). Se ti accorgi di trovarti bene con gli strumenti di build e vuoi che facciano più cose per te, la prossima sezione descrive alcune delle più popolari e semplici “toolchains” (combinazioni di strumenti). In caso contrario — nessun problema, quei tag
<div id="contenitore_bottone_like">div>
id
univoco. Questo ci consentirà più tardi di trovarlo con il codice JavaScript e di visualizzare un componente React al suo interno.
. Puoi inserire tutti i contenitori DOM indipendenti di cui hai bisogno in una pagina. Solitamente vengono lasciati vuoti — React sostituirebbe comunque qualsiasi cosa si trovasse all’interno dei contenitori DOM.
Passo 2: Aggiungi i Tag Script
alla pagina HTML, subito prima del tag di chiusura
:
<script src="https://unpkg.com/react@18/umd/react.development.js" crossorigin>script> <script src="https://unpkg.com/react-dom@18/umd/react-dom.development.js" crossorigin>script>
<script src="bottone_like.js">script>
body>
Passo 3: Crea un Componente React
bottone_like.js
accanto alla tua pagina HTML.
LikeButton
(bottone “Mi Piace”). Non preoccuparti se non lo capisci subito — illustreremo i concetti fondamentali di React nel tutorial “mani in pasta” e nella guida ai concetti fondamentali. Per ora, limitiamoci a fare in modo che il componente venga mostrato sullo schermo!like_button.js
:// ... il codice iniziale che hai incollato ...
const domContainer = document.querySelector('#like_button_container');const root = ReactDOM.createRoot(domContainer);root.render(e(LikeButton));
Tutto qua!
Consiglio: Riutilizza i Componenti
Consiglio: Minimizza il JavaScript per la Produzione
production.min.js
:<script src="https://unpkg.com/react@18/umd/react.production.min.js" crossorigin>script>
<script src="https://unpkg.com/react-dom@18/umd/react-dom.production.min.js" crossorigin>script>
Opzionale: Prova React con JSX
const e = React.createElement;
// Mostra un
return e(
'button',
{ onClick: () => this.setState({ piaciuto: true }) },
'Mi Piace'
);
// Mostra un
return (
<button onClick={() => this.setState({ piaciuto: true })}>
Mi Piace
button>
);
Prova JSX Velocemente
alla tua pagina:
<script src="https://unpkg.com/babel-standalone@6/babel.min.js">script>
aggiungendovi l’attributo
type="text/babel"
. Questo è un file HTML di esempio con JSX che puoi scaricare ed utilizzare per i tuoi esperimenti. e gli attributi
type="text/babel"
che avevi aggiunto. Al loro posto, nella prossima sezione configurerai un preprocessore che convertirà tutti i tuoi tag automaticamente.
Aggiungere JSX a un Progetto
npm init -y
(se fallisce, questa è una correzione)npm install babel-cli@6 babel-preset-react-app@3
, senza modifiche.
Eseguire il Preprocessore JSX
src
ed esegui questo comando dal terminale:npx babel --watch src --out-dir . --presets react-app/prod
npx
non è un errore di battitura — è un esecutore di pacchetti incluso in npm 5.2+.babel
package” (“Hai installato accidentalmente il pacchetto babel
”), potresti aver saltato il passo precedente. Eseguilo adesso nella stessa cartella e poi ritenta.src/bottone_like.js
con questo codice JSX iniziale, il watcher creerà un file bottone_like.js
preprocessato contenente il codice JavaScript adatto al browser. Quando modifichi il file sorgente con JSX, la trasformazione verrà ri-eseguita automaticamente. andranno benissimo!
- Previous article
- Next article