Lorsque vous travaillez avec React, Vite offre une expérience de développement rationalisée avec quelques différences clés par rapport à la configuration traditionnelle de l'application Create React. Cet article de blog explorera la structure d'un projet Vite typique, en se concentrant sur les fichiers clés tels que index.html, main.jsx et App.jsx.

1. index.html

Dans une application React alimentée par Vite, index.html sert de point de départ critique. Contrairement à Create React App, où les scripts sont injectés automatiquement, Vite vous oblige à spécifier directement les fichiers de script. Cette inclusion explicite simplifie la compréhension des points d'entrée et des dépendances de votre application.

Dans cet exemple, vous pouvez voir la balise de script charger directement main.jsx. Cette inclusion directe constitue une différence majeure par rapport à l'application Create React, car elle améliore la clarté et le contrôle des points d'entrée du projet.

1.1 Dépendances

Pour garantir le chargement correct de vos fichiers de script, Vite exploite les importations de modules ES modernes. Assurez-vous que votre package.json inclut les dépendances nécessaires :

"dependencies": {
  "react": "^18.2.0",
  "react-dom": "^18.2.0"
}

L'inclusion explicite du script dans le fichier HTML garantit le bon ordre de chargement et d'exécution de votre application, atténuant ainsi les problèmes potentiels de chargement du script.

2. main.jsx

Le fichier main.jsx sert de point d'entrée à votre application React. Ce fichier est responsable du rendu du composant racine dans le DOM. Il s'agit généralement du fichier spécifié dans l'attribut src de la balise script dans votre index.html.

import React from 'react';
import ReactDOM from 'react-dom/client';
import App from './App.jsx';
import './index.css';

// Render the root component into the root element in the HTML
ReactDOM.createRoot(document.getElementById('root')).render(
  
    
  
);

Dans ce fichier, ReactDOM.createRoot est utilisé pour restituer le composant App dans l'élément HTML avec l'identifiant racine. Cette approche de rendu direct, sans conserver temporairement aucun élément racine, rationalise le processus, en indiquant clairement où démarre l'application et quels composants sont impliqués.

3. App.jsx

Le fichier App.jsx contient la définition de votre composant principal d'application. Ce composant sert de racine à votre arborescence de composants React.

import React from 'react';

const App = () => {
  return (
    

      
Hello, Vite and React!
    
  );
};

export default App;

Dans ce fichier, vous définissez la structure principale et le comportement de votre application. Le composant App est l'endroit où vous créerez l'interface utilisateur et les fonctionnalités principales, comme vous le feriez dans n'importe quel autre projet React.

Documents supplémentaires et meilleures pratiques

4. Utiliser Tailwind CSS avec Vite

Tailwind CSS peut être facilement intégré à un projet Vite pour un style axé avant tout sur l'utilitaire.

1. Installer Tailwind CSS :

npm install -D tailwindcss postcss autoprefixer
npx tailwindcss init -p

1. Configurer Tailwind :

Mettez à jour tailwind.config.js avec les chemins spécifiques de votre projet :

module.exports = {
  content: ['./index.html', './src/**/*.{js,jsx,ts,tsx}'],
  theme: {
    extend: {},
  },
  plugins: [],
};

1. Incluez Tailwind dans votre CSS :

Mettez à jour index.css pour inclure la base, les composants et les utilitaires de Tailwind :

@tailwind base;
@tailwind components;
@tailwind utilities;

5. Remplacement du module à chaud (HMR)

Vite propose un HMR prêt à l'emploi, vous permettant de voir les modifications en temps réel sans actualiser la page.

6. Variables d'environnement

Vite utilise des fichiers .env pour gérer les variables d'environnement. Créez un fichier .env à la racine de votre projet et définissez vos variables :

VITE_API_URL=https://api.example.com

Accédez à ces variables dans votre application à l'aide de import.meta.env :

const apiUrl = import.meta.env.VITE_API_URL;

7. Processus de construction optimisé

La commande build de Vite (vite build) utilise Rollup sous le capot pour produire des actifs statiques hautement optimisés pour la production. Cela garantit que votre candidature est rapide et efficace.

Conclusion

Travailler avec Vite dans un projet React offre une expérience de développement rationalisée et efficace. Comprendre le flux et la structure des fichiers clés tels que index.html, main.jsx et App.jsx peut améliorer considérablement votre processus de développement. Avec les avantages supplémentaires de l'intégration Tailwind CSS, du HMR et des versions optimisées, Vite se distingue comme un outil moderne et puissant pour les développeurs React.

En tirant parti de ces fonctionnalités et de ces bonnes pratiques, vous pouvez créer facilement des applications hautes performances, évolutives et maintenables.