Langage de programmation - Liquid (Microsoft)

Les filtres

Les filtres liquides permettent de modifier la sortie des chaînes, des nombres, des variables et des objets. Ils sont séparés de la valeur à laquelle ils sont appliqués par un |.



{{ 'hal 9000' | upcase }} <!-- Sortie: HAL 9000 -->

Certains filtres acceptent des paramètres. Ils peuvent également être combinés et appliqués de gauche à droite.



{{ 2 | times: 2 | minus: 1 }} <!-- Sortie: 3 -->

 
{{ "Bonjour, " | append: user.firstname }} <!-- Sortie: Bonjour, Dave -->

La section ci-dessous décrit différents filtres.

Filtres de tableau

Les filtres de tableau sont utilisés pour travailler avec des tableaux.

batch

Divise un tableau en plusieurs tableaux d'une taille donnée.

Code :



{% assign batches = entityview.records | batch: 2 %}

 
{% for batch in batches %}

 
<ul>

 
{% for item in batch %}

 
<li>{{ item.fullname }}</li>

 
{% endfor %}

 
</ul>

 
{% endfor %}

Sortie :



<ul>

 
<li>Jean Tremblay</li>

 
<li>Denis Terrien</li>

 
</ul>

 
<ul>

 
<li>Jonathan St-Pierre</li>

 
<li>Joseph Ouellette</li>

 
</ul>

concat

Concatène deux tableaux en un seul.

Avec un seul élément comme paramètre, concat renvoie un nouveau tableau composé du tableau d'origine, avec l'élément donné comme dernier élément.

Code :



Group #1: {{ group1 | join: ', ' }}

 
Group #2: {{ group2 | join: ', ' }}

 
Group #1 + Group #2: {{ group1 | concat: group2 | join: ', ' }}

Sortie :

Group #1: Jean, Pierre, Annie Group #2: Jean, Guillaume Group #1 + Group #2: Jean, Pierre, Annie, Jean, Guillaume

except

Sélectionner tous les objets d'un tableau dont un attribut donné n'a pas de valeur spécifique. (C'est l'inverse de where.)

Code :



Group #1: {{ group1 | join: ', ' }}

 
Group #2: {{ group2 | join: ', ' }}

 
Group #1 + Group #2: {{ group1 | concat: group2 | join: ', ' }}

Sortie :

Jacques Robitaille

first

Renvoie le premier élément d'un tableau.

first peut également être utilisé avec une notation par points spéciale, lorsqu'il doit être utilisé à l'intérieur d'une balise.

Code :



{% assign words = Ceci est une série de textes | split:   %}

 
{{ words | first }}

 
{% if words.first == Ceci %}

 
Le premier mot est Ceci.

 
{% endif %}

Sortie :

Ceci Le premier mot est Ceci.

group_by

Regrouper les éléments d'un tableau selon un attribut donné.

Code :



{% assign groups = entityview.records | group_by: 'address1_city' %}

 
{% for group in groups %}

 
{{ group.key }}:

 
{% for item in group.items %}

 
{{ item.fullname }}

 
{% endfor %}

 
{% endfor %}

Sortie :

Redmond: Jean Tremblay Dave Thomas Jake Johnson New York: Jack Robinson

join

Joint les éléments d'un tableau avec le caractère passé en paramètre. Le résultat est une chaîne unique.

Code :



{% assign words = Ceci est une série de textes | split:   %}

 
{{ words | join: ,  }}

Sortie :

Ceci, est, une, série, de, textes

last

Renvoie le dernier élément d'un tableau.

last peut également être utilisé avec une notation spéciale par points, lorsqu'il doit être utilisé à l'intérieur d'une balise.

Code :



{% assign words = Ceci est une série de texte | split:   -%}

 
{{ words | last }}

 
{% if words.last == texte -%}

 
Le dernier mot est le texte.

 
{% endif -%}

Sortie :

texte Le dernier mot est le texte.

order_by

Renvoie les éléments d'un tableau classés selon un attribut donné.

Vous pouvez éventuellement fournir «desc» comme second paramètre pour trier les éléments par ordre décroissant plutôt que par ordre croissant.

Code :



{{ entityview.records | order_by: 'fullname' | join: ', ' }}

 
{{ entityview.records | order_by: 'fullname', 'desc' | join: ', ' }}

Sortie :

David Terrien, Jacques Robert, Jacques Julien, Jean Tremblay Jean Tremblay, Jacques Julien, Jacques Robert, David Terrien

random

Renvoie un élément sélectionné aléatoirement dans le tableau.

Code :



{{ group1 | join: ', ' }}

 
{{ group1 | random }}

Sortie :

Jean, Pierre, Annie Pierre

select

Sélectionne la valeur d'un attribut donné pour chaque élément d'un tableau et renvoie ces valeurs sous forme de tableau.

Code :



{{ entityview.records | select: 'address1_city' | join: ', ' }}

Sortie :

Laval, Québec

shuffle

Appliqué à un tableau, renvoie un nouveau tableau contenant les mêmes éléments, dans un ordre aléatoire.

Code :



{{ group1 | join: ', ' }}

 
{{ group1 | shuffle | join: ', ' }}

Sortie :

Jean, Pierre, Annie Annie, Jean, Pierre

size

Renvoie le nombre d'éléments d'un tableau.

La taille peut également être utilisée avec une notation par points spéciale, lorsqu'elle doit être utilisée à l'intérieur d'une balise.

Code :



{% assign words = Ceci est une série de textes | split:   -%}

 
{{ words | size }}

 
{% if words.size == 6 -%}

 
Le texte contient 6 mots.

 
{% endif -%}

Sortie :

6 Le texte contient 6 mots.

skip

Ignore un nombre donné d'éléments dans un tableau et renvoie le reste.

Code :



{% assign words = Ceci est une série de textes | split:   %}

 
{{ words | skip: 3 | join: ', ' }}

Sortie :

série, de, textes

take

Extrait un nombre donné d'éléments du tableau et renvoie les éléments extraits.

Code :



{% assign words = Ceci est une série de textes | split:   %}

 
{{ words | take: 3 | join: ', ' }}

Sortie :

Ceci, est, une

then_by

Ajoute un ordre supplémentaire à un tableau déjà trié par ordre_ordre.

Vous pouvez également fournir desc comme second paramètre pour trier les éléments par ordre décroissant plutôt que par ordre croissant.

Code :



{{ entityview.records | order_by: 'address1_city' | then_by: 'fullname' | join: ', ' }}

 
{{ entityview.records | order_by: 'address1_city' | then_by: 'fullname', 'desc' | join: ', ' }}

Sortie :

David Terrien, Jacques Robert, Jacque St-Pierre, Jean Tremblay Jean Tremblay, Jacques St-Pierre, Jacques Robert, David Terrien

where

Sélectionner tous les objets d'un tableau dont un attribut possède une valeur donnée.

Code :



{% assign laval = entityview.records | where: 'address1_city', 'Laval' %}

 
{% for item in laval %}

 
{{ item.fullname }}

 
{% endfor %}

Sortie :

Jean Tremblay David Terrien Jacques St-Pierre

Filtres de date

Les filtres de date peuvent être utilisés pour calculer des dates ou pour convertir des valeurs DateHeure dans différents formats.

date

Formate une valeur DateTime à l'aide d'une chaîne de format .NET.

Chaînes de format de date et d'heure standard
Chaînes de format de date et d'heure personnalisées

Code :



{{ now | date: 'g' }}

 
{{ now | date: 'MMMM dd, yyyy' }}

Sortie :

5/7/2025 7:20 AM May 07, 2025

date_add_days

Ajoute le nombre spécifié de jours entiers et fractionnaires à la valeur DateTime. Le paramètre peut être positif ou négatif.

Code :



{{ now }}

 
{{ now | date_add_days: 1 }}

 
{{ now | date_add_days: -2.5 }}

Sortie :

5/7/2025 7:20:46 AM 5/8/2025 7:20:46 AM 5/4/2025 7:20:46 PM

date_add_hours

Ajoute le nombre d'heures et de fractions d'heures spécifié à la valeur DateTime. Le paramètre peut être positif ou négatif.

Code :



{{ now }}

 
{{ now | date_add_hours: 1 }}

 
{{ now | date_add_hours: -2.5 }}

Sortie :

5/7/2025 7:20:46 AM 5/7/2025 8:20:46 AM 5/7/2025 4:50:46 AM

date_add_minutes

Ajoute le nombre spécifié de minutes entières et fractionnaires à la valeur DateTime. Le paramètre peut être positif ou négatif.

Code :



{{ now }}

 
{{ now | date_add_minutes: 10 }}

 
{{ now | date_add_minutes: -2.5 }}

Sortie :

5/7/2025 7:20:46 AM 5/7/2025 7:30:46 AM 5/7/2025 7:18:16 AM

date_add_months

Ajoute le nombre de mois entiers spécifié à la valeur DateTime. Le paramètre peut être positif ou négatif.

Code :



{{ now }}

 
{{ now | date_add_months: 1 }}

 
{{ now | date_add_months: -2 }}

Sortie :

5/7/2025 7:20:46 AM 6/7/2025 7:20:46 AM 3/7/2025 7:20:46 AM

date_add_seconds

Ajoute le nombre spécifié de secondes entières et fractionnaires à la valeur DateTime. Le paramètre peut être positif ou négatif.

Code :



{{ now }}

 
{{ now | date_add_seconds: 10 }}

 
{{ now | date_add_seconds: -1.25 }}

Sortie :

5/7/2018 7:20:46 AM 5/7/2018 7:20:56 AM 5/7/2018 7:20:45 AM

date_add_years

Ajoute le nombre d'années spécifié à la valeur DateTime. Le paramètre peut être positif ou négatif.

Code :



{{ now }}

 
{{ now | date_add_years: 1 }}

 
{{ now | date_add_years: -2 }}

Sortie :

5/7/2025 7:20:46 AM 5/7/2025 7:20:46 AM 5/7/2025 7:20:46 AM

date_to_iso8601

Formate une valeur DateTime selon la norme ISO 8601. Utile pour la création de flux Atom ou de l'élément HTML5 <time>.

Code :



{{ now | date_to_iso8601 }}

Sortie :

2018-05-07T07:20:46Z

date_to_rfc822

Formate une valeur DateTime selon la norme RFC 822. Utile pour la création de flux RSS.

Code :



{{ now | date_to_rfc822 }}

Sortie :

Mon, 07 May 2018 07:20:46 Z

Filtres d'échappement

Les séquences d'échappement permettent d'inclure des caractères spéciaux dans des chaînes sans perturber l'interprétation habituelle de ces caractères par le langage de programmation ou le format.

Les filtres d'échappement suivants remplacent les caractères de chaîne par des séquences d'échappement ou suppriment les caractères de chaîne non valides en fonction du type de destination.

escape

Échappement HTML d'une chaîne de caractères.

Code :



{{ '<p>test</p>' | escape }}

Sortie :

test

html_safe_escape

Convertit une chaîne HTML donnée en un fragment HTML sécurisé.

Code :



{{ '<img src="images/myimage.jpg" onerror="alert(1);">' | html_safe_escape }}

Sortie :



<img src="images/myimage.jpg">

url_escape

Échappement URI d'une chaîne, pour inclusion dans une URL.

Code :



{{ 'This & that//' | url_escape }}

Sortie :

This+%26+that%2F%2F

xml_escape

Échappement XML d'une chaîne, pour inclusion dans la sortie XML.

Code :



{{ '<p>test</p>' | xml_escape }}

Sortie :

test

Filtres de liste

Les filtres de liste permettent de gérer certaines valeurs d'attributs de liste d'entités et de créer des vues de liste.

current_sort

À partir d'une expression de tri, renvoie le sens de tri actuel pour un attribut donné.

Code :



{{ 'name ASC, createdon DESC' | current_sort: 'createdon' }}

Sortie :

DESC

metafilters

Analyse une valeur JSON de définition de filtre de liste d'entités pour la transformer en objets de groupe d'options de filtre.

Les métafiltres peuvent être fournis en option avec une requête de filtre d'attribut actuel et une liste d'entités actuelle, permettant ainsi de marquer les objets de filtre renvoyés comme sélectionnés ou non.

Code :




{% assign filters = entitylist | metafilters: params.mf, entityview %}

{% if filters.size > 0 %}

  <ul id=entitylist-filters>

    {% for filter in filters %}

      <li class=entitylist-filter-option-group>

        {% if filter.selection_mode == 'Single' %}

          {% assign type = 'radio' %}

        {% else %}

          {% assign type = 'checkbox' %}

        {% endif %}

        <h4 class=entitylist-filter-option-group-label

          data-filter-id={{ filter.id | h }}>

          {{ filter.label | h }}

        </h4>

        <ul>

          {% for option in filter.options %}

            <li class=entitylist-filter-option>

              {% if option.type == 'text' %}

                <div class=input-group entitylist-filter-option-text>

                  <span class=input-group-addon>

                    <span class=fa fa-filter aria-hidden=true></span>

                  </span>

                  <input class=form-control

                    type=text

                    name={{ filter.id | h }}

                    value={{ option.text | h }} />

                </div>

              {% else %}

                <div class={{ type | h }}>

                  <label>

                    <input

                      type={{ type | h }}

                      name={{ filter.id | h }}

                      value={{ option.id | h }}

                      {% if option.checked %}

                        checked=checked

                        data-checked=true{% endif %}

                      />

                    {{ option.label | h }}

                  </label>

                </div>

              {% endif %}

            </li>

          {% endfor %}

        </ul>

      </li>

    {% endfor %}

  </ul>

  <button class=btn btn-default data-serialized-query=mf data-target=#entitylist-filters>Appliquer des filtres</button>

{% endif %}

reverse_sort

Étant donné un sens de tri, renvoie le sens de tri opposé.

Code :



<!-- Le sens de tri n'est pas sensible à la casse -->

 
{{ 'ASC' | reverse_sort }}

 
{{ 'desc' | reverse_sort }}

Sortie :

DESC ASC

Filtres mathématiques

Les filtres mathématiques permettent d'effectuer des opérations mathématiques sur des nombres.

Comme tous les filtres, ils peuvent être enchaînés et appliqués de gauche à droite.

Code :



{{ 10 | times: 2 | minus: 5 | divided_by: 3 }}

Sortie :

5

ceil

Arrondit une valeur à l'entier supérieur le plus proche.

Code :



{{ 4.6 | ceil }}

 
{{ 4.3 | ceil }}

Sortie :

5 5

divided_by

Divise un nombre par un autre.

Code :



{{ 10 | divided_by: 2 }}

 
{{ 10 | divided_by: 3 }}

 
{{ 10.0 | divided_by: 3 }}

Sortie :

5 3 3.333333

floor

Arrondit une valeur à l'entier inférieur le plus proche.

Code :



{{ 4.6 | floor }}

 
{{ 4.3 | floor }}

Sortie :

4 4 minus

Soustrait un nombre d'un autre nombre.

Code :



<!-- entityview.page = 11 -->

 
{{ entityview.page | minus: 1 }}

 
{{ 10 | minus: 1.1 }}

 
{{ 10.1 | minus: 1 }}

Sortie :

10 9 9.1

modulo

Divise un nombre par un autre et renvoie le reste.

Code :



{{ 12 | modulo: 5 }}

Sortie :

2

plus

Ajoute un nombre à un autre.

Code :



<!-- entityview.page = 11 -->

 
{{ entityview.page | plus: 1 }}

 
{{ 10 | plus: 1.1 }}

 
{{ 10.1 | plus: 1 }}

Sortie :

12 11 11.1

round

Arrondit une valeur à l'entier le plus proche ou au nombre de décimales spécifié.

Code :



{{ 4.6 | round }}

 
{{ 4.3 | round }}

 
{{ 4.5612 | round: 2 }}

Sortie :

5 4 4.56

times

Multiplie un nombre par un autre.

Code :



{{ 10 | times: 2 }}

 
{{ 10 | times: 2.2 }}

 
{{ 10.1 | times: 2 }}

Sortie :

20 20 20.2

Filtres de chaîne

Les filtres de chaîne manipulent les chaînes.

append

Ajoute une chaîne à la fin d'une autre chaîne.

Code :



{{ 'filename' | append: '.js' }}

Sortie :

filename.js

capitalize

Met en majuscules tous les mots d'une chaîne.

Code :



{{ 'mets-moi une majuscule' | capitalize }}

Sortie :

Mets-Moi Une Majuscule

downcase

Convertit une chaîne en minuscules.

Code :



{{ 'TExte en MAJuscules et minuscULES' | downcase }}

Sortie :

texte en majuscules et minuscules

newline_to_br

Insère une balise HTML de saut de ligne à chaque saut de ligne dans une chaîne.

Code :



{% capture text %}

 
A

 
B

 
C

 
{% endcapture %}

 
{{ text | newline_to_br }}

Sortie :



A<br />

 
B<br />

 
C<br />

prepend

Ajoute une chaîne au début d'une autre chaîne.

Code :



{{ 'Jean St-Pierre' | prepend: 'Dr. ' }}

Sortie :

Dr. Jean St-Pierre

remove

Supprime toutes les occurrences d'une sous-chaîne d'une chaîne.

Code :



{{ 'Bonjour, David. Comment vas-tu, David ?' | remove: 'David' }}

Sortie :

Bonjour, . Comment vas-tu, ?

remove_first

Supprime la première occurrence d'une sous-chaîne d'une chaîne.

Code :



{{ 'Bonjour Dave. Comment vas-tu, Dave ?' | remove_first: 'Dave' }}

Sortie :

Bonjour . Comment vas-tu, Dave ?

replace

Remplace toutes les occurrences d'une chaîne par une sous-chaîne.

Code :



{{ 'Bonjour Dave. Comment vas-tu, Dave ?' | replace: 'Dave', 'Jean' }}

Sortie :

Bonjour, Jean. Comment vas-tu, Jean ?

replace_first

Remplace la première occurrence d'une chaîne par une sous-chaîne.

Code :



{{ 'Bonjour, Dave. Comment vas-tu, Dave ?' | replace_first: 'Dave', 'Jean' }}

Sortie :

Bonjour Jean. Comment vas-tu Dave ?

split

Le filtre de division prend une sous-chaîne comme paramètre. Cette sous-chaîne sert de délimiteur pour diviser une chaîne en un tableau.

Code :



{% assign words = Ceci est une démonstration du filtre divisé | split: ' ' %}

     

Premier mot : {{ words.first }}

 
Premier mot : {{ words[0] }}

 
Deuxième mot : {{ words[1] }}

 
Dernier mot : {{ words.last }}

 
Tous les mots : {{ words | join: ', ' }}

Sortie :

Premier mot : Ceci Premier mot : Ceci Deuxième mot : est Dernier mot : filtre Tous les mots : Ceci, est, une, démonstration, du, filtre, divisé

strip_html

Supprime toutes les balises HTML d'une chaîne.

Code :



{{ "<p>Bonjour</p>" | strip_html }}

Sortie :

Bonjour

strip_newlines

Supprime tous les sauts de ligne d'une chaîne.

Code :



{% capture text %}

 
A

 
B

 
C

 
{% endcapture %}

 
{{ text | strip_newlines }}

Sortie :

ABC

text_to_html

Formate une chaîne de texte brut en HTML simple. Le texte est codé en HTML, les blocs de texte séparés par une ligne vide sont entourés de balises de paragraphe , les sauts de ligne sont remplacés par et les URL sont converties en hyperliens.

Code :



{{ note.notetext | text_to_html }}

Sortie :




<p>Ceci est le premier paragraphe du texte de la note. Il contient une URL : <a href="https://example.com/" rel="nofollow">https://example.com</a></p>
 
<p>Ceci est un deuxième paragraphe.</p>

truncate

Tronque une chaîne à un nombre donné de caractères. Un point de suspension (...) est ajouté à la chaîne et est inclus dans le nombre de caractères.

Code :




{{ "Il s'agit d'un long texte." | truncate: 10 }}

Sortie :

Il s'agit...

truncate_words

Tronque une chaîne jusqu'à un nombre de mots donné. Des points de suspension (...) sont ajoutés à la chaîne tronquée.

Code :



{{ "Il s'agit d'un long texte." | truncate_words: 3 }}

Sortie :

Il s'agit d'un...

upcase

Convertit une chaîne en majuscules.

Code :



{{ 'Texte en Majuscules et MINuscules' | upcase }}

Sortie :

TEXTE EN MAJUSCULES ET MINUSCULES

Filtres de type

Les filtres de type vous permettent de convertir des valeurs d'un type en d'autres types.

boolean

Tente de convertir une valeur de chaîne en valeur booléenne. Si la valeur est déjà booléenne, elle est renvoyée sans modification. Si la valeur ne peut pas être convertie en valeur booléenne, la valeur null est renvoyée.

Ce filtre accepte également les valeurs «on», «enabled» ou «yes» comme vraies, et les valeurs «off», «disabled» et «no» comme fausses.

Code :



{{ true | boolean }}

 
{{ 'false' | boolean }}

 
{{ 'enabled' | boolean }}

 
{{ settings['something/enabled'] | boolean | default: false }}

Sortie :

true false true false

decimal

Tente de convertir une valeur de chaîne en nombre décimal. Si la valeur est déjà un nombre décimal, elle est renvoyée sans modification. Si la valeur ne peut pas être convertie en nombre décimal, la valeur null est renvoyée.

Code :



{{ 10.1 | decimal }}

 
{{ '3.14' | decimal }}

 
{{ 'text' | decimal | default: 3.14 }}

Sortie :

10.1 3.14 3.14

integer

Tente de convertir une valeur de chaîne en entier. Si la valeur est déjà un entier, elle est renvoyée sans modification. Si la valeur ne peut pas être convertie en entier, la valeur null est renvoyée.

Code :



{{ 10 | integer }}

 
{{ '10' | integer }}

 
{{ '10.1' | integer }}

 
{{ 'text' | integer | default: 2 }}

Sortie :

10 10 2

string

Tente de convertir une valeur en sa représentation sous forme de chaîne. Si la valeur est déjà une chaîne, elle est renvoyée sans modification. Si la valeur est nulle, la valeur nulle est renvoyée.

Filtres d'URL

Les filtres d'URL vous permettent de créer ou d'extraire des parties d'URL.

add_query

Ajoute un paramètre de chaîne de requête à une URL. Si le paramètre existe déjà dans l'URL, sa valeur est mise à jour.

Si ce filtre est appliqué à une URL absolue complète, le résultat est une URL absolue mise à jour. S'il est appliqué à un chemin, le résultat est un chemin mis à jour.

Code :



{{ 'https://example.com/path?page=1' | add_query: 'foo', 'bar' }}

 
{{ '/path?page=1' | add_query: 'page', 2 }}

Sortie :

https://example.com/path?page=1&foo=bar /path?page=2

base

Obtient l'URL de base d'une URL donnée.

Code :



{{ 'https://example.com/path?foo=bar&page=2' | base }}

Sortie :

https://example.com

host

Obtient la partie hôte d'une URL.

Code :



{{ 'https://example.com/path?foo=bar&page=2' | host }}

Sortie :

example.com

path

Récupère le chemin d'accès d'une URL.

Code :



{{ 'https://example.com/path?foo=bar&page=2' | path}}

 
{{ '/path?foo=bar&page=2' | path }}

Sortie :

/path /path

path_and_query

Obtient le chemin et la partie requête d'une URL.

Code :



{{ 'https://example.com/path?foo=bar&page=2' | path_and_query }}

 
{{ '/path?foo=bar&page=2' | path_and_query }}

Sortie :

/path?foo=bar&page=2 /path?foo=bar&page=2

port

Obtient le numéro de port d'une URL.

Code :



{{ 'https://example.com/path?foo=bar&page=2' | port }}

 
{{ 'https://example.com/path?foo=bar&page=2' | port }}

 
{{ 'https://example.com:9000/path?foo=bar&page=2' | port }}

Sortie :

80 443 9000

remove_query

Supprime un paramètre de chaîne de requête d'une URL. Si le paramètre n'existe pas dans l'URL, l'URL est renvoyée sans modification.

Si ce filtre est appliqué à une URL absolue complète, le résultat est une URL absolue mise à jour. S'il est appliqué à un chemin, le résultat est un chemin mis à jour.

Code :



{{ 'https://example.com/path?page=1' | remove_query: 'page' }}

 
{{ '/path?page=1' | remove_query: 'page' }}

Sortie :

https://example.com/path /path

scheme

Obtient la partie schéma d'une URL.

Code :



{{ 'https://example.com/path?foo=bar&page=2' | scheme }}

 
{{ 'https://example.com/path?foo=bar&page=2' | scheme }}

Sortie :

http https

Filtres supplémentaires

Ces filtres offrent des fonctionnalités générales utiles.

default

Renvoie une valeur par défaut pour toute variable sans valeur assignée (c'est-à-dire nulle).

Code :



{{ snippets[Header] | default: 'Mon Site Web' }}

Sortie :



<!-- Si un extrait avec le nom Header renvoie null -->

 
Mon Site Web

file_size

Appliqué à une valeur numérique représentant plusieurs octets, il renvoie une taille de fichier formatée avec une unité d'échelle appropriée.

Un paramètre de précision peut éventuellement être défini pour contrôler le nombre de décimales du résultat. La précision par défaut est de 1.

Code :



{{ 10000000 | file_size }}

 
{{ 2050 | file_size: 0 }}

 
{{ entity.notes.first.filesize | file_size: 2 }}

Sortie :

9.5 MB 2 KB 207.14 KB

h

Fournit une représentation HTML d'un attribut. Par exemple, une représentation HTML de l'attribut XML de la requête FetchXML.

Code :



{{ samplequery.xml | h }}

Sortie :




<fetch mapping="logical" count="5000" page="1" returntotalrecordcount="true"> <entity name="contact"> <attribute name="fullname" /> </entity> </fetch>

has_role

Appliqué à un utilisateur, renvoie «true» si l'utilisateur appartient au rôle donné. Renvoie «false» dans le cas contraire.

Code :



{% assign is_admin = user | has_role: 'Administrateurs' %}

 
{% if is_admin %}

 
L'utilisateur est un administrateur.

 
{% endif %}

liquid

Restitue une chaîne sous forme de code Liquid. Ce code a accès au contexte d'exécution Liquid actuel (variables,...).

Remarque : Ce filtre doit être utilisé avec prudence et ne doit généralement être appliqué qu'aux valeurs sous le contrôle exclusif des auteurs du contenu du site ou d'autres utilisateurs de confiance pour écrire du code Liquid.

Code :



{{ page.adx_copy | liquid }}

Dernière mise à jour : Vendredi, le 18 juillet 2025