# Documentazione React: come leggerla senza perdersi

React docs e react documentation portano a react.dev, diviso in guide, riferimento API e comunità. Si legge per versione, partendo dalla firma e dalle trappole.

> Pagina: https://ui.eneawork.it/blog/documentazione-react-come-si-legge
> Markdown: https://ui.eneawork.it/blog/documentazione-react-come-si-legge.md

*2026-11-01*

“React docs” e “react documentation” portano allo stesso indirizzo, react.dev, la documentazione ufficiale divisa in guide, riferimento API e comunità.

Il catalogo EneUI conta 111.985 componenti, 1.556 blocchi e 12.808 icone da 1.472 librerie, misurati da /api/stats il 1 novembre 2026. La cifra viene da una query all'endpoint, non da una stima: conta i record pubblicati, non la qualità dei componenti.

## Tre sezioni, tre usi

## Prima controlla la versione

npm ls react react-dom npm view react version

La documentazione su react.dev descrive la versione stabile più recente, oggi la 19. Se il progetto è fermo a una 17 o 18, alcune pagine parlano di API che non hai: per quelle versioni esiste la documentazione storica su legacy.reactjs.org, con licenza MIT per il codice e contenuti CC BY 4.0.

## Come si legge una pagina di riferimento

Parti dalla firma: parametri, valori di ritorno e tipo. Poi leggi il riquadro delle trappole, che elenca gli errori frequenti meglio di qualsiasi tutorial. Solo dopo guarda gli esempi, e verifica se usano hook o API presenti nella tua versione. Le pagine di riferimento sono brevi proprio perché non raccontano un progetto completo.

## Cosa la documentazione non dice

Non dice quanto pesa un componente nel tuo bundle, non dice se una libreria di terze parti è compatibile e non misura le prestazioni della tua pagina. La documentazione descrive il contratto delle API, non il comportamento del tuo prodotto: per i numeri servono una build misurata e un profilo del browser.

## Un record vivo

Nel catalogo EneUI la documentazione diventa interfaccia: navigation-menu e sidebar sono componenti React su primitive Radix con licenza MIT. Per esplorare per categoria parti da 111.985 componenti.

## La limitazione

Non esiste una documentazione versionata per ogni release: react.dev segue la versione stabile e le versioni vecchie restano su un sito separato, che non riceve aggiornamenti. In più i risultati di ricerca mescolano risposte di dieci anni fa a domande di oggi, quindi la data della risposta conta più del numero di voti.

## Dove continuare

Scrivere documentazione per i propri componenti è in come documentare i componenti; il modello di distribuzione del codice è in che cos'è shadcn/ui; il confronto fra le primitive headless è in Radix, Base UI e React Aria.

## FAQ

### react.dev è la documentazione ufficiale di React?

Sì. react.dev è il sito mantenuto dal team React e sostituisce legacy.reactjs.org, che resta online per le versioni precedenti alla 18.

### Esiste la documentazione React in italiano?

Le traduzioni esistono in repository separati, ma non coprono tutte le pagine e possono restare indietro rispetto alla versione inglese. Per le API conviene leggere l'originale.

### Devo leggere tutta la documentazione prima di iniziare?

No. Conviene costruire un componente reale e consultare le pagine quando servono. Il percorso Learn React copre le basi in poche ore, il resto si legge per evenienza.

### Dove trovo le API introdotte in React 19?

Nella sezione Reference, alle pagine su Actions, useActionState, useOptimistic e use. Ogni pagina dichiara la versione minima in cui l'API è disponibile.

### La documentazione React spiega anche Next.js?

No. react.dev copre React e i Server Components come modello; le API del framework, le rotte e il caching sono documentati su nextjs.org.