truncate_words

Syntaxe

Paramètres

Description

Ce filtre permet de tronquer un texte au nombre de mots précisé, en ajoutant une fin (par exemple '...').

Remarques

• Préserve l'intégrité des mots : Contrairement au filtre truncate coupant selon un nombre de caractères, truncate_words respecte les mots complets. Cela permet de préserver la lisibilité du texte tronqué, en évitant des coupures inesthétiques en plein milieu d'un mot.
• Idéal pour les extraits d'articles ou de descriptions : Ce filtre est très utile pour générer des résumés ou des aperçus automatiques dans les blogs, actualités ou listes d'objets. Il permet de présenter un nombre fixe de mots, ce qui est souvent plus pertinent qu'une troncature en caractères dans un contexte éditorial.
• Comporte une chaîne de fin facultative : On peut ajouter une chaîne personnalisée à la fin du texte tronqué, comme "...", " [lire plus]", ou tout autre indicateur. Cette fonctionnalité est précieuse pour signaler visuellement à l'utilisateur qu'il ne voit qu'un extrait du contenu complet.
• Fonctionne même si le texte est plus court que la limite : Si la chaîne contient moins de mots que la limite spécifiée, alors le filtre renvoie le texte original sans modification. Cela permet une application sûre, sans risque de suppression injustifiée d'informations.
• Souvent utilisé avec des filtres de nettoyage : Avant d'utiliser truncate_words, il est judicieux de combiner ce filtre avec strip_html pour supprimer les balises HTML, ou strip_newlines pour supprimer les retours à la ligne. Cela garantit une troncature plus propre et sans artefacts visuels ou techniques.
• Ne gère pas la ponctuation comme des mots : Le filtre se base sur les espaces pour découper les mots, ce qui signifie que les signes de ponctuation (comme ".", ",", ";") ne sont pas considérés comme des mots à part entière. Cela assure une coupe fidèle au langage naturel, bien qu'il faille rester attentif à certains cas limites.
• Utile dans les interfaces responsives : Dans un contexte de design adaptatif (responsive), il est important de contrôler la densité de contenu dans des zones limitées. truncate_words est alors un excellent outil pour afficher un extrait de taille contrôlée, quel que soit le format de l'écran.
• Améliore l'UX sans nécessiter de logique complexe : Ce filtre offre une solution simple et rapide pour limiter dynamiquement la longueur d'un texte sans passer par une logique JavaScript ou une manipulation serveur. Il est donc idéal dans des environnements comme Power Pages ou dans des listes dynamiques où la logique doit rester dans Liquid.