Passer au contenu principal
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 CMS Hub et de blog, mais pas dans les e-mails.

abs

Obtient la valeur absolue d’un nombre. Vous pouvez utiliser ce filtre pour vérifier qu’un nombre est positif.

add

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.

attr

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.

batch

Regroupe les éléments dans une séquence. Dans l’exemple ci-dessous, une variable contient une séquence de types de fruits. Le filtre batch 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).

between_times

Calcule le temps entre deux objets datetime dans une unité de temps indiquée.

Remarque:

vous devez uniquement utiliser ce filtre avec les variables qui renvoient une date. À compter du 30 septembre 2024, ce filtre ne renverra plus la date du jour lorsqu’une valeur nulle est transmise. Après cette date, une valeur nulle dans le filtre renverra la date 30 septembre 2024.

bool

Convertit une valeur de chaîne de texte en un booléen.

capitalize

Met 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.

center

Centre le texte dans une longueur de champ donnée à l’aide d’espaces. 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 ce filtre appliqué à une variable dans une pré-balise, de sorte que les espaces blancs ne sont pas supprimés.
| Paramètre | Type | Description | | --------- | ------ | ---------------------------------------------------------------------------- | ---------------------------------------------------------------------------- | | width | Nombre | Précise la longueur de l’espace blanc dans lequel le texte doit être centré. | Précise la longueur de l’espace blanc dans lequel le texte doit être centré. |

convert_rgb

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.

cut

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.

datetimeformat (obsolète)

Remarque:

Ce filtre est obsolète. Vous devrez plutôt utiliser le filtre format_datetime, qui utilise une syntaxe plus standardisée.

default

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.

dictsort

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.

difference

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.

divide

Divise la valeur actuelle par un diviseur. Le paramètre transmis est le diviseur. Ce filtre est une alternative à l’opérateur /.

divisible

Une alternative au test d’expression divisibleby, le filtre divisible sera évalué comme true si la valeur est divisible par le nombre donné.

escape_html

Échappe le contenu d’une entrée HTML. Accepte une chaîne et convertit les caractères &, <, >, , et escape_jinjava en séquences conformes à HTML. Utilisez ce filtre pour les variables HubL qui sont utilisées en HTML mais qui ne doivent autoriser aucun HTML.

escape_attr

Échappe le contenu d’une entrée d’attribut HTML. Accepte une chaîne et convertit les caractères &, <, , et escape_jinjava en séquences conformes à HTML. Utilisez ce filtre pour les variables HubL qui sont ajoutées aux attributs HTML. Notez que lorsque vous échappez des valeurs d’attributs qui acceptent les URL, telles que href, vous devez utiliser le filtre escape_url à la place.

escape_jinjava

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.

escape_js

Échappe les chaînes, notamment escape_jinjava, afin qu’elles puissent être insérées en toute sécurité dans une déclaration de variable JavaScript. Utilisez ce filtre pour les variables HubL utilisées dans les éléments de script HTML.

escape_url

Échappe le contenu d’une entrée d’URL, applique les protocoles spécifiés, supprime les caractères invalides et dangereux et code les entités HTML. Renvoie une valeur vierge si une URL est valide. Utilisez ce filtre pour les variables HubL qui sont utilisées dans les attributs HTML qui doivent être des URL valides.

escapejson

Échappe les chaînes de caractères afin qu’elles puissent être utilisées comme des valeurs JSON.

filesizeformat

Formate une valeur numérique dans une taille de fichier lisible par l’homme (c.-à-d. 13 kB, 4,1 Mo, 102 octets, etc.). Par défaut, les préfixes décimaux sont utilisés (par exemple, MB et GB), mais vous pouvez définir le paramètre binary sur true pour utiliser des préfixes binaires tels que Mebi (MiB) et Gibi (GiB).

first

Renvoie le premier élément d’une séquence.

float

Convertit 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.

forceescape

Applique 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.

format

Applique le formatage des chaînes Python à un objet. %s peut être remplacé par une autre variable.

format_currency (obsolète)

Remarque:

ce filtre est obsolète. Utilisez plutôt le filtre format_currency_value.

format_currency_value

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. Remplace le filtre obsolète format_currency.

format_date

Formate le composant de date d’un objet de date.

Remarque:

vous devez uniquement utiliser ce filtre avec les variables qui renvoient une date. À compter du 30 septembre 2024, ce filtre ne renverra plus la date du jour lorsqu’une valeur nulle est transmise. Après cette date, une valeur nulle dans le filtre renverra la date 30 septembre 2024.

format_datetime

Formate les composants de date et d’heure d’un objet de date. Ce filtre remplace le filtre obsolète datetimeformat. Par défaut, renvoie une date et une heure dans le fuseau horaire UTC-00:00.

Remarque:

vous devez uniquement utiliser ce filtre avec les variables qui renvoient une date. À compter du 30 septembre 2024, ce filtre ne renverra plus la date du jour lorsqu’une valeur nulle est transmise. Après cette date, une valeur nulle dans le filtre renverra la date 30 septembre 2024.

format_number

Formate un nombre donné en fonction d’un paramètre régional spécifié. Inclut un second paramètre qui définit la précision décimale maximale.

format_time

Formate le composant d’heure d’un objet de date.

Remarque:

vous devez uniquement utiliser ce filtre avec les variables qui renvoient une date. À compter du 30 septembre 2024, ce filtre ne renverra plus la date du jour lorsqu’une valeur nulle est transmise. Après cette date, une valeur nulle dans le filtre renverra la date 30 septembre 2024.

fromjson

Convertit une chaîne JSON en un objet.

geo_distance

Calcule la distance ellipsoïdale 2D entre deux points sur la Terre.

groupby

Regroupe une séquence d’objets selon un attribut commun. Le paramètre définit l’attribut commun pour le regroupement.

indent

Met en retrait le texte dans une longueur de champ donnée en utilisant les espaces. Ce filtre n’est pas recommandé et n’est pas particulièrement utile, car le compilateur HTML de HubSpot élimine automatiquement les espaces blancs. Toutefois, il est inclus ici par souci d’exhaustivité. L’exemple ci-dessous montre un filtre indent appliqué à une variable dans une balise <pre>, 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.

int

Convertit 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.

intersect

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.

ipaddr

Évalue comme true si la valeur est une adresse IPv4 ou IPv6 valide.

join

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.

last

Renvoie le dernier élément d’une séquence.

length

Renvoie le nombre d’éléments d’une séquence ou d’un mappage.

list

Convertit les valeurs en une liste. Les chaînes seront renvoyées sous forme de caractères distincts, sauf si elles sont contenues dans des délimiteurs de séquence entre crochets [ ].

log

Calcule le logarithme naturel d’un nombre.

lower

Convertit toutes les lettres d’une valeur en minuscules.

map

Applique un filtre sur une séquence d’objets ou recherche un attribut. C’est utile lorsque vous traitez une liste d’objets lorsque 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.

md5

Calcule le hachage md5 de l’objet donné

minus_time

Soustrait un nombre d’heures à partir d’un objet datetime.

multiply

Multiplie une valeur par un nombre. Fonctionne de la même manière que l’opérateur *.

plus_time

Ajoute un nombre d’heures à un objet datetime.

pprint

Impression d’une variable avec mise en forme. Ceci imprime le type de variable et d’autres informations utiles pour le débogage.

random

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.

regex_replace

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. Découvrez-en davantage sur la syntaxe des regex RE2.

reject

Filtre une séquence d’objets en appliquant un test d’expression à l’objet et en rejetant ceux dont le test a réussi.

rejectattr

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.

render

Rend les chaînes contenant HubL au début afin que la sortie puisse être transmise dans d’autres filtres.

replace

Remplace toutes les instances d’une sous-chaîne par une nouvelle.

reverse

Inverse l’objet ou renvoie un itérateur qui parcours dans l’autre sens. Pour inverser une liste, utilisez .reverse()

root

Calcule la racine carrée d’une valeur

round

Arrondit un nombre à une précision donnée.

safe

Marquer une valeur comme sûre, ce qui signifie que dans un environnement où l’échappement automatique est activé, cette variable ne sera pas échappée.

sanitize_html

Nettoie le contenu d’une entrée HTML pour la sortie de contenu en texte enrichi. Accepte une chaîne, puis supprime les balises HTML qui ne sont pas autorisées. Utilisez ce filtre pour les variables HubL utilisées en HTML qui devraient permettre un HTML sécurisé. Vous pouvez inclure les paramètres suivants pour autoriser des types spécifiques de balises HTML : FORMATTING, BLOCKS, STYLES, LINKS, TABLES. IMAGES. Par exemple : sanitize_html(IMAGES). L’utilisation de sanitize_html inclura tous les paramètres dans le filtre. Vous pouvez également inclure un paramètre STRIP pour supprimer tout le HTML. Tout le contenu est également exécuté via escape_jinjava pour empêcher l’interprétation imbriquée.

select

Filtre une séquence d’objets en appliquant un test aux objets et en ne sélectionnant que ceux dont le test a réussi.

selectattr

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.

shuffle

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.

slice

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.

sort

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.

split

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 restent groupés. Dans l’exemple ci-dessous, une chaîne de noms est séparée au niveau du ; pour les quatre premiers noms.

chaîne

Convertit un type de variable différent en une chaîne. Dans l’exemple ci-dessous, un entier est converti en chaîne (pprint est utilisé pour confirmer le changement de type de variable).

striptags

Efface les balises SGML/XML et remplace les espaces blancs adjacents par un espace. Ce filtre peut être utilisé pour supprimer toutes les balises HTML d’une variable.

strtodate

Convertit une chaîne de date et un format de date en un objet de date.

strtotime

Convertit une chaîne datetime et un format datetime en un objet datetime.

sum

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.

symmetric_difference

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.

title

Renvoie une version au format titre de la valeur (c’est-à-dire que les mots commencent par des lettres majuscules mais que tous les autres caractères sont des minuscules).

tojson

Écrit un objet sous forme de chaîne JSON.

trim

Supprime les espaces blancs de début et de fin. HubSpot supprime déjà les espaces blancs du balisage, mais ce filtre est documenté par souci d’exhaustivité.

truncate

Coupe le texte après un certain nombre de caractères. La valeur par défaut est 255. Les caractères HTML sont inclus dans ce décompte.
Remarque : comme ce filtre s’appuie sur les espaces entre les mots pour raccourcir les chaînes, il se peut qu’elle ne fonctionne pas comme prévu pour les langues sans espace entre caractères, comme le japonais.

truncatehtml

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.
Remarque : comme ce filtre s’appuie sur les espaces entre les mots pour raccourcir les chaînes, il se peut qu’elle ne fonctionne pas comme prévu pour les langues sans espace entre caractères, comme le japonais.

unescape_html

Convertit le texte avec des entités codées en HTML en leurs équivalents Unicode.

union

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.

unique

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.

unixtimestamp

Ce filtre convertit un objet datetime en un horodatage unix.

Remarque:

vous devez uniquement utiliser ce filtre avec les variables qui renvoient une date. À compter du 30 septembre 2024, ce filtre ne renverra plus la date du jour lorsqu’une valeur nulle est transmise. Après cette date, une valeur nulle dans le filtre renverra la date 30 septembre 2024.

upper

Convertit toutes les lettres d’une valeur en majuscules.

urlencode

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.

urldecode

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.

urlize

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.

wordcount

Compte le nombre de mots dans une chaîne.
Si la chaîne contient du HTML, utilisez le filtre striptags pour obtenir un compte précis.

wordwrap

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.

xmlattr

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.
Dernière modification le 10 février 2026