truncate

Tronque une variable à une certaine longueur, par défaut 80. Un second paramètre optionnel permet de spécifier une chaîne à afficher à la fin de la variable une fois tronquée. Les caractères de fin sont inclus dans la longueur de la chaîne à tronquer. Par défaut, truncate tentera de couper la chaîne à la fin d'un mot. Si vous voulez tronquer la chaîne au caractère exact, donnez la valeur true au dernier paramètre optionnel.

Position du paramètreTypeRequisDefautDescription
1entierNon80Le nombre de caractères maximums au-delà duquel on effectue le troncage
2chaîne de caractèreNon...Le texte qui remplace le texte tronqué. Sa longueur n'est PAS incluse dans la configuration de la longueur à tronquer.
3booléenNonfalseDétermine si le troncage est effectué sur le dernier mot (false), ou au caractère exact (true).
4booléenNonfalseCeci détermine si le troncage intervient à la fin de la chaîne (false), ou au milieu de la chaîne (true). Notez que si ceci vaut true, alors les limites de mots sont ignorées.

Exemple 5-20. truncate

<?php

$smarty
->assign('titreArticle''Deux soeurs réunies après 18 ans de séparation.');

?>

Où le template est :

{$titreArticle}
{$titreArticle|truncate}
{$titreArticle|truncate:30}
{$titreArticle|truncate:30:""}
{$titreArticle|truncate:30:"---"}
{$titreArticle|truncate:30:"":true}
{$titreArticle|truncate:30:"...":true}

Ce qui donne en sortie :

Deux soeurs réunies après 18 ans de séparation.
Deux soeurs réunies après...
Deux soeurs réunies après
Deux soeurs réunies après---
Deux soeurs réunies après 18 a
Deux soeurs réunies après 1...