#ctx.location

Informations sur l'emplacement de la route actuelle, équivalent à l'objet location de React Router. Il est généralement utilisé en conjonction avec ctx.router et ctx.route pour lire le chemin actuel, la chaîne de requête (query string), le hash et l'état (state) transmis via la route.

#Scénarios d'utilisation

Remarque : ctx.location est uniquement disponible dans les environnements RunJS disposant d'un contexte de routage (par exemple, JSBlock dans une page, flux d'événements, etc.) ; il peut être nul dans des contextes purement backend ou sans routage (comme les flux de travail).

#Définition du type

location: Location;

Location provient de react-router-dom, conformément à la valeur de retour de useLocation() de React Router.

#Champs courants

#Relation avec ctx.router et ctx.urlSearchParams

ctx.urlSearchParams est analysé à partir de ctx.location.search. Si vous avez seulement besoin des paramètres de requête, l'utilisation de ctx.urlSearchParams est plus pratique.

#Exemples

#Branchement basé sur le chemin

if (ctx.location.pathname.startsWith('/admin/users')) {
  ctx.message.info('Actuellement sur la page de gestion des utilisateurs');
}

#Analyse des paramètres de requête

// Méthode 1 : Utilisation de ctx.urlSearchParams (Recommandé)
const page = ctx.urlSearchParams.page || 1;
const status = ctx.urlSearchParams.status;

// Méthode 2 : Utilisation de URLSearchParams pour analyser search
const params = new URLSearchParams(ctx.location.search);
const page = params.get('page') || '1';
const status = params.get('status');

#Réception de l'état transmis via la navigation

// Lors de la navigation depuis la page précédente : ctx.router.navigate('/users/123', { state: { from: 'dashboard' } })
const prevState = ctx.location.state;
if (prevState?.from === 'dashboard') {
  ctx.message.info('Navigué depuis le tableau de bord');
}

#Localisation d'ancres via le hash

const hash = ctx.location.hash; // ex : "#edit"
if (hash === '#edit') {
  // Faire défiler jusqu'à la zone d'édition ou exécuter la logique correspondante
}

#Relatif

• ctx.router : Navigation de route ; le state de ctx.router.navigate peut être récupéré via ctx.location.state sur la page cible.
• ctx.route : Informations de correspondance de la route actuelle (paramètres, configuration, etc.), souvent utilisées en conjonction avec ctx.location.