Accueil › React › Paramètres d'URL
Paramètres d'URL
Le routeurintermediaire
Lire un paramètre de chemin
// route : { path: "/clients/:id", element: <FicheClient /> }
function FicheClient() {
const { id } = useParams(); // toujours une chaîne
const numero = Number(id);
if (!Number.isInteger(numero)) return <PageIntrouvable />;
// ...
}
useParams rend un objet de chaînes. Une URL est du texte, et le routeur
ne connaît pas le type attendu. Number(id) sur un identifiant malformé rend
NaN, qui traverse silencieusement jusqu'à l'appel réseau.
Lire et écrire les paramètres de requête
const [params, setParams] = useSearchParams();
const tri = params.get("tri") ?? "nom";
const page = Number(params.get("page") ?? 1);
function trierPar(cle) {
setParams({ tri: cle, page: "1" }); // remplace tout
}
setParams remplace l'ensemble des paramètres. Pour n'en changer qu'un :
setParams((p) => {
const copie = new URLSearchParams(p);
copie.set("tri", cle);
copie.delete("page");
return copie;
});
Chemin ou requête ?
Le chemin identifie la ressource, la requête décrit la vue qu'on en a.
/clients/42 est une fiche ; /clients?tri=nom&page=2 est une façon de
regarder la liste. Mettre un filtre dans le chemin interdit de le retirer sans
changer de route.
Les termes à connaître
- Paramètre de chemin
Un segment variable du motif, écrit
:id. Il identifie une ressource et fait partie du chemin :/clients/42.- Paramètre de requête
Ce qui suit le
?. Il décrit une vue de la ressource — tri, page, filtre — et non la ressource elle-même.- Segment attrape-tout
Le motif
*, qui absorbe plusieurs segments d'un coup. On le lit dansuseParams()["*"].- URL canonique
Une seule écriture possible pour une même demande : clés triées, valeurs vides retirées. Sans elle, un cache garde deux entrées pour une question unique.
- Source de vérité
L'endroit qui détient l'information. Quand un filtre est dans l'URL, l'URL est la source de vérité, et l'état local n'en est qu'une copie à éviter.
- Encodage d'URL
La transformation des caractères réservés — espace,
&,/— en séquences%xx.encodeURIComponentà l'écriture,decodeURIComponentà la lecture.
Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.