Latte Filtern

Filter sind Funktionen, die die Daten in der gewünschten Form verändern oder formatieren. Dies ist eine Zusammenfassung der eingebauten Filter, die verfügbar sind.

Es gibt auch Escape-Filter für HTML (escapeHtml und escapeHtmlComment), XML (escapeXml), JavaScript (escapeJs), CSS (escapeCss) und iCalendar (escapeICal), die Latte dank kontextsensitivem Escaping selbst verwendet und die Sie nicht schreiben müssen.

Latte der src und href Attribute prüft automatisch, so dass Sie den checkUrl Filter fast nicht verwenden müssen.

Alle eingebauten Filter arbeiten mit UTF-8 kodierten Zeichenketten.

Verwendung

Latte erlaubt den Aufruf von Filtern unter Verwendung der Pipe-Schreibweise (vorangestelltes Leerzeichen ist erlaubt):

<h1>{$heading|upper}</h1>

Filter können verkettet werden, in diesem Fall gelten sie in der Reihenfolge von links nach rechts:

<h1>{$heading|lower|capitalize}</h1>

Die Parameter werden durch Doppelpunkt oder Komma getrennt hinter den Filternamen gesetzt:

<h1>{$heading|truncate:20,''}</h1>

Filter können auf Ausdrücke angewendet werden:

{var $name = ($title|upper) . ($subtitle|lower)}</h1>

Benutzerdefinierte Filter können auf diese Weise registriert werden:

$latte = new Latte\Engine;
$latte->addFilter('shortify', fn(string $s, int $len = 10) => mb_substr($s, 0, $len));

Wir verwenden sie in einer Vorlage wie dieser:

<p>{$text|shortify}</p>
<p>{$text|shortify:100}</p>

Filter

batch (int length, mixed item): array

Filter, der die Auflistung von linearen Daten in Form einer Tabelle vereinfacht. Er gibt ein Array von Arrays mit der angegebenen Anzahl von Elementen zurück. Wenn Sie einen zweiten Parameter angeben, wird dieser verwendet, um fehlende Elemente in der letzten Zeile aufzufüllen.

{var $items = ['a', 'b', 'c', 'd', 'e']}
<table>
{foreach ($items|batch: 3, 'No item') as $row}
	<tr>
		{foreach $row as $column}
			<td>{$column}</td>
		{/foreach}
	</tr>
{/foreach}
</table>

Druckt:

<table>
	<tr>
		<td>a</td>
		<td>b</td>
		<td>c</td>
	</tr>
	<tr>
		<td>d</td>
		<td>e</td>
		<td>No item</td>
	</tr>
</table>

breakLines

Fügt HTML-Zeilenumbrüche vor allen Zeilenumbrüchen ein.

{var $s = "Text & with \n newline"}
{$s|breakLines}    {* gibt "Text &amp; with <br>\n newline" *}

bytes (int precision = 2)

Formatiert eine Größe in Bytes in eine für Menschen lesbare Form.

{$size|bytes}     0 B, 1.25 GB, …
{$size|bytes:0}   10 B, 1 GB, …

ceil (int precision = 0)

Rundet eine Zahl bis zu einer bestimmten Genauigkeit.

{=3.4|ceil}         {* gibt 4      *}
{=135.22|ceil:1}    {* gibt 135.3  *}
{=135.22|ceil:3}    {* gibt 135.22 *}

Siehe auch Stockwerk, Runden.

capitalize

Gibt eine Version des Wertes in Großbuchstaben zurück. Die Wörter beginnen mit Großbuchstaben, alle übrigen Zeichen sind Kleinbuchstaben. Erfordert die PHP-Erweiterung mbstring.

{='i like LATTE'|capitalize}  {* gibt 'I Like Latte' *}

Siehe auch firstUpper, lower, upper.

checkUrl

Erzwingt URL-Sanitization. Sie prüft, ob die Variable eine Web-URL enthält (d. h. HTTP/HTTPS-Protokoll) und verhindert das Schreiben von Links, die ein Sicherheitsrisiko darstellen könnten.

{var $link = 'javascript:window.close()'}
<a data-href="{$link|checkUrl}">checked</a>
<a data-href="{$link}">unchecked</a>

Druckt:

<a data-href="">checked</a>
<a data-href="javascript:window.close()">unchecked</a>

Siehe auch nocheck.

clamp (int|float min, int|float max)

Gibt einen Wert zurück, der auf den einschließenden Bereich von min und max geklemmt ist.

{$level|clamp: 0, 255}

Existiert auch als Funktion.

dataStream (string mimetype = detect)

Konvertiert den Inhalt in ein Daten-URI-Schema. Es kann verwendet werden, um Bilder in HTML oder CSS einzufügen, ohne dass externe Dateien verlinkt werden müssen.

Nehmen wir an, ein Bild befindet sich in einer Variablen $img = Image::fromFile('obrazek.gif'), dann

<img src="{$img|dataStream}">

Druckt zum Beispiel:

<img src="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAUA
AAAFCAYAAACNbyblAAAAHElEQVQI12P4//8/w38GIAXDIBKE0DHxgljNBAAO
9TXL0Y4OHwAAAABJRU5ErkJggg==">

Erfordert die PHP-Erweiterung fileinfo.

date (string format)

Liefert ein Datum im angegebenen Format unter Verwendung der Optionen der PHP-Funktionen strftime oder date. Der Filter erhält ein Datum als UNIX-Zeitstempel, als String oder als Objekt vom Typ DateTime.

{$today|date:'%d.%m.%Y'}
{$today|date:'j. n. Y'}

escapeUrl

Entfernt eine Variable, die als Parameter in einer URL verwendet werden soll.

<a href="http://example.com/{$name|escapeUrl}">{$name}</a>

Siehe auch Abfrage.

explode (string separator = '')

Teilt eine Zeichenkette durch den angegebenen Begrenzer und gibt ein Array von Zeichenketten zurück. Alias für split.

{='one,two,three'|explode:','}    {* liefert ['one', 'two', 'three'] *}

Wenn das Trennzeichen eine leere Zeichenkette ist (Standardwert), wird die Eingabe in einzelne Zeichen aufgeteilt:

{='123'|explode}                  {* liefert ['1', '2', '3'] *}

Sie können auch den Alias split verwenden:

{='1,2,3'|split:','}              {* liefert ['1', '2', '3'] *}

Siehe auch implode.

first

Gibt das erste Element eines Arrays oder ein Zeichen einer Zeichenkette zurück:

{=[1, 2, 3, 4]|first}    {* gibt 1 *}
{='abcd'|first}          {* gibt 'a' *}

Siehe auch last, random.

floor (int precision = 0)

Rundet eine Zahl auf eine bestimmte Genauigkeit ab.

{=3.5|floor}        {* gibt 3      *}
{=135.79|floor:1}   {* gibt 135.7  *}
{=135.79|floor:3}   {* gibt 135.79 *}

Siehe auch ceil, round.

firstUpper

Konvertiert den ersten Buchstaben eines Wertes in Großbuchstaben. Erfordert die PHP-Erweiterung mbstring.

{='the latte'|firstUpper}  {* gibt 'The latte' *}

Siehe auch capitalize, lower, upper.

implode (string glue = '')

Gibt eine Zeichenkette zurück, die die Verkettung der Zeichenketten im Array ist. Alias für join.

{=[1, 2, 3]|implode}      {* gibt '123' *}
{=[1, 2, 3]|implode:'|'}  {* gibt '1|2|3' *}

Sie können auch einen Alias join verwenden:

{=[1, 2, 3]|join}         {* gibt '123' *}

indent (int level = 1, string char = "\t")

Rückt einen Text von links um eine bestimmte Anzahl von Tabulatoren oder anderen Zeichen ein, die wir im zweiten optionalen Argument angeben. Leerzeilen werden nicht eingerückt.

<div>
{block |indent}
<p>Hello</p>
{/block}
</div>

Druckt:

<div>
	<p>Hello</p>
</div>

last

Gibt das letzte Element eines Arrays oder ein Zeichen einer Zeichenkette zurück:

{=[1, 2, 3, 4]|last}    {* gibt 4 *}
{='abcd'|last}          {* gibt 'd' *}

Siehe auch first, random.

length

Gibt die Länge einer Zeichenkette oder eines Arrays zurück.

• bei Strings wird die Länge in UTF-8 Zeichen zurückgegeben
• für Arrays wird die Anzahl der Elemente zurückgegeben
• bei Objekten, die die Schnittstelle Countable implementieren, wird der Rückgabewert der Funktion count() verwendet
• für Objekte, die die Schnittstelle IteratorAggregate implementieren, wird der Rückgabewert von iterator_count() verwendet.

{if ($users|length) > 10}
	...
{/if}

lower

Konvertiert einen Wert in Kleinbuchstaben. Erfordert die PHP-Erweiterung mbstring.

{='LATTE'|lower}   {* gibt 'latte' *}

Siehe auch capitalize, firstUpper, upper.

nocheck

Verhindert die automatische URL-Sanitization. Latte prüft automatisch, ob die Variable eine Web-URL enthält (d.h. HTTP/HTTPS-Protokoll) und verhindert das Schreiben von Links, die ein Sicherheitsrisiko darstellen könnten.

Wenn der Link ein anderes Schema verwendet, z. B. javascript: oder data:, und Sie sich des Inhalts sicher sind, können Sie die Prüfung über |nocheck deaktivieren.

{var $link = 'javascript:window.close()'}

<a href="{$link}">checked</a>
<a href="{$link|nocheck}">unchecked</a>

Drucke:

<a href="">checked</a>
<a href="javascript:window.close()">unchecked</a>

Siehe auch checkUrl.

noescape

Deaktiviert das automatische Escaping.

{var $trustedHtmlString = '<b>hello</b>'}
Escaped: {$trustedHtmlString}
Unescaped: {$trustedHtmlString|noescape}

Druckt:

Escaped: <b>hello</b>
Unescaped: <b>hello</b>

Die missbräuchliche Verwendung des noescape Filters kann zu einer XSS-Schwachstelle führen! Verwenden Sie ihn nur, wenn Sie absolut sicher sind, was Sie tun und dass die Zeichenfolge, die Sie drucken, aus einer vertrauenswürdigen Quelle stammt.

number (int decimals = 0, string decPoint = '.', string thousandsSep = ',')

Formatiert eine Zahl auf eine bestimmte Anzahl von Dezimalstellen. Sie können auch ein Zeichen für den Dezimalpunkt und das Tausendertrennzeichen angeben.

{1234.20 |number}              1,234
{1234.20 |number:1}            1,234.2
{1234.20 |number:2}            1,234.20
{1234.20 |number:2, ',', ' '}  1 234,20

padLeft (int length, string pad = ' ')

Füllt eine Zeichenkette bis zu einer bestimmten Länge mit einer anderen Zeichenkette von links auf.

{='hello'|padLeft: 10, '123'}  {* gibt '12312hello' *}

padRight (int length, string pad = ' ')

Füllt eine Zeichenfolge auf eine bestimmte Länge mit einer anderen Zeichenfolge von rechts.

{='hello'|padRight: 10, '123'}  {* gibt 'hello12312' *}

query

Erzeugt dynamisch eine Abfragezeichenfolge in der URL:

<a href="http://example.com/?{[name: 'John Doe', age: 43]|query}">click</a>
<a href="http://example.com/?search={$search|query}">search</a>

Druckt:

<a href="http://example.com/?name=John+Doe&amp;age=43">click</a>
<a href="http://example.com/?search=Foo+Bar">search</a>

Tasten mit einem Wert von null werden ausgelassen.

Siehe auch escapeUrl.

random

Gibt ein zufälliges Element eines Arrays oder ein Zeichen einer Zeichenkette zurück:

{=[1, 2, 3, 4]|random}    {* example output: 3 *}
{='abcd'|random}          {* example output: 'b' *}

Siehe auch first, last.

repeat (int count)

Wiederholt die Zeichenkette x-mal.

{='hello'|repeat: 3}  {* gibt 'hellohellohello' *}

replace (string|array search, string replace = '')

Ersetzt alle Vorkommen der Suchzeichenfolge durch die Ersatzzeichenfolge.

{='hello world'|replace: 'world', 'friend'}  {* gibt 'hello friend' *}

Es können mehrere Ersetzungen auf einmal vorgenommen werden:

{='hello world'|replace: [h => l, l => h]}  {* gibt 'lehho worhd' *}

replaceRE (string pattern, string replace = '')

Ersetzt alle Vorkommen entsprechend dem regulären Ausdruck.

{='hello world'|replaceRE: '/l.*/', 'l'}  {* gibt 'hel' *}

reverse

Kehrt eine gegebene Zeichenkette oder ein gegebenes Array um.

{var $s = 'Nette'}
{$s|reverse}    {* gibt 'etteN' *}
{var $a = ['N', 'e', 't', 't', 'e']}
{$a|reverse}    {* liefert ['e', 't', 't', 'e', 'N'] *}

round (int precision = 0)

Rundet eine Zahl auf eine bestimmte Genauigkeit.

{=3.4|round}        {* gibt 3      *}
{=3.5|round}        {* gibt 4      *}
{=135.79|round:1}   {* gibt 135.8  *}
{=135.79|round:3}   {* gibt 135.79 *}

Siehe auch ceil, floor.

slice (int start, int length = null, bool preserveKeys = false)

Extrahiert einen Ausschnitt aus einem Array oder einer Zeichenkette.

{='hello'|slice: 1, 2}           {* gibt 'el' *}
{=['a', 'b', 'c']|slice: 1, 2}   {* gibt ['b', 'c'] *}

Der Slice-Filter funktioniert wie die PHP-Funktion array_slice für Arrays und mb_substr für Strings mit einem Fallback auf iconv_substr im UTF-8-Modus.

Wenn start nicht negativ ist, beginnt die Sequenz an diesem Anfang in der Variablen. Wenn start negativ ist, beginnt die Sequenz so weit vom Ende der Variablen entfernt.

Wenn length angegeben wird und positiv ist, wird die Sequenz bis zu dieser Anzahl von Elementen enthalten. Wenn die Variable kürzer als die Länge ist, werden nur die verfügbaren Elemente der Variablen angezeigt. Wenn length angegeben wird und negativ ist, endet die Sequenz so viele Elemente vor dem Ende der Variablen. Wird sie weggelassen, enthält die Sequenz alle Elemente vom Offset bis zum Ende der Variablen.

Filter ordnet die Schlüssel des Integer-Arrays standardmäßig neu an und setzt sie zurück. Dieses Verhalten kann geändert werden, indem preserveKeys auf true gesetzt wird. String-Schlüssel werden immer beibehalten, unabhängig von diesem Parameter.

sort

Filter, der ein Array sortiert und die Indexzuordnung beibehält.

{foreach ($names|sort) as $name}
	...
{/foreach}

Array in umgekehrter Reihenfolge sortiert.

{foreach ($names|sort|reverse) as $name}
	...
{/foreach}

Sie können Ihre eigene Vergleichsfunktion als Parameter übergeben:

{var $sorted = ($names|sort: fn($a, $b) => $b <=> $a)}

spaceless

Entfernt unnötige Leerzeichen aus der Ausgabe. Sie können auch den Alias strip verwenden.

{block |spaceless}
	<ul>
		<li>Hello</li>
	</ul>
{/block}

Druckt:

<ul> <li>Hello</li> </ul>

stripHtml

Konvertiert HTML in einfachen Text. Das heißt, es werden HTML-Tags entfernt und HTML-Elemente in Text umgewandelt.

{='<p>one &lt; two</p>'|stripHtml}  {* gibt 'one < two' *}

Der resultierende reine Text kann natürlich Zeichen enthalten, die HTML-Tags darstellen, zum Beispiel wird '<p>'|stripHtml in <p>. Geben Sie den resultierenden Text niemals mit |noescape aus, da dies zu einer Sicherheitslücke führen kann.

substr (int offset, int length = null)

Extrahiert einen Ausschnitt aus einer Zeichenkette. Dieser Filter wurde durch einen Slice-Filter ersetzt.

{$string|substr: 1, 2}

translate (string message, …args)

Er übersetzt Ausdrücke in andere Sprachen. Um den Filter verfügbar zu machen, müssen Sie den Übersetzer ein richten. Sie können auch die Tags für die Übersetzung verwenden.

<a href="basket">{='Baskter'|translate}</a>
<span>{$item|translate}</span>

trim (string charlist = " \t\n\r\0\x0B\u{A0}")

Entfernen Sie führende und nachgestellte Zeichen, standardmäßig Leerzeichen.

{='  I like Latte.  '|trim}    {* gibt 'I like Latte.' *}
{='  I like Latte.'|trim: '.'} {* gibt '  I like Latte' *}

truncate (int length, string append = '…')

Kürzt eine Zeichenkette auf die maximal angegebene Länge, versucht aber, ganze Wörter zu erhalten. Wenn die Zeichenkette abgeschnitten ist, wird am Ende ein Auslassungszeichen hinzugefügt (dies kann durch den zweiten Parameter geändert werden).

{var $title = 'Hello, how are you?'}
{$title|truncate:5}  {* Hell…                *}
{$title|truncate:17} {* Hello, how are…      *}
{$title|truncate:30} {* Hello, how are you?  *}

upper

Konvertiert einen Wert in Großbuchstaben. Erfordert die PHP-Erweiterung mbstring.

{='latte'|upper}  {* gibt 'LATTE' *}

Siehe auch capitalize, firstUpper, lower.

webalize

Konvertiert nach ASCII.

Konvertiert Leerzeichen in Bindestriche. Entfernt Zeichen, die keine alphanumerischen Zeichen, Unterstriche oder Bindestriche sind. Konvertiert in Kleinbuchstaben. Entfernt auch führende und nachfolgende Leerzeichen.

{var $s = 'Our 10. product'}
{$s|webalize}    {* gibt 'our-10-product' *}

Erfordert das Paket nette/utils.