Bien démarrer

Cette page est un aperçu de la documentation React et des ressources associées.

React est une bibliothèque JavaScript pour la construction d’interfaces utilisateur (UI). Pour découvrir à quoi sert React, allez sur notre page d’accueil ou dans le tutoriel.


Essayer React

React a été conçu dès le départ pour une adoption progressive, et vous pouvez utiliser React a minima ou autant que nécessaire. Que vous souhaitiez avoir un aperçu de React, ajouter de l’interactivité à une simple page HTML ou démarrer une application React complète, les liens de cette section vous aideront à bien démarrer.

Terrains de jeu en ligne

Si vous souhaitez tester React, vous pouvez utiliser un terrain de jeu en ligne. Essayez un modèle Hello World sur CodePen, CodeSandbox ou Glitch.

Si vous préférez utiliser votre propre éditeur de texte, vous pouvez aussi télécharger ce ficher HTML, l’éditer et l’ouvrir à partir du système de fichiers local dans votre navigateur. Il transforme le code à la volée lors de l’exécution, ce qui est particulièrement lent. Pour cette raison, nous vous recommandons de ne l’utiliser que pour des démos simples.

Ajouter React à un site Web

Vous pouvez ajouter React à une page HTML en une minute et ensuite étendre progressivement sa présence ou la limiter à quelques éléments d’interface dynamiques.

Créer une nouvelle application React

Lorsque vous démarrez un projet React, une simple page HTML avec des balises de script reste peut-être la meilleure option. Ça ne prend qu’une minute à mettre en place !

Au fur et à mesure que votre application grandit, vous voudrez peut-être envisager une configuration plus intégrée. Il y a plusieurs boîtes à outils JavaScript que nous conseillons pour des applications plus importantes. Chacune d’entre elles peut fonctionner avec peu ou pas de configuration et vous permet de tirer pleinement parti du riche écosystème de React.

Apprendre React

Les gens qui découvrent React viennent d’horizons et de styles d’apprentissage variés. Que vous préfériez une approche plutôt théorique ou pratique, nous espérons que vous trouverez cette section utile.

  • Si vous préférez apprendre en faisant, commencez par notre tutoriel.
  • Si vous préférez apprendre les concepts étape par étape, commencez par notre guide des fondamentaux.

Comme toute technologie que vous ne connaissez pas encore, React a une certaine courbe d’apprentissage. Avec de la pratique et un peu de patience, vous arriverez à le maîtriser.

Premiers exemples

La page d’accueil de React contient quelques petits exemples React que vous pouvez modifier directement en ligne. Même si vous ne connaissez rien encore à React, essayez de changer le code de ces exemples et voyez comment cela affecte le résultat.

React pour les débutant·e·s

Si vous trouvez que la documentation React va un peu trop vite pour vous, consultez cet aperçu de React par Tania Rascia. Il présente les concepts les plus importants de React de façon détaillée et conviviale pour les débutant·e·s. Une fois que vous avez terminé, essayez à nouveau la documentation !

React pour les designers

Si vous avez plutôt une expérience de designer, ces ressources sont un excellent moyen de commencer.

Ressources JavaScript

La documentation de React suppose une certaine habitude de la programmation en langage JavaScript. Pas besoin d’être un·e expert·e, mais il est plus difficile d’apprendre à la fois React et JavaScript.

Nous vous recommandons de parcourir cet aperçu JavaScript pour vérifier votre niveau de connaissances. Ça vous prendra entre 30 minutes et une heure, mais vous vous sentirez plus en confiance pour apprendre React.

Astuce

Chaque fois que quelque chose en JavaScript vous semble déroutant, MDN et javascript.info sont d’excellents sites pour vérifier. On trouve aussi des forums de soutien communautaire dans lesquels vous pouvez demander de l’aide.

Tutoriel pratique

Si vous préférez apprendre par la pratique, allez voir notre tutoriel pratique. Dans ce tutoriel, nous construisons un jeu de morpion en React. Vous pourriez être tenté·e de l’ignorer sous prétexte que vous ne construisez pas de jeux—mais donnez-lui sa chance. Les techniques que vous apprendrez dans ce tutoriel sont fondamentales pour la construction de n’importe quel type d’appli React, et les maîtriser vous apportera une compréhension profonde de React.

Guide étape par étape

Si vous préférez apprendre les concepts étape par étape notre guide des fondamentaux est le meilleur endroit pour commencer. Chaque chapitre s’appuie sur les connaissances introduites dans les précédents, afin que vous ne manquiez de rien pour avancer.

Penser en React

De nombreux utilisateurs de React estiment que c’est en lisant Penser en React que React a enfin « cliqué » pour eux. C’est probablement le plus ancien guide pas-à-pas sur React, mais il est toujours aussi pertinent.

Parfois les gens préféreront des livres et cours vidéo créés par des tiers à la documentation officielle. Nous maintenons une liste de ressources fréquemment recommandées, dont certaines sont gratuites.

Guides avancés

Une fois que vous serez à l’aise avec les fondamentaux et que vous aurez joué un peu avec React, vous pourriez être intéressé·e par des sujets plus avancés. Cette section présente les fonctionnalités puissantes, mais moins utilisées, de React, telles que le contexte et les refs.

Référence de l’API

Cette section de la documentation est utile lorsque vous souhaitez en savoir plus sur une API React spécifique. Par exemple, la référence de l’API React.Component peut vous fournir des détails sur le fonctionnement de setState(), et sur les utilités respectives des différentes méthodes de cycle de vie.

Glossaire et FAQ

Le glossaire contient un aperçu des termes les plus couramment employés dans la documentation de React. Il y a également une section FAQ dédiée aux questions et réponses courtes sur des sujets fréquents, tels que faire des requêtes AJAX, gérer l’état local des composants, et la structure de fichiers.

Se tenir au courant

Le blog React est la source officielle des mises à jour, par l’équipe de React. Tout ce qui est important, y compris les notes de publication ou les avis de dépréciation, y est publié en priorité.

Vous pouvez également suivre le compte @reactjs sur Twitter, mais rien d’essentiel ne vous échappera si vous ne lisez que le blog.

Toutes les versions de React ne méritent pas leur propre article de blog, mais vous pouvez trouver un changelog détaillé pour chaque version dans le fichier CHANGELOG.md du dépôt React, ainsi que sur la page des Releases.

Documentation versionnée

Cette documentation reflète toujours la dernière version stable de React. Depuis React 16, vous pouvez trouver les anciennes versions de la documentation sur une page séparée. Notez que la documentation des versions antérieures est figée au moment de la publication et n’est plus mise à jour par la suite.

Quelque chose vous manque ?

Si quelque chose manque dans la documentation ou si vous en trouvez une partie déroutante, veuillez créer une issue sur le dépôt de la documentation avec vos suggestions d’amélioration, ou tweetez en mentionnant le compte @reactjs. Nous adorons avoir de vos nouvelles !