truncate

Syntaxe

Paramètres

Description

Ce filtre permet de tronquer une chaîne à une longueur spécifiée et ajouter une indication (par exemple '...').

Remarques

• Contrôle de la longueur de sortie : Le filtre truncate est idéal pour limiter l'affichage de textes longs dans les interfaces web. Il permet de spécifier une longueur maximale, ce qui est utile pour conserver une mise en page propre et homogène, notamment dans les aperçus, les titres ou les résumés.
• Inclut la chaîne de fin dans la longueur totale : La longueur définie avec truncate inclut la chaîne de fin (comme "...") dans le décompte total. Par exemple, si la longueur spécifiée est 10 et que la chaîne de fin est "...", seulement 7 caractères réels seront conservés du texte original. Cela nécessite une attention particulière lors du calcul.
• Personnalisation du suffixe de coupure : Par défaut, la chaîne de fin est souvent "...", mais elle peut être remplacée par n'importe quel texte court, comme "~", "***", ou même vide (""). Cela permet une personnalisation fine selon le style visuel ou l'espace disponible.
• Utile pour améliorer l'expérience utilisateur : En affichant des contenus tronqués dans des blocs limités (cartes, tableaux, boutons), le filtre contribue à éviter la surcharge visuelle. Il offre également une méthode simple pour gérer le texte dans des contextes responsive ou sur des écrans de petite taille.
• N'affecte pas les chaînes déjà plus courtes que la limite : Le filtre est non destructif si la chaîne est déjà plus courte que la limite indiquée. Dans ce cas, elle est simplement renvoyée sans modification, ce qui évite les effets de troncature inutile.
• Peut être combiné avec strip_html ou strip_newlines : Pour s'assurer d'une troncature propre et sans artefacts visuels, truncate est souvent combiné à d'autres filtres comme strip_html (pour supprimer les balises) ou strip_newlines (pour retirer les sauts de ligne), afin de préparer le texte avant sa réduction.
• Peut être appliqué à des titres, commentaires, descriptions,... : Ce filtre est particulièrement utile dans les cas d'aperçus automatiques, comme un champ de description dans un résumé d'article ou une étiquette de carte. Il aide à générer des extraits cohérents, sans rompre complètement la logique de lecture.
• Ne coupe pas intelligemment sur des mots : Le filtre truncate effectue une coupure brute selon le nombre de caractères, sans prendre en compte les mots entiers. Il peut donc couper au milieu d'un mot, ce qui peut gêner la lisibilité si l'on ne choisit pas une taille de coupure adaptée ou si l'on n'utilise pas un suffixe visuellement clair.