String filters

String-Filter werden verwendet, um Ausgaben und Variablen vom Typ String zu manipulieren.

Inhalt

append

Hängt Zeichen an eine Zeichenkette an.

{{ 'verkaufs' | append: '.jpg' }}

verkaufs.jpg

base64_encode

Kodiert eine Zeichenkette in Base64.

{{ 'one two three' | base64_encode }}

b25lIHR3byB0aHJlZQ==

base64_decode

Dekodiert eine Zeichenkette aus Base64.

{{ 'b25lIHR3byB0aHJlZQ==' | base64_decode }}

one two three

base64_url_safe_encode

Kodiert eine Zeichenfolge in URL-sicheres Base64. Um URL-sicheres Base64 zu erzeugen, verwendet dieser Filter - und _ anstelle von + und _.

{{ '<p>ok?</p>' | base64_url_safe_encode }}

PHA-b2s_PC9wPg==

base64_url_safe_decode

Dekodiert eine Zeichenkette aus URL-sicherem Base64.

{{ 'PHA-b2s_PC9wPg==' | base64_url_safe_decode }}

<p>ok?</p>

camelcase

Konvertiert eine Zeichenkette in CamelCase.

{{ 'kommt-bald' | camelcase }}

KommtBald

capitalize

Großschreibung des ersten Wortes in einer Zeichenkette.

{{ 'mich großschreiben' | capitalize }}

Mich großschreiben

downcase

Wandelt eine Zeichenkette in Kleinbuchstaben um.

{{ 'UPPERDESE' | downcase }}

großbuchstaben

escape

Entfernt eine Zeichenkette.

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

<p>test</p>
 
 <!-- Hinweis: Ein Browser zeigt dies als <p>test</p> -->

handle/handleize

Formatiert eine Zeichenkette in ein Handle.

Die Zeichenkette wird in Kleinbuchstaben umgewandelt, und alle Leer- und Sonderzeichen werden durch Bindestriche (-) ersetzt. Enthält ein Titel mehrere aufeinanderfolgende Leerzeichen oder Sonderzeichen, werden diese durch einen einzelnen Bindestrich ersetzt. Leerzeichen und Sonderzeichen werden am Anfang und Ende des Griffs abgeschnitten.

{{ '100% M & Ms!!!' | handleize }}

100-m-ms

md5

Konvertiert eine Zeichenkette in einen MD5-Hash.

Ein Anwendungsbeispiel für diesen Filter ist die Anzeige des Gravatar-Bildes, das mit dem Verfasser eines Blog-Kommentars verbunden ist:

<img src="https://www.gravatar.com/avatar/{{ comment.email | remove: ' ' | strip_newlines | downcase | md5 }}">

<img src="https://www.gravatar.com/avatar/2a95ab7c950db9693c2ceb767784c201">

sha1

Konvertiert eine Zeichenkette in einen SHA-1-Hash.

{% assign my_secret_string = 'VersaCommerceIsGrossartige!' | sha1 %}
Meine kodierte Zeichenfolge lautet: {{ my_secret_string }}

Meine kodierte Zeichenfolge lautet: c7322e3812d3da7bc621300ca1797517c34f63b6

sha256

Konvertiert eine Zeichenkette in einen SHA-256-Hash.

{% assign my_secret_string = 'VersaCommerceIsGrossartige!' | sha256 %}
Meine kodierte Zeichenfolge lautet: {{ my_secret_string }}

Meine kodierte Zeichenfolge lautet: c29cce758876791f34b8a1543f0ec3f8e886b5271004d473cfe75ac3148463cb

hmac_sha1

Konvertiert eine Zeichenfolge in einen SHA-1-Hash unter Verwendung eines Hash Message Authentication Code (HMAC). Übergeben Sie den geheimen Schlüssel für die Nachricht als Parameter an den Filter.

{% assign my_secret_string = 'VersaCommerceIsGrossartige!' | hmac_sha1: 'secret_key' %}
Meine kodierte Zeichenfolge lautet: {{ my_secret_string }}

Meine kodierte Zeichenfolge lautet: 30ab3459e46e7b209b45dba8378fcbba67297304

hmac_sha256

Konvertiert eine Zeichenfolge in einen SHA-256-Hash unter Verwendung eines Hash Message Authentication Code (HMAC). Übergeben Sie den geheimen Schlüssel für die Nachricht als Parameter an den Filter.

{% assign my_secret_string = 'VersaCommerceIsGrossartige!' | hmac_sha256: 'secret_key' %}
Meine kodierte Zeichenfolge lautet: {{ my_secret_string }}

Meine kodierte Zeichenfolge lautet: 30ab3459e46e7b209b45dba8378fcbba67297304

newline_to_br

Fügt ein <br> linebreak HTML-Tag vor jedem Zeilenumbruch in einer Zeichenkette ein.

{% capture var %}
One
Two
Three
{% endcapture %}
{{ var | newline_to_br }}

One<br>
Two<br>
Three<br>

pluralize

Gibt die Singular- oder Pluralversion einer englischen Zeichenkette basierend auf dem Wert einer Zahl aus. Der erste Parameter ist der Singular und der zweite Parameter der Plural.

pluralize wendet englische Pluralisierungsregeln auf Quellzeichenketten an. Sie sollten diesen Filter nicht für nicht-englische Zeichenfolgen verwenden, da er zu falschen Pluralisierungen für Zeichenfolgen in anderen Sprachen führt. 
{{ cart.item_count }}
{{ cart.item_count | pluralize: 'item', 'Produkte' }}

3 Produkte

prepend

Stellt einer Zeichenkette Zeichen voran.

{{ 'verkauf' | prepend: 'Großartig gemacht ' }}

Großartig gemacht verkauf

remove

Entfernt alle Vorkommen einer Teilzeichenkette aus einer Zeichenkette.

{{ 'Hallo, Welt. Goodbye, Welt.' | remove: 'Welt' }}

Hallo, . Goodbye, .

remove_first

Entfernt nur das erste Vorkommen einer Teilzeichenkette aus einer Zeichenkette.

{{ 'Hallo, Welt. Goodbye, Welt.' | remove_first: 'Welt' }}

Hallo, . Goodbye, Welt.

replace

Ersetzt alle Vorkommen einer Zeichenkette durch eine Teilzeichenkette.

 <!-- product.title = "Tolle Schuhe" -->
{{ product.title | replace: 'Grossartige', 'Mega' }}

Mega Schuhe

replace_first

Ersetzt das erste Vorkommen einer Zeichenkette durch eine Teilzeichenkette.

 <!-- product.title = "Grossartige Tolle Schuhe" -->
{{ product.title | replace_first: 'Grossartige', 'Mega' }}

Mega Tolle Schuhe

slice

Der Filter slice gibt eine Teilzeichenkette zurück, beginnend mit dem angegebenen Index. Ein optionaler zweiter Parameter kann übergeben werden, um die Länge der Teilzeichenkette anzugeben. Wird kein zweiter Parameter angegeben, wird eine Teilzeichenkette von einem Zeichen zurückgegeben.

{{ 'hello' | slice: 0 }}
{{ 'hello' | slice: 1 }}
{{ 'hello' | slice: 1, 3 }}

h
e
ell

Ist der übergebene Index negativ, wird er vom Ende der Zeichenkette aus gezählt.

{{ 'hello' | slice: -3, 2  }}

ll

split

Der Filter split nimmt eine Teilzeichenkette als Parameter an. Die Teilzeichenkette wird als Begrenzungszeichen verwendet, um eine Zeichenkette in ein Array zu unterteilen. Mit Array-Filtern können Sie verschiedene Teile eines Arrays ausgeben.

{% assign words = 'Hi, how are you today?' | split: ' ' %}

{% for word in words %}
{{ word }}
{% endfor %}

Hi,
how
are
you
today?

strip

Entfernt Tabulatoren, Leerzeichen und Zeilenumbrüche (alle Leerzeichen) von der linken und rechten Seite einer Zeichenkette.

{{ '   zu viele Leerzeichen      ' | strip }}

zu viele Leerzeichen

lstrip

Entfernt Tabulatoren, Leerzeichen und Zeilenumbrüche (alle Leerzeichen) von der linken Seite einer Zeichenkette.

{{ '   zu viele Leerzeichen           ' | lstrip }}

zu viele Leerzeichen

rstrip

Entfernt Tabulatoren, Leerzeichen und Zeilenumbrüche (alle Leerzeichen) von der rechten Seite einer Zeichenkette.

{{ '              zu viele Leerzeichen      ' | rstrip }}

zu viele Leerzeichen

strip_html

Entfernt alle HTML-Tags aus einer Zeichenkette.

{{ '<h1>Hallo</h1> World' | strip_html }}

Hallo Welt

strip_newlines

Entfernt alle Zeilenumbrüche/Neuzeilen aus einer Zeichenkette.

{{ product.description | strip_newlines }}

truncate

Schneidet eine Zeichenkette auf die Anzahl der Zeichen ab, die als erster Parameter übergeben wurde. Eine Ellipse (. . . ) wird an die abgeschnittene Zeichenfolge angehängt und in die Zeichenzählung einbezogen.

{{ 'Die Katze kam schon am nächsten Tag zurück' | truncate: 13 }}

Die Katze ka...

Custom ellipsis

truncate benötigt einen optionalen zweiten Parameter, der die Zeichenfolge angibt, die an die abgeschnittene Zeichenfolge angehängt werden soll. Standardmäßig ist dies eine Ellipse (. . . ), aber Sie können auch eine andere Reihenfolge angeben.

Die Länge des zweiten Parameters zählt gegen die Anzahl der durch den ersten Parameter angegebenen Zeichen. Wenn Sie z. B. eine Zeichenkette auf genau 10 Zeichen kürzen und eine Ellipse mit 3 Zeichen verwenden möchten, verwenden Sie 13 für den ersten Parameter von truncate, da die Ellipse als 3 Zeichen zählt.

{{ 'ABCDEFGHIJKLMNOPQRSTUVWXYZ' | truncate: 18, ', und so weiter' }}

ABCDEFG, und so weiter

No ellipsis

Durch die Übergabe einer leeren Zeichenkette als zweiten Parameter können Sie auf die exakte Anzahl der im ersten Parameter angegebenen Zeichen kürzen und keine nachstehenden Zeichen anzeigen:

{{ "Ich bin eine kleine Teekanne, klein und stämmig." | truncate: 15, '' }}

Ich bin ein wenig te

truncatewords

Schneidet eine Zeichenkette auf die Anzahl der als ersten Parameter übergebenen Wörter ab. Eine Ellipse (. . . ) wird an die abgeschnittene Zeichenfolge angehängt.

{{ 'Die Katze kam schon am nächsten Tag zurück' | truncatewords: 4 }}

Die Katze kam zurück...

Custom ellipsis

truncatewords benötigt einen optionalen zweiten Parameter, der die Zeichenfolge angibt, die an die abgeschnittene Zeichenfolge angehängt werden soll. Standardmäßig ist dies eine Ellipse (. . . ), aber Sie können auch eine andere Reihenfolge angeben.

{{ 'Die Katze kam schon am nächsten Tag zurück' | truncatewords: 4, '--' }}

Die Katze kam zurück--

No ellipsis

Sie können die Anzeige nachfolgender Zeichen vermeiden, indem Sie eine leere Zeichenfolge als zweiten Parameter übergeben:

{{ 'Die Katze kam schon am nächsten Tag zurück' | truncatewords: 4, '' }}

Die Katze kam zurück

upcase

Konvertiert eine Zeichenkette in Großbuchstaben.

{{ 'i want this to be großbuchstaben' | upcase }}

I WANT THIS TO BE UPPERDESE

url_encode

Wandelt alle URL-unsicheren Zeichen in einer Zeichenkette in prozentual kodierte Zeichen um.

{{ 'john@liquid.com' | url_encode }}

john%40liquid.com

Beachten Sie, dass url_encode ein Leerzeichen in ein + Zeichen anstelle eines prozentual kodierten Zeichens umwandelt.

{{ 'Friederike Brinker' | url_encode }}

Friederike+Brinker

url_escape

Identifiziert alle Zeichen in einer Zeichenkette, die in URLS nicht erlaubt sind, und ersetzt die Zeichen durch ihre escapeten Varianten.

{{ '
 <hello>
   & 
  <shopify>
   ' | url_escape }} 
  </shopify>
 </hello>

%3Chello%3E%20&%20%3Cshopify%3E

url_param_escape

Ersetzt alle Zeichen in einer Zeichenfolge, die in URLs nicht zulässig sind, durch ihre maskierten Varianten, einschließlich des kaufmännischen Und (&).

{{ '
 <hello>
   & 
  <shopify>
   ' | url_param_escape }} 
  </shopify>
 </hello>

%3Chello%3E%20%26%20%3Cshopify%3E

Reversing strings

reverse kann nicht direkt auf eine Zeichenkette angewendet werden, aber Sie können eine Zeichenkette in ein Array aufteilen, das Array umkehren und es durch Verkettung anderer Filter wieder zusammenfügen:

{{ 'Bodenkontrolle an Lutz Mack.' | split: '' | reverse | join: '' }}

.moT rojaM ot lortnoc dnuorG
Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.