markup is printed as text" %}
| {{ column }} | {% endfor %}
| apples | oranges | pears |
| grapes | blueberries |
{% set var = "string to center" %}
before{{ var|center(80) }}after
```
```html example.html theme={null}
before string to center after```
`, 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.```html example.html theme={null} | Paramètre | Type | Description | | -------------- | ------- | ------------------------------------------------------------------------------------ | | `width` | Nombre | La quantité d'espaces blancs à appliquer. | | `indent-first` | Booléen | Lorsque cette option est définie sur `true`, la première ligne sera mise en retrait. | ## 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.{% set var = "string to indent" %} {{ var|indent(2, true) }}``` ```text sortie rendue.txt theme={null} string to indent ``````text hubl.txt theme={null} {% set string="25" %} {{ string|int + 17 }} ``` ```text sortie rendue.txt theme={null} 42 ``` | Paramètre | Type | Description | | --------- | ------ | ------------------------------------------------------------ | | `default` | Nombre | Nombre entier à renvoyer si la conversion ne fonctionne pas. | ## 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.```text hubl.txt theme={null} {{ [1, 2, 3]|intersect([2, 3, 4, 5]) }} ``` ```text sortie rendue.txt theme={null} [2, 3] ``` | Paramètre | Type | Description | | --------- | ------- | --------------------------------------------------------------------------------------------- | | `list` | Tableau | La deuxième liste à comparer pour trouver l'intersection de la liste avec la liste originale. | ## ipaddr Évalue comme `true` si la valeur est une adresse IPv4 ou IPv6 valide.```text hubl.txt theme={null} {% set ip = "1.0.0.1" %} {% if ip|ipaddr %} The string is a valid IP address {% endif %} ``` ```text sortie rendue.txt theme={null} The string is a valid IP address ``` ## 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.```text hubl.txt theme={null} {% set my_list = [1, 2, 3] %} {% set sep = "---" %} {{ my_list|join }} {{ my_list|join("|") }} {{ my_list|join(sep) }} ``` ```text sortie rendue.txt theme={null} 123 1|2|3 1---2---3 ``` | Paramètre | Type | Description | | ----------- | ------------- | ------------------------------------------------------------- | | `delimiter` | Chaîne | Le délimiteur à utiliser lors de la concaténation de chaînes. | | `attribute` | Variable HubL | Attribut de valeur à joindre à un objet. | ## last Renvoie le dernier élément d'une séquence.```text hubl.txt theme={null} {% set my_sequence = ["Item 1", "Item 2", "Item 3"] %} {% my_sequence|last %} ``` ```text sortie rendue.txt theme={null} Item 3 ``` ## length Renvoie le nombre d'éléments d'une séquence ou d'un mappage.```text hubl.txt theme={null} {% set services = ["Web design", "SEO", "Inbound Marketing", "PPC"] %} {{ services|length }} ``` ```text sortie rendue.txt theme={null} 4 ``` ## 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 `[ ]`.```text hubl.txt theme={null} {% set one = 1 %} {% set two = 2 %} {% set three = "three" %} {% set four = ["four"] %} {% set list_num = one|list + two|list + three|list + four|list %} {{ list_num }} ``` ```text sortie rendue.txt theme={null} [1, 2, t, h, r, e, e, four] ``` ## log Calcule le logarithme naturel d'un nombre.```text hubl.txt theme={null} {{ 10|log }} {{ 65536|log(2) }} ``` ```text sortie rendue.txt theme={null} 2.302585092994046 16.0 ``` | Paramètre | Type | Description | | --------- | ------ | --------------------------------------------- | | `base` | Nombre | La base à utiliser pour le calcul du journal. | ## lower Convertit toutes les lettres d'une valeur en minuscules.```text hubl.txt theme={null} {% set text="Text to MAKE LowercaSe" %} {{ text|lower }} ``` ```text sortie rendue.txt theme={null} text to make lowercase ``` ## 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.```text hubl.txt theme={null} {# Usage 1 #} Apply a filter to a sequence: {% set seq = ["item1", "item2", "item3"] %} {{ seq|map("upper") }} {# Usage 2 #} Look up an attribute: {{ content|map("currentState")}} ``` ```text sortie rendue.txt theme={null} Apply a filter to a sequence: [ITEM1, ITEM2, ITEM3] Look up an attribute: [DRAFT] ``` | Paramètre | Type | Description | | --------- | ------ | ------------------------------------------ | | `filter` | Chaîne | Filtre à appliquer à la séquence d'objets. | ## md5 Calcule le [hachage md5](https://en.wikipedia.org/wiki/MD5) de l'objet donné```text hubl.txt theme={null} {{ content.absolute_url|md5 }} ``` ```text sortie rendue.txt theme={null} 923adb4ce05a4c6342c04c80be88d15e ``` ## minus\_time Soustrait un nombre d'heures à partir d'un objet datetime.```text hubl.txt theme={null} {% set date = "2018-07-14T14:31:30+0530"|strtotime("yyyy-MM-dd'T'HH:mm:ssZ") %} {{ date }} {{ date|minus_time(2, "months") }} ``` ```text sortie rendue.txt theme={null} 2018-07-14 14:31:30 2018-05-14 14:31:30 ``` | Paramètre | Type | Description | | ---------- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `diff` | Nombre | Montant à soustraire. | | `timeunit` | Chaîne | Les unités de temps valides sont `nanos`, `micros`, `millis`, `seconds`, `minutes`, `hours`, `half_days`, `days`, `weeks`, `months`, `years`, `decades`, `centuries`, `millennia` et `eras`. | ## multiply Multiplie une valeur par un nombre. Fonctionne de la même manière que l'[opérateur \*](/docs/cms/reference/hubl/operators-and-expression-tests).```text hubl.txt theme={null} {% set n = 20 %} {{ n|multiply(3) }} ``` ```text sortie rendue.txt theme={null} 60 ``` ## plus\_time Ajoute un nombre d'heures à un objet datetime.```text hubl.txt theme={null} {% set date = "2018-07-14T14:31:30+0530"|strtotime("yyyy-MM-dd'T'HH:mm:ssZ") %} {{ date }} {{ date|plus_time(5, "days") }} ``` ```text sortie rendue.txt theme={null} 2018-07-14 14:31:30 2018-07-19 14:31:30 ``` | Paramètre | Type | Description | | ---------- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `diff` | Nombre | Montant à soustraire. | | `timeunit` | Chaîne | Les unités de temps valides sont `nanos`, `micros`, `millis`, `seconds`, `minutes`, `hours`, `half_days`, `days`, `weeks`, `months`, `years`, `decades`, `centuries`, `millennia` et `eras`. | ## pprint Impression d'une variable avec mise en forme. Ceci imprime le type de variable et d'autres informations utiles pour le débogage.```text hubl.txt theme={null} {% set this_var ="Variable that I want to debug" %} {{ this_var|pprint }} ``` ```text sortie rendue.txt theme={null} (String: Variable that I want to debug) ``` ## random Renvoie un élément aléatoire de la séquence.### Remarque: si vous utilisez ce filtre, la page sera [pré-rendue](/docs/cms/best-practices/testing-staging-performance/prerendering) 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. ```text hubl.txt theme={null} {% for content in contents|random %} ## 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](https://github.com/google/re2/wiki/Syntax).Post item markup{% endfor %} ``` ```text sortie rendue.txt theme={null}Random post``````text hubl.txt theme={null} {{ "contact-us-2"|regex_replace("[^a-zA-Z]", "") }} ``` ```text sortie rendue.txt theme={null} contactus ``` ## reject Filtre une séquence d'objets en appliquant un [test d'expression](/docs/cms/reference/hubl/operators-and-expression-tests) à l'objet et en rejetant ceux dont le test a réussi.```text hubl.txt theme={null} {% set some_numbers = [10, 12, 13, 3, 5, 17, 22] %} {{ some_numbers|reject("even") }} ``` ```text sortie rendue.txt theme={null} [13, 3, 5, 17] ``` | Paramètre | Type | Description | | ---------- | ------ | ------------------------------------------------------------------------------------------------------------------------- | | `exp_text` | Chaîne | Le nom du [test d'expression](/docs/cms/reference/hubl/operators-and-expression-tests#expression-tests) à appliquer à l'objet. | ## 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.```html example.html theme={null} {% for content in contents|rejectattr("post_list_summary_featured_image") %} | Paramètre | Type | Description | | ---------------- | ------ | ------------------------------------------------------------------------------------------------------------------------- | | `attribute_name` | Chaîne | Indique l'attribut à sélectionner. Vous pouvez accéder aux attributs imbriqués en utilisant la notation par points. | | `exp_test` | Chaîne | Le nom du [test d'expression](/docs/cms/reference/hubl/operators-and-expression-tests#expression-tests) à appliquer à l'objet. | ## render Rend les chaînes contenant HubL au début afin que la sortie puisse être transmise dans d'autres filtres.{% if content.post_list_summary_featured_image %}{% endfor %} ``` ```html example.html theme={null}{% endif %} {{ content.post_list_content|safe }}
Post with no featured imagePost with no featured imagePost with no featured image``````html example.html theme={null} {{ personalization_token("contact.lastname", "default value")|render|lower }} ``` ```html example.html theme={null} mclaren ``` ## replace Remplace toutes les instances d'une sous-chaîne par une nouvelle.```html example.html theme={null} {% if topic %} | Paramètre | Type | Description | | --------- | ------ | --------------------------------------------------------------------------------------- | | `old` | Chaîne | La sous-chaîne qui doit être remplacée. | | `new` | Chaîne | Chaîne de remplacement. | | `count` | Nombre | Si ce paramètre est fourni, seules les occurrences du premier décompte sont remplacées. | ## reverse Inverse l'objet ou renvoie un itérateur qui parcours dans l'autre sens. Pour inverser une liste, utilisez [.reverse()](/docs/cms/reference/hubl/functions#reverse)Posts about {{ page_meta.html_title|replace("Blog | ", "") }}
{% endif %} ``` ```html example.html theme={null}Posts about topic name
``````text hubl.txt theme={null} {% set nums = [1, 2, 3, 4, 5, 6, 7, 8, 9, 10] %} {% for num in nums|reverse %} {{ num }} {% endfor %} ``` ```text sortie rendue.txt theme={null} 10 9 8 7 6 5 4 3 2 1 ``` ## root Calcule la racine carrée d'une valeur```text hubl.txt theme={null} {{ 16|root }} {{ 625|root(4) }} ``` ```text sortie rendue.txt theme={null} 4 5 ``` | Paramètre | Type | Description | | ---------- | ------ | ------------------------------------------ | | `nth_root` | Nombre | La racine nième à utiliser pour le calcul. | ## round Arrondit un nombre à une précision donnée.```text hubl.txt theme={null} {{ 52.5|round }} {{ 52.5|round(0, "floor") }} ``` ```text sortie rendue.txt theme={null} 53 52 ``` | Paramètre | Type | Description | | ----------------- | -------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- | | `precision` | Nombre | Indique la précision de l'arrondi. | | `rounding_method` | `'common'` (défaut) \| `'ceil'` \| `'floor'` | `common` arrondit vers le haut ou vers le bas (par défaut) ; `ceil` arrondit toujours vers le haut ; `floor` arrondit toujours vers le bas. | ## 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.```text hubl.txt theme={null} {{ content.post_list_content|safe }} ``` ```html example.html theme={null} ## 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.HTML post content that is not escaped.
``````text hubl.txt theme={null} {% set escape_string = "This ## 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.
markup is" %} {{ escape_string|sanitize_html("IMAGES") }} ``` ```html example.html theme={null} This markup isprinted as text.
```text hubl.txt theme={null} {% set some_numbers = [10, 12, 13, 3, 5, 17, 22] %} {{ some_numbers|select("even") }} ``` ```html example.html theme={null} [10, 12, 22] ``` | Paramètre | Type | Description | | ---------- | ------ | ------------------------------------------- | | `exp_text` | Chaîne | Le test d'expression à appliquer à l'objet. | ## 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.```html example.html theme={null} {% for content in contents|selectattr("post_list_summary_featured_image") %} | Paramètre | Type | Description | | ---------------- | ------ | ------------------------------------------------------------------------------------------------------------------------- | | `attribute_name` | Chaîne | L'attribut à tester. Vous pouvez accéder aux attributs imbriqués en utilisant la notation par points. | | `exp_test` | Chaîne | Le nom du [test d'expression](/docs/cms/reference/hubl/operators-and-expression-tests#expression-tests) à appliquer à l'objet. | | `val` | Chaîne | Valeur à tester. | ## shuffle Rend aléatoire l'ordre d'itération d'une séquence. L'exemple ci-dessous mélange une boucle de blog standard.{% if content.post_list_summary_featured_image %}{% endfor %} ``` ```html example.html theme={null}{% endif %} {{ content.post_list_content|safe }}```Post with featured image
### Remarque: si vous utilisez ce filtre, la page sera [pré-rendue](/docs/cms/best-practices/testing-staging-performance/prerendering) 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. ```html example.html theme={null} {% for content in contents|shuffle %} ## 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.Markup of each post{% endfor %} ``` ```html example.html theme={null}Markup of each post 5Markup of each post 3Markup of each post 1Markup of each post 2Markup of each post 4``````html example.html theme={null} {% set items = ["laptops", "tablets", "smartphones", "smart watches", "TVs"] %} | Paramètre | Type | Description | | --------- | ------ | ------------------------------------------------------------------ | | `slices` | Nombre | Combien d'éléments seront découpés. | | `filler` | Chaîne | 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.{% for column in items|slice(3," ") %}``` ```html example.html theme={null}{% for item in column %}
{% endfor %}- {{ item }}
{% endfor %}```
- laptops
- tablets
- smartphones
- smart watches
- TVs
```html example.html theme={null} {% set my_posts = blog_recent_posts("default", limit=5) %} {% for item in my_posts|sort(False, False, "name") %} {{ item.name }} | Paramètre | Type | Description | | ---------------- | ------- | ----------------------------------------------------------------- | | `reverse` | Booléen | À définir sur `true` pour inverser l'ordre de tri. | | `case_sensitive` | Booléen | À définir sur `true` pour rendre le tri sensible à la casse. | | `attribute` | Chaîne | Attribut à utiliser pour le tri. Omettre lors du tri d'une liste. | ## 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.
{% endfor %} ``` ```html example.html theme={null} A post
B post
C post
D post
E post
``````html example.html theme={null} {% set string_to_split = "Mark; Irving; Helly; Dylan; Milchick; Harmony;" %} {% set names = string_to_split|split(";", 4) %} | Paramètre | Type | Description | | ----------------------- | ------ | ------------------------------------------------------------------------------------------------------------ | | `character_to_split_by` | Chaîne | Indique le séparateur avec lequel la variable doit être divisée. | | `number_of_splits` | Nombre | Détermine le nombre de fois que la variable doit être divisée. Tous les autres éléments resteraient groupés. | ## 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).{% for name in names %}
``` ```html example.html theme={null}- {{ name }}
{% endfor %}```
- Mark
- Irving
- Helly
- Dylan; Milchick; Harmony;
```text hubl.txt theme={null} {% set number_to_string = 45 %} {{ number_to_string|string|pprint }} ``` ```text sortie rendue.txt theme={null} (String: 45) ``` ## 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.```html example.html theme={null} {% set some_html = " ## strtodate Convertit une chaîne de date et un format de date en un objet de date.Some text" %} {{ some_html|striptags }} ``` ```html example.html theme={null} some text ``````text hubl.txt theme={null} {{ '3/3/21'|strtodate('M/d/yy') }} ``` ```text sortie rendue.txt theme={null} 2021-03-03 00:00:00 ``` | Paramètre | Type | Description | | ------------ | ------ | ---------------------------------------------------------------------------------------------------------- | | `dateFormat` | Chaîne | Le [format de date](https://docs.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html) à utiliser. | ## strtotime Convertit une chaîne datetime et un format datetime en un objet datetime.```text hubl.txt theme={null} {{ "2018-07-14T14:31:30+0530"|strtotime("yyyy-MM-dd'T'HH:mm:ssZ")|unixtimestamp }} ``` ```text sortie rendue.txt theme={null} 1531558890000 ``` | Paramètre | Type | Description | | ---------------- | ------ | --------------------------------------------------------------------------------------------------------------------- | | `datetimeFormat` | Chaîne | Le [format de date et d'heure](https://docs.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html) à utiliser. | ## 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.```text hubl.txt theme={null} // Simple sum {% set sum_this = [1, 2, 3, 4, 5] %} {{ sum_this|sum }} // Sum of attribute {% set items = [15, 10] %} {% set dict_var = [{"name": "Item1", "price": "20"}, {"name": "Item2", "price": "10"}] %} Total: {{ dict_var|sum(attribute="price") }} ``` ```text sortie rendue.txt theme={null} 15 Total: 30 ``` | Paramètre | Type | Description | | ------------------- | ------ | ----------------------------------------------------------------- | | `attribute` | Chaîne | Attribut à additionner. | | `return_if_nothing` | Chaîne | 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.```text hubl.txt theme={null} {{ [1, 2, 3]|symmetric_difference([2, 3, 4, 5]) }} ``` ```text sortie rendue.txt theme={null} [1, 4, 5] ``` | Paramètre | Type | Description | | --------- | ------- | ------------------------------------------------------------------------------------------- | | `list` | Tableau | La deuxième liste à comparer pour trouver la différence symétrique avec la liste originale. | ## 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).```text hubl.txt theme={null} {% set my_title="my title should be title case" %} {{ my_title|title }} ``` ```text sortie rendue.txt theme={null} My Title Should Be Title Case ``` ## tojson Écrit un objet sous forme de chaîne JSON.```text hubl.txt theme={null} {% for content in contents %} {{ content.blog_post_author|tojson }} {% endfor %} ``` ```json example.json theme={null} { "portalId": 1234567, "id": 12312253109, "created": 1566413741989, "updated": 1566414012799, "deletedAt": 0, "fullName": "Sample User", "email": "sampleUser@example.com", "userId": null, "username": null, "slug": "sample-user", "jsonBody": { "avatar": "https://app.hubspot.com/settings/avatar/109d6874a0cb066c1c7263ac5df6ce7a", "bio": "Sample Bio", "facebook": "", "linkedin": "", "twitter": "", "website": "https://www.hubspot.com" }, "bio": "Sample Bio", "facebook": "", "linkedin": "", "avatar": "https://app.hubspot.com/settings/avatar/109d6874a0cb066c1c7263ac5df6ce7a", "gravatarUrl": "https://app.hubspot.com/settings/avatar/108bb5ac667ded34796271437dfe8d58", "twitterUsername": "", "hasSocialProfiles": false, "website": "https://www.hubspot.com", "twitter": "", "displayName": "Sample User" } ``` ## 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é.```text hubl.txt theme={null} {{ " remove whitespace " }} {{ " remove whitespace "|trim }} ``` ```text sortie rendue.txt theme={null} remove whitespace remove whitespace ``` ## 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. ```text hubl.txt theme={null} {{ "I only want to show the first sentence. Not the second."|truncate(40) }} {{ "I only want to show the first sentence. Not the second."|truncate(35, true, "..........") }} ``` ```text sortie rendue.txt theme={null} I only want to show the first sente.......... ``` | Paramètre | Type | Description | | ---------------------- | ------- | ------------------------------------------------------------------------------------------------ | | `number_of_characters` | Nombre | Nombre de caractères autorisés avant que le texte ne soit tronqué. La valeur par défaut est 255. | | `breakword` | Booléen | Si `true`, le filtre coupe le texte en longueur. Si `false`, le dernier mot est supprimé. | | `end` | Chaîne | Remplace les caractères de fin par « ... » par défaut après la troncature. | ## 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. ```html example.html theme={null} {% set html_text = " | Paramètre | Type | Description | | ---------------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `number_of_characters` | Nombre | Nombre de caractères autorisés avant que le texte ne soit tronqué. La valeur par défaut est 255. | | `end` | Chaîne | Remplace les caractères de fin par « ... » par défaut après la troncature. | | `breakword` | Booléen | Valeur booléenne. Si `true`, le filtre coupe le texte en longueur. Si `false` (par défaut), le dernier mot est supprimé. Si vous n'utilisez qu'un seul des paramètres facultatifs, utilisez des arguments de type mot-clé, comme `truncatehtml(70, breakwords = false)`. | ## unescape\_html Convertit le texte avec des entités codées en HTML en leurs équivalents Unicode.I want to truncate this text without breaking my HTML
" %} {{ html_text|truncatehtml(28, "..." , false) }} ``` ```html example.html theme={null}
I want to truncate this..
``````text hubl.txt theme={null} {% set escape_string = "me & you" %} {{ escape_string|unescape_html }} ``` ```text sortie rendue.txt theme={null} me & you ``` ## 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.```text hubl.txt theme={null} {{ [1, 2, 3]|union([2, 3, 4, 5]) }} ``` ```text sortie rendue.txt theme={null} [1, 2, 3, 4, 5] ``` | Paramètre | Type | Description | | --------- | ------- | ------------------------------------------------- | | `list` | Tableau | La deuxième liste à joindre à la liste originale. | ## 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.```text hubl.txt theme={null} {% set my_sequence = ["one", "one", "two", "three" ] %} {{ my_sequence|unique }} ``` ```text sortie rendue.txt theme={null} [one, two, three] ``` | Paramètre | Type | Description | | --------- | ------ | ------------------------------------------------------------------------------------ | | `attr` | Chaîne | Indique l'attribut qui doit être utilisé lors du filtrage d'une valeur 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. ```text hubl.txt theme={null} {{ local_dt }} {{ local_dt|unixtimestamp }} ``` ```text sortie rendue.txt theme={null} 2017-01-30 17:11:44 1485814304000 ``` ## upper Convertit toutes les lettres d'une valeur en majuscules.```text hubl.txt theme={null} {% set text="text to make uppercase" %} {{ text|upper }} ``` ```text sortie rendue.txt theme={null} TEXT TO MAKE UPPERCASE ``` ## 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.```text hubl.txt theme={null} {% set encode_value="Escape & URL encode this string" %} {{ encode_value|urlencode }} ``` ```text sortie rendue.txt theme={null} Escape+%26+URL+encode+this+string ``` ## 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.```text hubl.txt theme={null} {% set decode_value="Escape+%26+URL+decode+this+string" %} {{ decode_value|urldecode }} ``` ```text sortie rendue.txt theme={null} Escape & URL decode this string ``` ## 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. | Paramètre | Type | Description | | ----------------- | ------- | ------------------------------------------------------------------- | | `shorten_text` | Nombre | Nombre entier qui raccourcira les URL au nombre désiré. | | `no_follow` | Booléen | Lorsqu'il est défini sur `true`, le lien inclura `rel="no follow"`. | | `target="_blank"` | Chaîne | Indique si le lien s'ouvrira dans un nouvel onglet. |```text hubl.txt theme={null} {{ "http://hubspot.com/"|urlize }} {{ "http://hubspot.com/"|urlize(10,true) }} {{ "http://hubspot.com/"|urlize("",true) }} {{ "http://hubspot.com/"|urlize("",false,target="_blank") }} ``` ```html example.html theme={null} http://hubspot.com/ http://... http://hubspot.com/ http://hubspot.com/ ``` ## 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. ```text hubl.txt theme={null} {% set count_words = "Count the number of words in this variable" %} {{ count_words|wordcount }} ``` ```text sortie rendue.txt theme={null} 8 ``` ## wordwrap Provoque le retour à la ligne des mots après un nombre de caractères donné. Cela fonctionne mieux dans un `` car HubSpot supprime les espaces blancs par défaut.```text hubl.txt theme={null} {% set wrap_text = "Lorem ipsum dolor sit amet, consectetur adipiscing elit. Etiam efficitur, ipsum non sagittis euismod, ex risus rhoncus lectus, vel maximus leo enim sit amet dui. Ut laoreet ultricies quam at fermentum." %} {{ wrap_text|wordwrap(10) }} ``` ```text sortie rendue.txt theme={null} Lorem ipsum dolor sit amet, consectetur adipiscing elit. Etiam efficitur, ipsum non sagittis euismod, ex risus rhoncus lectus, vel maximus leo enim sit amet dui. Ut laoreet ultricies quam at fermentum. ``` | Paramètre | Description | | ----------------- | ---------------------------------------------------------- | | `character_count` | Nombre de caractères avec le retour à la ligne du contenu. | ## 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.```html example.html theme={null} {% set html_attributes = {"class": "bold", "id": "sidebar"} %} ``` ```html example.html theme={null} ``` | Paramètre | Type | Description | | ----------- | ------- | ------------------------------------------------------------- | | `autospace` | Booléen | À définir sur `true` pour ajouter un espace devant l'élément. |
