Filtres HubL
Les filtres affectent le résultat final de votre HubL. Ils peuvent être appliqués à diverses annonces et expressions HubL pour modifier le balisage du modèle produit par le serveur.
La syntaxe de base d'un filtre est |filtername
. Le filtre est ajouté directement après l'annonce ou l'expression, à l'intérieur de ses séparateurs. Certains filtres ont des paramètres supplémentaires qui peuvent être ajoutés entre parenthèses. La syntaxe de base d'un filtre avec un paramètre de type chaîne, nombre et booléen est : |filtername("stringParameter", 10, true)
. Notez que les paramètres de type chaîne doivent être écrits entre guillemets. Notez également que les filtres HubL ont un alias qui peut être utilisé pour servir le même objectif que le filtre principal.
L'article suivant contient tous les filtres HubL pris en charge.
Remarque : Vous pouvez appliquer les filtres HubL aux jetons de personnalisation, tels que les jetons de contact et d'entreprise, sur les pages de HubSpot CMS et de blog, mais pas dans les e-mails.
Ajoute une valeur numérique à une autre valeur numérique. Ce filtre fonctionne de la même manière que l'opérateur +. Le paramètre entre parenthèses est l'addendum que vous combinez avec votre valeur numérique initiale.
Rend l'attribut d'un dictionnaire. Ce filtre est l'équivalent de l'impression d'une variable qui existe dans un dictionnaire, comme content.absolute_url.
Parameter | Description |
---|---|
attribute_name
Obligatoire
| Indique l'attribut à imprimer |
Un filtre de lot regroupe les éléments d'une séquence.
Parameter | Description |
---|---|
linecount
Obligatoire
| Le nombre d'éléments à inclure dans le lot |
fill_with
Facultatif
| Indique ce qu'il faut inclure pour compléter les éléments manquants |
Dans l'exemple ci-dessous, il existe une variable contenant une séquence de types de fruits. Le filtre de lot est appliqué à une boucle qui parcourt la séquence. La boucle imbriquée s'exécute trois fois pour imprimer 3 types de fruits par ligne, avant que la boucle externe ne s'exécute à nouveau. Remarquez dans la sortie finale, puisqu'il n'y a que 5 types de fruits, le dernier élément est remplacé par un   (le deuxième paramètre).
Calcule le temps entre deux objets datetime dans une unité de temps indiquée.
Parameter | Description |
---|---|
end
Obligatoire
| L'objet datetime de fin |
timeunit
Obligatoire
| Les unités de temps valides sont nanos , micros , millis , seconds , minutes , hours , half_days , days , weeks , months , years , decades , centuries , millennia , et eras . |
Mettez la première lettre d'une valeur variable en majuscule. Le premier caractère sera en majuscule, toutes les autres lettres seront en minuscules. Les mots suivants séparés par des espaces ou des traits d'union n'auront pas leur première lettre en majuscule.
Le filtre centre utilise les espaces blancs pour centrer le texte dans une longueur de champ donnée. Ce filtre n'est pas recommandé et n'est pas particulièrement utile, car le compilateur HTML de HubSpot élimine automatiquement les espaces blancs ; cependant, il est inclus ici par souci d'exhaustivité.
Parameter | Description |
---|---|
width
Obligatoire
| Précise la longueur de l'espace blanc dans lequel le texte doit être centré. |
L'exemple ci-dessous montre un filtre center appliqué à une variable dans une pré-balise, de sorte que les espaces blancs ne sont pas supprimés.
Convertit une valeur HEX en une chaîne RVB. C'est utile si vous devez convertir des variables de couleur en RVB pour les utiliser avec une déclaration CSS RVBA. Dans l'exemple ci-dessous, la valeur définie par un module de couleur est convertie en une valeur RVB et utilisée dans une déclaration CSS RVBA.
Supprime une chaîne d'une valeur. Ce filtre peut être utilisé pour faire correspondre et couper une partie spécifique d'une chaîne. Le paramètre indique la partie de la chaîne qui doit être supprimée. L'exemple ci-dessous supprime l'espace et le mot world de la valeur originale de la variable.
Parameter | Description |
---|---|
characters_to_cut
Obligatoire
| La partie de la chaîne qui doit être supprimée. |
Remarque :
- Ce filtre est obsolète. Vous devrez plutôt utiliser le filtre format_datetime, qui utilise une syntaxe plus standardisée.
- Il est fortement recommandé d'utiliser ce filtre uniquement avec les variables qui renvoient une date. Si une date n'est pas dépassée, le filtre sera utilisé à la date actuelle, ce qui peut entraîner l'affichage d'informations de date inexactes sur votre page.
Formate un objet datetime. Le filtre datetimeformat est utilisé pour convertir cet horodatage en une date et/ou une heure lisible. Les paramètres du filtre, énumérés dans le tableau ci-dessous, déterminent le rendu final de la variable temporelle.
Ce filtre attend un horodatage datetime. Si vos informations de date et d'heure sont dans un format différent, utilisez le filtre strtotime
pour formater les données en premier lieu.
Parameter | Description |
---|---|
format
Obligatoire
| Format de la directive pour l'objet datetime. Voir le tableau des directives sous l'exemple pour les valeurs. |
timezone
Facultatif
| Indique un fuseau horaire. Doit être dans un format Java 8 pris en charge. |
locale
Facultatif
| Indique un paramètre régional. Doit être dans un format Java 8 pris en charge. |
Directive | Exemple | Description |
---|---|---|
%a
| Sun, Mon, ..., Sat (en-US);So, Mo, ..., Sa (de-DE) | Le jour de la semaine comme nom abrégé du paramètre régional. |
%A
| Sunday, Monday, ..., Saturday (en-US);Sonntag, Montag, ..., Samstag (de-DE) | Le jour de la semaine comme nom complet du paramètre régional. |
%w
| 1, 2, ..., 7 | Jour de la semaine sous forme de nombre décimal, où 1 correspond au dimanche et 7 au samedi. |
%d
| 01, 02, ..., 31 | Le jour du mois sous la forme d'un nombre décimal complété par des zéros. |
%e
| 1, 2, ..., 31 | Le jour du mois sous la forme d'un nombre décimal, sans complément. |
%b
| Jan, Feb, ..., Dec (en-US);Jan, Feb, ..., Dez (de-DE) | Le mois comme nom abrégé du paramètre régional. |
%B
| January, February, ..., December (en-US);Januar, Februar, ..., Dezember (de-DE) | Le mois comme nom complet du paramètre régional. |
%OB
| 1月, 2月, ..., 12月 (ja) | Obtenir la version nominative du nom du mois. |
%m
| 01, 02, ..., 12 | Le mois sous la forme d'un nombre décimal complété par des zéros. |
%y
| 00, 01, ..., 99 | L'année sans le siècle sous la forme d'un nombre décimal complété par des zéros. |
%Y
| 1970, 1988, 2001, 2013 | L'année avec le siècle sous la forme d'un nombre décimal. |
%H
| 00, 01, ..., 23 | L'heure (horloge de 24 heures) sous la forme d'un nombre décimal complété par des zéros. |
%I
| 01, 02, ..., 12 | L'heure (horloge de 12 heures) sous la forme d'un nombre décimal complété par des zéros. |
%k
| 0, 1, ..., 24 | L'heure (horloge de 24 heures) sous la forme d'un nombre décimal (de 0 à 23) ; les chiffres uniques sont précédés d'un blanc. |
%l
| 1, 2, ..., 12 | (notez qu'il s'agit d'un L minuscule) L'heure (horloge de 12 heures) sous la forme d'un nombre décimal (de 1 à 12) ; les chiffres uniques sont précédés d'un blanc. |
%p
| AM, PM (en-US);am, pm (de-DE) | Le paramètre régional équivalent de AM ou PM. |
%M
| 00, 01, ..., 59 | Les minutes sous la forme d'un nombre décimal complété par des zéros. |
%S
| 00, 01, ..., 59 | Les secondes sous la forme d'un nombre décimal complété par des zéros. |
%f
| 000000, 000001, ..., 999999 | Les microsecondes sous forme d'un nombre décimal, avec un décalage de zéro sur la gauche. |
%z
| (empty), +0000, -0400, +1030 | Décalage UTC sous la forme +HHMM ou -HHMM (chaîne vide si l'objet est naïf). |
%Z
| (empty), UTC, EST, CST | Nom du fuseau horaire (chaîne vide si l'objet est naïf). |
%j
| 001, 002, ..., 366 | Le jour de l'année sous la forme d'un nombre décimal complété par des zéros. |
%U
| 00, 01, ..., 53 | Numéro de la semaine de l'année (le dimanche étant le premier jour de la semaine) sous la forme d'un nombre décimal complété par des zéros. Tous les jours d'une nouvelle année précédant le premier dimanche sont considérés comme faisant partie de la semaine 0. |
%W
| 00, 01, ..., 53 | Numéro de semaine de l'année (le lundi étant le premier jour de la semaine) sous forme de nombre décimal. Tous les jours d'une nouvelle année précédant le premier lundi sont considérés comme faisant partie de la semaine 0. |
%c
| Tue Aug 16 21:30:00 1988 (en-US);Di 16 Aug 21:30:00 1988 (de-DE) | Représentation pertinente de la date et de l'heure du paramètre régional. |
%x
| 08/16/88 (None);08/16/1988 (en-US);16.08.1988 (de-DE) | Représentation pertinente de la date du paramètre régional. |
%X
| 21:30:00 (en-US);21:30:00 (de-DE) | Représentation pertinente de l'heure du paramètre régional. |
%%
| % | Un caractère |
Si la valeur est indéfinie, elle renverra le premier paramètre, sinon la valeur de la variable sera imprimée. Si vous voulez utiliser la valeur par défaut avec des variables qui s'évaluent comme false, vous devez définir le deuxième paramètre sur true. Le premier exemple ci-dessous imprime le message si la variable n'est pas définie. Le deuxième exemple applique le filtre à une chaîne vide, qui n'est pas indéfinie, mais il imprime un message à cause du deuxième paramètre.
Parameter | Description |
---|---|
default_variable
Obligatoire
| Valeur à renvoyer si la variable est indéfinie. Si la variable est définie, la valeur de la variable sera renvoyée à la place. |
boolean
Facultatif
| Renvoie default_value si la variable est une chaîne vide |
Trie un dictionnaire et donne des paires (clé, valeur). Les dictionnaires ne sont pas triés par défaut, mais vous pouvez imprimer un dictionnaire, trié par clé ou par valeur. Le premier paramètre est un booléen qui détermine si le tri prend en compte la casse ou non. Le deuxième paramètre détermine si le dictionnaire doit être trié par clé ou par valeur. L'exemple ci-dessous imprime un dictionnaire de contacts trié, avec tous les détails connus sur le contact.
Parameter | Description |
---|---|
case_sensitive
Obligatoire
| Détermine si le tri prend en compte la casse |
sort_by
Obligatoire
| Détermine si le tri doit se faire par key ou par value |
Ce filtre renvoie la différence de deux ensembles ou listes. La liste renvoyée par le filtre contient tous les éléments uniques qui se trouvent dans la première liste, mais pas dans la seconde.
Parameter | Description |
---|---|
list
Obligatoire
| La deuxième liste à comparer pour trouver les différences par rapport à la liste originale. |
Une alternative au test d'expression divisibleby, le filtre divisible sera évalué comme true si la valeur est divisible par le nombre donné.
Parameter | Description |
---|---|
divisor
Obligatoire
| Le nombre à utiliser pour évaluer si la valeur est divisible. |
Convertit les caractères &, <, >, ‘, et ” de la chaîne en séquences conformes à HTML. Utilisez cette option si vous devez afficher un texte susceptible de contenir de tels caractères en HTML. Marque la valeur de renvoi comme une chaîne de balisage.
Convertit les caractères {
et }
de la chaîne en séquences conformes à Jinjava. Utilisez ce filtre si vous devez afficher un texte susceptible de contenir de tels caractères dans Jinjava. Marque la valeur de renvoi comme une chaîne de balisage.
Échappe les chaînes afin qu'elles puissent être insérées en toute sécurité dans une déclaration de variable JavaScript.
Formate la valeur comme une taille de fichier « lisible par l'homme » (c'est-à-dire 13 ko, 4,1 Mo, 102 octets, etc.). Par défaut, les préfixes décimaux sont utilisés (Mega, Giga, etc.), si le paramètre est défini sur True, les préfixes binaires sont utilisés (Mebi, Gibi).
Parameter | Description |
---|---|
boolean
Facultatif
| S'il est défini sur true, des préfixes binaires sont utilisés tels que Mebi et Gibi. |
Convertir la valeur en un nombre à virgule flottante. Si la conversion ne fonctionne pas, elle renvoie 0.0. Vous pouvez remplacer cette valeur par défaut en utilisant le premier paramètre.
Parameter | Description |
---|---|
default
Facultatif
| Nombre entier à renvoyer si la conversion ne fonctionne pas. |
Appliquer strictement l'échappement HTML. Dans l'environnement de HubSpot, il n'y a pas vraiment de cas d'utilisation pour l'échappement double, donc cette option se comporte généralement de la même manière que le filtre escape.
Formate un nombre donné sous forme de devise en fonction de la devise par défaut du portail et du paramètre régional transmis sous forme de paramètre.
Parameter | Description |
---|---|
locale
Facultatif
| La balise du langage local Java. Les paramètres régionaux de la page constituent la valeur par défaut. Format : ISO639LanguageCodeInLowercase-ISO3166CountryCodeInUppercase |
currency_code
Facultatif
| le code ISO 4217 de la devise, la valeur par défaut est la devise par défaut du portail. |
use_default_decimal_digits
Facultatif
| un booléen qui détermine si le dispositif de mise en forme doit utiliser les chiffres décimaux par défaut du code de la devise. La valeur par défaut est false. |
Parameter | Description |
---|---|
format
Facultatif
| Le format à utiliser. Peut être l'un des éléments suivants :
|
timeZone
Facultatif
| Le fuseau horaire de la date de sortie au format IANA TZDB. |
locale
Facultatif
| Les paramètres régionaux à utiliser pour les formats reposant sur des paramètres régionaux. |
Parameter | Description |
---|---|
format
Facultatif
| Le format à utiliser. Peut être l'un des éléments suivants :
En cas d'utilisation de |
timeZone
Facultatif
| Le fuseau horaire de la date de sortie au format IANA TZDB. Par défaut, renvoie l'heure UTC. |
locale
Facultatif
| Les paramètres régionaux à utiliser pour les formats reposant sur des paramètres régionaux. |
Parameter | Description |
---|---|
format
Facultatif
| Le format à utiliser. Peut être l'un des éléments suivants :
|
timeZone
Facultatif
| Le fuseau horaire de la date de sortie au format IANA TZDB. |
locale
Facultatif
| Les paramètres régionaux à utiliser pour les formats reposant sur des paramètres régionaux. |
Le filtre groupby regroupe une séquence d'objets selon un attribut commun. Le paramètre définit l'attribut commun pour le regroupement.
Parameter | Description |
---|---|
attribute
Obligatoire
| L'attribut à utiliser pour le regroupement. |
Le filtre indent utilise les espaces blancs pour indenter le texte dans une longueur de champ donnée. Ce filtre n'est pas recommandé et n'est pas particulièrement utile, car le compilateur HTML de HubSpot élimine automatiquement les espaces blancs ; cependant, il est inclus ici par souci d'exhaustivité. L'exemple ci-dessous montre un filtre center appliqué à une variable dans une pré-balise, de sorte que les espaces blancs ne sont pas supprimés. Le premier paramètre contrôle la quantité d'espaces blancs et le second booléen permet d'indenter ou non la première ligne.
Parameter | Description |
---|---|
width
Obligatoire
| La quantité d'espaces blancs à appliquer. |
boolean
Obligatoire
| Une valeur booléenne indiquant si la première ligne doit être indentée. |
Convertir la valeur en un nombre entier. Si la conversion ne fonctionne pas, elle renvoie 0. Vous pouvez remplacer cette valeur par défaut en utilisant le premier paramètre.
Parameter | Description |
---|---|
default
Obligatoire
| Nombre entier à renvoyer si la conversion ne fonctionne pas. |
Ce filtre renvoie l'intersection de deux ensembles ou listes. La liste renvoyée par le filtre contient tous les éléments uniques qui sont contenus dans les deux listes.
Parameter | Description |
---|---|
list
Obligatoire
| La deuxième liste à comparer pour trouver l'intersection de la liste avec la liste originale. |
Renvoie une chaîne qui est la concaténation des chaînes de la séquence. Le séparateur entre les éléments est une chaîne vide par défaut, vous pouvez le définir avec le paramètre facultatif. Le deuxième paramètre peut être utilisé pour indiquer un attribut à joindre.
Parameter | Type | Description |
---|---|---|
delimiter
Facultatif
| Chaîne | Le délimiteur à utiliser lors de la concaténation de chaînes. |
attribute
Facultatif
| Variable HubL | Attribut de valeur à joindre à un objet. |
Convertit les valeurs numériques en une liste. S'il s'agit d'une chaîne, la liste renvoyée sera une liste de caractères. Pour ajouter des chaînes à une séquence, il suffit de les ajouter aux variables de chaîne des délimiteurs de séquence [ ].
Applique un filtre sur une séquence d'objets ou recherche un attribut. C'est utile lorsque vous traitez des listes d'objets, mais que vous n'êtes réellement intéressé que par une certaine valeur de celle-ci.
L'utilisation de base est le mappage d'un attribut. Par exemple, si vous voulez utiliser la logique conditionnelle pour vérifier si une valeur est présente dans un attribut particulier d'un dictionnaire. Vous pouvez également le laisser utiliser un filtre en transmettant le nom du filtre et les arguments après.
Parameter | Description |
---|---|
attribute
| Attribut à renvoyer dans la séquence d'objets. |
filter
| Filtre à appliquer à la séquence d'objets. |
Calcule le hachage md5 de l'objet donné
Soustrait un nombre d'heures à un objet datetime.
Parameter | Description |
---|---|
diff
Obligatoire
| Montant à soustraire. |
timeunit
Obligatoire
| Les unités de temps valides sont nanos , micros , millis , seconds , minutes , hours , half_days , days , weeks , months , years , decades , centuries , millennia , et eras . |
Multiplie une valeur par un nombre. Fonctionne de la même manière que l'opérateur *.
Ajoute un nombre d'heures à un objet datetime.
Parameter | Description |
---|---|
diff
Obligatoire
| Montant à ajouter. |
timeunit
Obligatoire
| Les unités de temps valides sont nanos , micros , millis , seconds , minutes , hours , half_days , days , weeks , months , years , decades , centuries , millennia , et eras . |
Renvoie un élément aléatoire de la séquence.
Remarque : Si vous utilisez ce filtre, la page sera pré-rendue périodiquement et non pas chaque fois que le contenu de la page est mis à jour. Cela signifie que le contenu filtré ne sera pas mis à jour à chaque rechargement de page.
Cela peut ne pas être un problème pour certains types de contenu, tels que l'affichage d'une liste aléatoire d'articles de blog. Cependant, si vous souhaitez que le contenu change aléatoirement à chaque chargement de page, vous devez plutôt utiliser JavaScript pour rendre aléatoire le contenu côté client.
Recherche un motif regex et le remplace par une séquence de caractères. Le premier argument est un motif regex de style RE2, le second est la chaîne de remplacement.
Des informations sur la syntaxe des regex RE2 sont disponibles ici.
Filtre une séquence d'objets en appliquant un test d'expression à l'objet et en rejetant ceux dont le test a réussi.
Parameter | Description |
---|---|
exp_text
| Le test d'expression à appliquer à l'objet. |
Filtre une séquence d'objets en appliquant un test à l'attribut d'un objet et en rejetant ceux dont le test a réussi.
Parameter | Description |
---|---|
attribute_name
Obligatoire
| Indique l'attribut à sélectionner. Vous pouvez accéder aux attributs imbriqués en utilisant la notation par points. |
exp_test
Facultatif
| L'expression à tester |
val
Facultatif
| Valeur à tester. |
Remplace toutes les instances d'une sous-chaîne par une nouvelle.
Parameter | Description |
---|---|
old
Obligatoire
| La sous-chaîne qui doit être remplacée. |
new
Obligatoire
| Chaîne de remplacement. |
count
Facultatif
| Si elle est fournie, seules les occurrences du premier décompte sont remplacées. |
Inverse l'objet ou renvoie un itérateur qui parcours dans l'autre sens. Pour inverser une liste, utilisez .reverse()
Arrondit le nombre à une précision donnée.
Parameter | Description |
---|---|
precision
Facultatif
| Indique la précision de l'arrondi. |
rounding_method
Facultatif
| Les options sont : common arrondit vers le haut ou vers le bas (par défaut) ; ceil arrondit toujours vers le haut ; floor arrondit toujours vers le bas. Si vous n'indiquez pas de méthode, la méthode common est utilisée. |
Filtre une séquence d'objets en appliquant un test à un attribut d'un objet et en ne sélectionnant que ceux dont le test a réussi.
Parameter | Description |
---|---|
attribute_name
Obligatoire
| Indique l'attribut à sélectionner. Vous pouvez accéder aux attributs imbriqués en utilisant la notation par points. |
exp_test
Facultatif
| L'expression à tester |
val
Facultatif
| Valeur à tester. |
Rend aléatoire l'ordre d'itération d'une séquence. L'exemple ci-dessous mélange une boucle de blog standard.
Remarque : Si vous utilisez ce filtre, la page sera pré-rendue périodiquement et non pas chaque fois que le contenu de la page est mis à jour. Cela signifie que le contenu filtré ne sera pas mis à jour à chaque rechargement de page.
Cela peut ne pas être un problème pour certains types de contenu, tels que l'affichage d'une liste aléatoire d'articles de blog. Cependant, si vous souhaitez que le contenu change aléatoirement à chaque chargement de page, vous devez plutôt utiliser JavaScript pour rendre aléatoire le contenu côté client.
Découpe un itérateur et renvoie une liste de listes contenant ces éléments. Le premier paramètre indique le nombre d'éléments qui seront découpés, et le second paramètre indique les caractères à utiliser pour remplir les tranches vides.
Parameter | Description |
---|---|
slices
Obligatoire
| Combien d'éléments seront découpés. |
filler
Obligatoire
| Indique les caractères à utiliser pour remplir les tranches vides. |
Trie une table itérative. Ce filtre nécessite que tous les paramètres soient triés en utilisant un attribut dans HubSpot. Le premier paramètre est un booléen pour inverser l'ordre de tri. Le deuxième paramètre détermine si le tri prend en compte la casse. Et le dernier paramètre indique l'attribut à utiliser pour le tri. Dans l'exemple ci-dessous, les articles d'un blog sont rendus et classés par ordre alphabétique de leur nom.
Parameter | Description |
---|---|
reverse
Obligatoire
| Valeur booléenne permettant d'inverser l'ordre de tri. |
case_sensitive
Obligatoire
| Valeur booléenne qui détermine si le tri prend en compte la casse. |
attribute
Obligatoire
| Attribut à utiliser pour le tri. Omettre lors du tri d'une liste. |
Divise la chaîne d'entrée en une liste selon le séparateur donné. Le premier paramètre indique le séparateur avec lequel la variable doit être divisée. Le deuxième paramètre détermine combien de fois la variable doit être divisée. Tous les autres éléments resteraient groupés. Dans l'exemple ci-dessous, une chaîne de noms est séparée au niveau du « ; » pour les 4 premiers noms.
Parameter | Description |
---|---|
character_to_split_by
Obligatoire
| Indique le séparateur avec lequel la variable doit être divisée. |
number_of_splits
Facultatif
| Détermine le nombre de fois que la variable doit être divisée. Tous les autres éléments resteraient groupés. |
Convertit une chaîne datetime et un format datetime en un objet datetime.
Parameter | Description |
---|---|
datetimeFormat
Obligatoire
|
Ajoute des valeurs numériques dans une séquence. Le premier paramètre peut indiquer un attribut facultatif et le second paramètre définit une valeur à renvoyer s'il n'y a rien dans la variable à additionner.
Parameter | Description |
---|---|
attribute
Facultatif
| Attribut à additionner. |
return_if_nothing
Facultatif
| Valeur à renvoyer s'il n'y a rien dans la variable à additionner. |
Ce filtre renvoie la différence symétrique de deux ensembles ou listes. La liste renvoyée par le filtre contient tous les éléments uniques qui figurent dans la première liste, mais pas dans la seconde, ou qui figurent dans la seconde liste, mais pas dans la première.
Parameter | Description |
---|---|
list
Obligatoire
| La deuxième liste à comparer pour trouver la différence symétrique avec la liste originale. |
Renvoie une version titlecased de la valeur. C'est-à-dire que les mots commencent par des lettres majuscules, tous les autres caractères sont des minuscules.
Écrit un objet sous forme de chaîne JSON.
Coupe le texte après un certain nombre de caractères. La valeur par défaut est 255. Veuillez noter que les caractères HTML sont inclus dans ce décompte. La longueur est indiquée avec le premier paramètre qui a la valeur 255 par défaut. Si le deuxième paramètre est true, le filtre coupera le texte en longueur. Sinon, le dernier mot est rejeté. Si le texte a été tronqué, il ajoutera un signe d'ellipse (« ... »). Si vous souhaitez un autre signe d'ellipse que « ... », vous pouvez l'indiquer en utilisant le troisième paramètre.
Parameter | Description |
---|---|
number_of_characters
Obligatoire
| Nombre de caractères après lesquels le texte doit être tronqué. La valeur par défaut est 255. |
breakword
Facultatif
| Valeur booléenne. Si sur true, le filtre coupe le texte en longueur. Si sur false, le dernier mot est supprimé. |
end
Facultatif
| Remplace les caractères de fin par « ... » par défaut après la troncature. |
Tronque une chaîne donnée, en respectant le balisage html (c'est-à-dire qu'il fermera correctement toutes les balises imbriquées). Cela empêchera une balise de rester ouverte après la troncature. Les caractères HTML ne sont pas pris en compte dans le total des caractères. Ce filtre a un paramètre de longueur et un paramètre de symbole de troncature. Il existe un troisième paramètre booléen qui indique si les mots seront cassés en longueur. Ce paramètre est faux par défaut afin de préserver la longueur des mots. Si vous n'utilisez qu'un seul des paramètres facultatifs, utilisez des arguments de type mot-clé, comme truncatehtml(70, breakwords = false).
Parameter | Description |
---|---|
number_of_characters
Obligatoire
| Nombre de caractères après lesquels le texte doit être tronqué. La valeur par défaut est 255. |
end
Facultatif
| Remplace les caractères de fin par « ... » par défaut après la troncature. |
breakword
Facultatif
| Valeur booléenne. Si sur true, le filtre coupe le texte en longueur. Si sur false, le dernier mot est supprimé. |
Ce filtre renvoie l'union de deux ensembles ou listes. La liste renvoyée par le filtre contient tous les éléments uniques qui se trouvent dans l'une ou l'autre des listes.
Parameter | Description |
---|---|
list
Obligatoire
| La deuxième liste à joindre à la liste originale. |
Ce filtre extrait un ensemble unique d'une séquence ou d'un dictionnaire d'objets. Lors du filtrage d'un dictionnaire, tel qu'une liste d'articles renvoyée par une fonction, vous pouvez indiquer quel attribut est utilisé pour dédupliquer les éléments du dictionnaire.
Parameter | Description |
---|---|
attr
Facultatif
| Indique l'attribut qui doit être utilisé lors du filtrage d'une valeur dictionnaire |
Ce filtre convertit un objet datetime en un horodatage unix.
Quitte et encode l'URL d'une chaîne utilisant le formatage UTF-8. Accepte à la fois les dictionnaires et les chaînes régulières ainsi que les itérables par paire.
Décode les chaînes d'URL encodées vers l'URL d'origine. Accepte à la fois les dictionnaires et les chaînes régulières ainsi que les itérables par paire.
Convertit les URL en texte brut en liens cliquables. Si vous transmettez au filtre un nombre entier supplémentaire, il raccourcira les URL à ce nombre. Le deuxième paramètre est un booléen qui indique si le lien est rel="no follow". Le dernier paramètre vous permet de préciser si le lien s'ouvrira dans un nouvel onglet.
Parameter | Description |
---|---|
shorten_text
Facultatif
| Nombre entier qui raccourcira les URL au nombre désiré. |
no_follow
Facultatif
| Valeur booléenne indiquant si le lien est rel="no follow". |
target="_blank"
Facultatif
| Indique si le lien s'ouvrira dans un nouvel onglet. |
Provoque le retour à la ligne des mots après un nombre de caractères donné. Cela fonctionne mieux dans un <pre> car HubSpot supprime les espaces blancs par défaut.
Parameter | Description |
---|---|
character_count
Obligatoire
| Nombre de caractères avec le retour à la ligne du contenu. |
Crée une chaîne d'attributs HTML/XML, basée sur les éléments d'un dictionnaire. Toutes les valeurs qui ne sont ni nulles,
ni indéfinies sont automatiquement échappées. Il ajoute automatiquement un espace devant l'élément si le filtre renvoie quelque chose, sauf si le premier paramètre est false.
Parameter | Description |
---|---|
autospace
Obligatoire
| Valeur booléenne qui ajoutera automatiquement un espace devant l'élément, sauf si elle est définie sur false. |
Merci d'avoir partagé votre avis.