Différences

Ci-dessous, les différences entre deux révisions de la page.

Lien vers cette vue comparative

Prochaine révision		Révision précédente
composants_et_pages [2025/09/25 06:50] – créée paolocomposants_et_pages [2025/09/25 12:53] (Version actuelle) – paolo
Ligne 1: Ligne 1:
 # Composants et pages # Composants et pages
 +
 +Les composants sont les éléments de base d'un projet React. Chacun d'entre d'eux représente une partie de l'interface utilisateur. Ils sont réutilisables et facilitent le développement ainsi que la maintenance du projet.
 +
 +#### Où ranger un composant ?
 +
 +Imaginons que l'on souhaite faire un composant de formulaire comprenant **label** + **input**.
 +
 +Pour cela on a deux possibilités:
 +  * on crée un fichier ''Input.jsx'' soit ''components/form/Input.jsx''
 +  * on crée un dossier ''Input'' puis un fichier ''index.jsx'' à l'intérieur soit ''components/form/Input/index.jsx''
 +
 +La deuxième méthode est conseillée car elle offre un espace dédié au composant (dossier ''Input'') dans lequel d'autres fichiers le concernant pourront être placés.
 +
 +#### Comment faire un composant ?
 +
 +Un composant est avant tout une fonction **JS** (fléchée ou déclarée) retournant du **JSX** (un mélange de **JS** et de balises **HTML** en quelques sortes). Un composant peut renvoyer une portion d’interface, ou être plus avancé en gérant des **props** (paramètres du composant), en modifiant l’état interne (**useState**, **useReducer**, ...) et en utilisant des effets (**useEffect**). On peut aisin construire une interface réutilisable, dynamique et modulaire.
 +
 +Je vous invite à jeter un coup d'oeuil à la documentation de [React](https://react.dev/).
 +
 +Ici on va rester simple avec un composant avec quelques **props**:
 +
 +
 +```
 +export const Input = (props) => {
 +    const { label, id, ...inputProps } = props;
 +
 +    return (
 +        <div className="flex flex-col gap-3 text-gray-900">
 +           {label &&
 +              <label 
 +                  htmlFor={id}
 +                  className="uppercase text-gray-400 font-extrabold tracking-widest text-xs mx-2"
 +              >
 +                  {label}
 +              </label>
 +            }
 +            <input
 +                id={id}
 +                className="bg-gray-100 text-app-base p-4 inset-shadow-sm font-semibold outline-hidden min-w-0 placeholder-gray-400 truncate rounded-2xl"
 +                { ...inputProps}
 +            />
 +        </div>
 +    );
 +};
 +```
 +
 +Utilisons maintenant ce composant dans une page de connexion par exemple (''components/pages/Login/index.jsx''):
 +
 +```
 +import { Input } from "../form/Input";
 +
 +export const Login = () => {
 +    return (
 +        <div className="fixed inset-0 bg-white flex justify-center items-center p-10">
 +            <form className="flex flex-col gap-6">
 +                <Input
 +                    id="email"
 +                    label="Adresse email"
 +                    type="email"
 +                    placeholder="Tapez votre adresse mail ici..."
 +                />
 +                <Input
 +                    id="password"
 +                    label="Mot de passe"
 +                    type="password"
 +                    placeholder="●●●●●●●●"
 +                />
 +                <button className="shadow-md bg-blue-500 text-white font-semibold text-xl uppercase tracking-wide rounded-full px-8 py-4 active:brightness-90 duration-100">
 +                    Connexion
 +                </button>
 +            </form>
 +        </div>
 +    );
 +};
 +```
 +
 +Vous entrevoyez un peu le principe maintenant ? Les composants sont réutilisables et peuvent s'imbriquer entre eux permettant de gagner en temps développement et de maintenance.
 +
 +Il n'y a pas vraiment de convention en ce qui concerne l'organisation des composants, chaque projet peut avoir la sienne. Personnellement, je considère qu'avoir un dossier pages permet de visualiser et de structurer concrètement l'interface (**Login**, **Register**, **Home**, **Settings**, ...).
 +
 +Bon assez parlé ! Et si on essayait d'afficher cette page de connexion ?
 +
 +Pour çà, on peut ouvrir le fichier ''App.jsx'' (composant pricipal) et y mettre notre page:
 +
 +```
 +import { Login } from "./components/pages/Login";
 +
 +export const App = () => {
 +    return (
 +        <Login />
 +    );
 +};
 +```
 +
 +On lance la commande ''npm run dev'' et on se rend sur le ''http://localhost:5173/''. Les composants ci-dessus ainsi que tous les exemples suivants sont stylisés "mobiles". Il est conseillé de les tester sur petit écran.