Skip to content

Filtres avancés

Cet article de référence fournit un aperçu des filtres avancés dans Liquid et de la manière dont ils peuvent être utilisés.

Filtres d’encodage

Nom du filtre Description du filtre Exemple d’entrée Exemple de sortie
md5 Renvoie une chaîne de caractères encodée en md5 {{'hey' | md5}} 6057f13c496ecf7fd777ceb9e79ae285
sha1 Renvoie une chaîne de caractères encodée en sha1 {{'hey' | sha1}} 7f550a9f4c44173a37664d938f1355f0f92a47a7
sha2 Renvoie une chaîne de caractères encodée en sha2 (256 bits, également connu sous le nom de SHA-256) {{'hey' | sha2}} fa690b82061edfd2852629aeba8a8977b57e40fcb77d1a7a28b26cba62591204
base64 Renvoie une chaîne de caractères encodée en base64 {{'blah' | base64_encode}} YmxhaA==
hmac_sha1_hex (anciennement hmac_sha1) Renvoie une signature hmac-sha1, encodée sous forme de chaîne hexadécimale {{'hey' | hmac_sha1_hex: 'secret_key'}} 2a3969bed25bfeefb00aca4063eb9590b4df8f0e
hmac_sha1_base64 Renvoie une signature hmac-sha1, encodée sous forme de chaîne base64 {{'hey' | hmac_sha1_base64: 'secret_key'}} KjlpvtJb/u+wCspAY+uVkLTfjw4=
hmac_sha256_hex Renvoie une signature hmac-sha256, encodée sous forme de chaîne hexadécimale {{'hey' | hmac_sha256_hex: 'secret_key'}} 8df897f8da3d7992fe57c8dbc6f27578cfbf2dcc4d0fbb4000b8c924841d508e
hmac_sha256_base64 Renvoie une signature hmac-sha256, encodée sous forme de chaîne base64 {{'hey' | hmac_sha256_base64: 'secret_key'}} jfiX+No9eZL+V8jbxvJ1eM+/LcxND7tAALjJJIQdUI4=

Filtres d’URL

Nom du filtre Description du filtre Exemple d’entrée Exemple de sortie
url_escape Identifie tous les caractères d’une chaîne qui ne sont pas autorisés dans les URL et les remplace par leurs variantes échappées {{'hey<>hi' | url_escape}} hey%3C%3Ehi
url_param_escape Remplace tous les caractères d’une chaîne qui ne sont pas autorisés dans les URL par leurs variantes échappées, y compris l’esperluette (&) {{'hey<&>hi' | url_param_escape}} hey%3C%26%3Ehi
url_encode Encode une chaîne de caractères compatible avec les URL {{ 'google search' | url_encode }} google+search

Filtre d’accès aux propriétés

Nom du filtre Description du filtre
property_accessor Prend un hash et une clé de hash, puis renvoie la valeur correspondant à cette clé dans le hash

Exemple de hash : {"a" => 42, "b" => 0} Exemple d’entrée : {{hash | property_accessor: 'a'}} Exemple de sortie : 42

De plus, le filtre d’accès aux propriétés vous permet d’utiliser un attribut personnalisé comme clé de hash pour accéder à une valeur de hash particulière.

Filtres de formatage des nombres

Nom du filtre Description du filtre Exemple d’entrée Exemple de sortie
number_with_delimiter Formate un nombre avec des séparateurs de milliers {{ 123456 | number_with_delimiter }} 123,456

Filtre d’échappement JSON ou d’échappement de chaîne de caractères

Nom du filtre Description du filtre
json_escape Échappe tous les caractères spéciaux d’une chaîne de caractères (tels que les guillemets doubles "" et la barre oblique inversée ‘').

Ce filtre doit toujours être utilisé lors de la personnalisation d’une chaîne de caractères dans un dictionnaire JSON. Il est particulièrement utile pour les webhooks.

Filtres de formatage JSON

Nom du filtre Description du filtre
json_parse Convertit une chaîne JSON en une structure de données correspondante, telle qu’un objet ou un tableau.
as_json_string Convertit une structure de données, telle qu’un objet ou un tableau, en une chaîne JSON correspondante.
Exemple d’entrée et de sortie pour json_parse

Entrée

1
2

{% assign my_data_string = '[{"id":"1","store_name":"demo-store"}]'  %}
{% assign my_data = my_data_string | json_parse %}

Sortie

1
2
3
4

{% for item in my_data %}
Item ID: {{ item.id }}
Item Name: {{ item.store_name }}
{% endfor %}
Exemple d’entrée et de sortie pour as_json_string

Entrée

1
2
3

{% assign my_data_string = '[{"id":"1","store_name":"demo-store"}]'  %}
{% assign my_data = my_data_string | json_parse %}
{% assign json_string = my_data | as_json_string %}

Sortie

1

{{json_string}}
New Stuff!