Dokumentation Entwickler Liquid Referenz Filter

Text

Aktualisiert am 16.03.2017

translate

Alias: t

Gibt den passenden Text aus der entsprechenden Sprachdatei aus. Näheres zu den Sprachdateien siehe locales

Syntax

schlüssel | t: variable: wert

Sind keine Variablen in dem auszugebenen Text vorhanden, entfallen die Parameter “variable: wert”. Sind mehrere Variablen vorhanden, werden diese “variable: wert”-Paare mit Komma getrennt angegeben (siehe zweites Beispiel).

Beispiel

{{ 'general.404.title' | t }}

Ausgabe

404 Seite nicht gefunden

Beispiel

{{ 'blogs.article.author_on_date_html' | t: author: 'Hans', date: '12.05.2014' }}

Anmerkung: Eintrag in der de.json sieht wie folgt aus:

{
...
"blogs": {
"article": {
author_on_date_html": "Geposted von <span class="cp">{{</span> <span class="nv">author</span> <span class="cp">}}</span> am <span class="cp">{{</span> <span class="nv">date</span> <span class="cp">}}</span>
}
},
...
}

Ausgabe

Geposted von Hans am 12.05.2014



Inhalt

append

Syntax:
{{ text | append suffix }}
Beispiel:
{{ 'angebot' | append: '.jpg' }}
Ausgabe:
angebot.jpg

camelize

Syntax:
{{ text | camelize }}
Beispiel:
<h1>{{ "origami_kranich" | camelize }}</h1>
Ausgabe:
<h1>OrigamiKranich</h1>

capitalize

capitalize

Syntax:
{{ text | capitalize }}
Beispiel:
<h1>{{ "origami kranich" | capitalize }}</h1>
Ausgabe:
<h1>Origami kranich</h1>

chars

Syntax:
{{ text | chars: start, ende }}
Beispiel:
{{ "Regal" | chars: 1, 4 }}
Ausgabe:
egal

clean_text

Syntax:
{{ text | clean_text }}
Beispiel:
{{ '<p>Text; Abgetrennt durch Leerzeichen mit einem Tab am Ende    !</p>' | clean_text }}
Ausgabe:
Text, Abgetrennt durch Leerzeichen mit einem Tab am Ende !

convert_umlauts

Syntax:
{{ text | convert_umlauts }}
Beispiel:
{{ "ä ü ö Ä Ü Ö" | convert_umlauts }}
Ausgabe:
ae ue oe ae ue oe

date

Syntax:
{{ date | date format }}

%a - Abgekürzter Name des Wochentages ('Son')
%A - Kompletter Name des Wochentages ('Sonntag')
%b - Abgekürzter Name des Monats ('Jan')
%B - Kompletter Name des Monats ('Januar')
%d - Tag des Monats (01..31)
%H - Stunde des Tages, 24h (00..23)
%I - Stunde des Tages, 12h (01..12)
%j - Tag des Jahres (001..366)
%m - Monat des Jahres (01..12)
%M - Minute der Stunde (00..59)
%p - Morgens / Abends ('AM' oder 'PM')
%S - Sekunde der Minute (00..60)
%W - Kalenderwoche (00..53)
%y - Jahr, zweistellig (00..99)
%Y - Jahr, vierstellig (zB 2010)
%Z - Name der Zeitzone
%% - Prozentzeichen
Beispiel:
Das heutige Datum ist: {{ now | date: "%d.%m.%Y" }}
Ausgabe:
Das heutige Datum ist: 29.10.2009

downcase

Syntax:
{{%nbsp;text | downcase }}
Beispiel:
<h1>{{ Origami Kranich | downcase }}</h1>
Ausgabe:
<h1>origami kranich</h1>

encode_url

Syntax:
{{ text | encode_url }}
Beispiel:
{{ 'Ein Text für die URL' | encode_url }}
Ausgabe:
Ein+Text+f%C3%BCr+die+URL

ensure

Syntax:
{{%nbsp;text | ensure: fallback_text }}
Beispiel:
{{ 'Ein Text zur Ausgabe' | ensure: 'Die Eingabe war leer' }}
{{ "" | ensure: 'Die Eingabe war leer' }}
Ausgabe:
Ein Text zur Ausgabe
Die Eingabe war leer

fill_up_to

Syntax:
{{ text | fill_up_to: anzahl, füllzeichen }}
Beispiel:
{{ 'Lorem ipsum' | fill_up_to: 20, '.' }}
Ausgabe:
Lorem ipsum.........

handleize

Syntax:
{{ text | handleize }}
Beispiel:
{{ 'Hübsche rote Mütze' | handleize }}
Ausgabe:
huebsche-rote-muetze

json

Syntax:
{{%nbsp;text | json }}
Beispiel:
{{ 'Text' | json }}
Ausgabe:
Text

Wichtig sind hier die doppelten Anführungszeichen:

md5

Syntax:
{{ text | md5 }}
Beispiel:
{{ 'Hallo Welt' | md5 }}
Ausgabe:
5c372a32c9ae748a4c040ebadc51a829

newline_to_br

Syntax:
{{ text | newline_to_br }}
Beispiel:
<tbody>
<tr>
<td>
<div>1</div>
<div>2</div>
</td>
<td>
<div>
{% assign eingabe="Das ist eine
aktuelle
Produktbeschreibung" %}
<div></div>
</div>
</td>
</tr>
</tbody>
Ausgabe:
<tbody>
<tr>
<td>
<div>1</div>
</td>
<td>
<div>
<div>Das ist eine
aktuelle
Produktbeschreibung</div>
</div>
</td>
</tr>
</tbody>

numbers_only

Syntax:
{{ text | numbers_only }}
Beispiel:
{{ 'A123R' | numbers_only }}
Ausgabe:
123

parenthesize

Syntax:
{{ text | parenthesize }}
Beispiel:
{{ 'Ein Text der in Klammern gehört' | parenthesize }}
Ausgabe:
(Ein Text der in Klammern gehört)

pluralize

{{ count | pluralize singular, plural }}
Ausgabe:
2 Produkte

Beispiel

Bei counter = 2

prepend

Syntax:
{{ suffix| prepend text }}
Beispiel:
{{ '.jpg' | prepend: 'angebot' }}
Ausgabe:
angebot.jpg

remove

Syntax:
{{ text | remove: substring }}
Beispiel:
{{ 'Markus trinkt niemals Kaffee!' | remove: 'niemals' }}
Ausgabe:
Markus trinkt Kaffee!

remove_first

Syntax:
{{ text | remove_first: substring }}
Beispiel:
{{ 'Markus trinkt niemals Kaffee niemals!' | remove_first: 'niemals' }}
Ausgabe:
Markus trinkt Kaffee niemals!

replace

Syntax:
{{%nbsp;text | replace: substring, replacement }}
Beispiel:
{{ 'Markus trinkt niemals Kaffee!' | replace: 'niemals', 'gerne' }}
Ausgabe:
Markus trinkt gerne Kaffee!

replace_first

Syntax:
{{ text | replace_first: substring, replacement }}
Beispiel:
{{ 'Markus trinkt niemals Kaffee niemals!' | replace_first: 'niemals', 'normalerweise' }}
Ausgabe:
Markus trinkt normalerweise Kaffee niemals!

split

Syntax:
{{%nbsp;text | split: delimiter }}
Beispiel:
{% assign words = "Kaffee, Cola und schwarzer Tee sind koffeinhaltig" | split: ' ' %}
Erstes Wort: 
Erstes Wort: {{ words[0] }}
Zweites Wort: {{ words[1] }}
Letztes Wort: 
Alle Wörter: 

{% for word in words %}

{% endfor %}
Ausgabe:
Erstes Wort: Kaffee,
Erstes Wort: Kaffee,
Zweites Wort: Cola
Letztes Wort: koffeinhaltig
Alle Wörter: Kaffee,, Cola, und, schwarzer, Tee, sind, koffeinhaltig

strip

Syntax:
{{ text | strip }}
Beispiel:
{{ '   Text mit viel Platz drumherum    ' | strip }}
Ausgabe:
Text mit viel Platz drumherum

strip_emptylines

Syntax:
{{ text | strip_emptylines }}
Beispiel:
<tbody>
<tr>
<td>
<div>1</div>
<div>2</div>
</td>
<td>
<div>
{% assign eingabe="Das ist eine
aktuelle

Produktbeschreibung" %}
<div></div>
</div>
</td>
</tr>
</tbody>
Ausgabe:
<tbody>
<tr>
<td>
<div>1</div>
</td>
<td>
<div>
<div>Das ist eine
aktuelle
Produktbeschreibung</div>
</div>
</td>
</tr>
</tbody>

strip_html

Syntax:
{{ text | strip_html }}
Beispiel:
{% assign eingabe="<p>Das ist eine <strong>aktuelle</strong> Produktbeschreibung.</p>" %}
{{ eingabe | strip_html}}
Ausgabe:
Das ist eine aktuelle Produktbeschreibung.

strip_newlines

Syntax:
{{ text | strip_newlines }}
Beispiel:
{% assign eingabe="Das ist eine
aktuelle
Produktbeschreibung." %}
Ausgabe:
Das ist eine aktuelle Produktbeschreibung.

to_sentence

Syntax:
{{ liste | to_sentence }}
Beispiel:
{% assign kaffekraenzchen = "Kekse Kuchen Kaffee Tee" %}
{{ kaffekraenzchen | words | to_sentence }}
Ausgabe:
Kekse, Kuchen, Kaffee und Tee

translate

Sind keine Variablen in dem auszugebenen Text vorhanden, entfallen die Parameter “variable: wert”. Sind mehrere Variablen vorhanden, werden diese “variable: wert”-Paare mit Komma getrennt angegeben.

Syntax:
{{ schlüssel | t: variable: wert }}
Beispiel:
{{ 'general.404.title' | t }}
Ausgabe:
404 Seite nicht gefunden

truncate

Syntax:
{{ text | truncate: size }}
Beispiel:
 {% assign eingabe="<p>Das ist eine <strong>aktuelle</strong> Produktbeschreibung</p>" %}
Ausgabe:
Das ist eine akt...

truncate_words

Syntax:
{{ text | truncatewords: size }}
Beispiel:
{% assign eingabe="<p>Das ist eine <strong>aktuelle</strong> Produktbeschreibung</p>" %}
{{ eingabe | strip_html | truncatewords: 3 }}
Ausgabe:
Das ist eine...

Weitere Hinweise:

Seien Sie vorsichtig, wenn Sie Zeichenketten mit HTML-Tags kürzen wollen. Sie sollten dann vorab strip_html nutzen. Zum kürzen eines Textes auf eine bestimmte Buchstabenlänge, verwenden Sie truncate.

upcase

Syntax:
{{ text | upcase }}
Beispiel:
<h1></h1>
Ausgabe:
<h1>ORIGAMI KRANICH</h1>

words

Syntax:
{{ text | words }}
Beispiel:
{% assign sentence = "Dies ist ein Text mit mehreren Wörtern" %}
{{ sentence | words | join: ', ' }}
Ausgabe:
Dies, ist, ein, Text, mit, mehreren, Wörtern

titleize

titleize

Syntax:
{{ text | titleize }}
Beispiel:
<h1>{{ "origami kranich" | titleize }}</h1>
Ausgabe:
<h1>Origami Kranich</h1>