path

Syntaxe

Paramètres

Description

Ce filtre permet d'extraire le chemin (path) d'une URL (hors paramètres et hôte).

Remarques

• Permet d'isoler le segment de chemin dans une URL complète : Le filtre path est particulièrement utile pour extraire uniquement la partie située après le nom d'hôte et avant les éventuels paramètres (?) ou fragments (#). Cela permet par exemple de travailler uniquement avec le chemin logique d'une ressource, indépendamment du domaine.
• Utile pour la mise en correspondance d'URL avec des routes personnalisées : En extrayant le chemin, ce filtre facilite la comparaison ou le routage conditionnel dans les modèles Liquid. Par exemple, on peut afficher certains contenus uniquement si l'utilisateur se trouve à un chemin spécifique du site.
• Ignore automatiquement les paramètres de requête et les ancres : Les parties d'URL comme ?id=123 ou #section1 sont exclues du résultat, ce qui évite d'avoir à les nettoyer manuellement. Cela garantit une chaîne propre et prévisible représentant uniquement la structure hiérarchique de la page.
• Compatible avec des URL internes comme externes : Que l'on fournisse une URL relative (/produits/chaussures) ou complète (https://site.com/produits/chaussures?ref=abc), le filtre path extrait systématiquement le chemin cohérent (/produits/chaussures), ce qui le rend robuste dans des scénarios mixtes.
• Idéal pour créer des conditions d'affichage en fonction du chemin courant : Combiné avec l'objet request, ce filtre permet de faire des vérifications telles que :
1. {% if request.url | path == "/contact" %}

Cela rend possible l'affichage dynamique de blocs spécifiques selon le contexte de navigation.

• Ne modifie pas la casse ou l'encodage des caractères : Le chemin extrait reste identique à celui présent dans l'URL, y compris les majuscules, tirets, accents encodés (%20,...). Cela exige une certaine vigilance si on compare manuellement les valeurs extraites.
• Pratique pour générer des breadcrumbs ou navigations secondaires : Avec le chemin, on peut facilement segmenter et construire une navigation hiérarchique, par exemple en divisant /produits/chaussures/sport en plusieurs niveaux pour créer un fil d'Ariane ou une navigation latérale.
• Peut être combiné à des filtres supplémentaires pour un traitement plus avancé : Le chemin extrait peut être ensuite manipulé avec des filtres comme split ou replace pour personnaliser son affichage ou effectuer des traitements selon les segments de l'URL (exemple : identifier la section ou la catégorie).