Latte Filter

In Templates können wir Funktionen verwenden, die bei der Anpassung oder Umformatierung von Daten in die endgültige Form helfen. Wir nennen sie Filter.

Transformation
batch Auflistung linearer Daten in einer Tabelle
breakLines Fügt HTML-Zeilenumbrüche am Ende der Zeilen hinzu
bytes formatiert die Größe in Bytes
clamp begrenzt einen Wert auf einen bestimmten Bereich
dataStream Konvertierung für das Data URI-Protokoll
date formatiert Datum und Uhrzeit
explode teilt eine Zeichenkette in ein Array anhand eines Trennzeichens
first gibt das erste Element eines Arrays oder Zeichen einer Zeichenkette zurück
group gruppiert Daten nach verschiedenen Kriterien
implode verbindet ein Array zu einer Zeichenkette
indent rückt Text von links um eine bestimmte Anzahl von Tabulatoren ein
join verbindet ein Array zu einer Zeichenkette
last gibt das letzte Element eines Arrays oder Zeichen einer Zeichenkette zurück
length gibt die Länge einer Zeichenkette in Zeichen oder eines Arrays zurück
localDate formatiert Datum und Uhrzeit entsprechend den Ländereinstellungen
number formatiert eine Zahl
padLeft füllt eine Zeichenkette links auf eine bestimmte Länge auf
padRight füllt eine Zeichenkette rechts auf eine bestimmte Länge auf
random gibt ein zufälliges Element eines Arrays oder Zeichen einer Zeichenkette zurück
repeat Wiederholung einer Zeichenkette
replace ersetzt Vorkommen einer gesuchten Zeichenkette
replaceRE ersetzt Vorkommen anhand eines regulären Ausdrucks
reverse kehrt eine UTF-8 Zeichenkette oder ein Array um
slice extrahiert einen Teil eines Arrays oder einer Zeichenkette
sort sortiert ein Array
spaceless entfernt Leerzeichen, ähnlich wie das spaceless Tag
split teilt eine Zeichenkette in ein Array anhand eines Trennzeichens
strip entfernt Leerzeichen
stripHtml entfernt HTML-Tags und konvertiert HTML-Entities in Zeichen
substr gibt einen Teil einer Zeichenkette zurück
trim entfernt führende und abschließende Leerzeichen oder andere Zeichen
translate Übersetzung in andere Sprachen
truncate kürzt die Länge unter Beibehaltung von Wörtern
webalize passt eine UTF-8 Zeichenkette in eine in URLs verwendete Form an
Groß-/Kleinschreibung
capitalize Kleinbuchstaben, erste Buchstaben der Wörter groß
firstUpper konvertiert den ersten Buchstaben in einen Großbuchstaben
lower konvertiert in Kleinbuchstaben
upper konvertiert in Großbuchstaben
Rundung
ceil rundet eine Zahl auf eine bestimmte Genauigkeit auf
floor rundet eine Zahl auf eine bestimmte Genauigkeit ab
round rundet eine Zahl auf eine bestimmte Genauigkeit
Escaping
escapeUrl escapet einen Parameter in einer URL
noescape gibt eine Variable ohne Escaping aus
query generiert einen Query-String in einer URL

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

Sicherheit
checkUrl behandelt eine URL-Adresse gegen gefährliche Eingaben
nocheck verhindert die automatische Behandlung einer URL-Adresse

Latte überprüft automatisch die Attribute src und href, sodass Sie den checkUrl-Filter fast nie verwenden müssen.

Alle Standard-Filter sind für Zeichenketten in UTF-8-Kodierung ausgelegt.

Verwendung

Filter werden durch einen senkrechten Strich notiert (vor dem ein Leerzeichen stehen kann):

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

Filter (in älteren Versionen Helper genannt) können verkettet werden und werden dann in der Reihenfolge von links nach rechts angewendet:

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

Parameter werden nach dem Filternamen durch Doppelpunkte oder Kommas getrennt angegeben:

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

Filter können auch 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));

Im Template wird es dann so aufgerufen:

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

Filter

batch (int $length, mixed $item)array

Ein Filter, der die Ausgabe linearer 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 er verwendet, um fehlende Elemente in der letzten Zeile zu ergänzen.

{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>

Gibt aus:

<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>

Siehe auch group und das iterateWhile Tag.

breakLines

Fügt vor jedem Zeilenumbruchzeichen ein HTML-Tag <br> ein

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

bytes (int $precision=2)

Formatiert die Größe in Bytes in eine menschenlesbare Form. Wenn Ländereinstellungen gesetzt sind, werden die entsprechenden Dezimal- und Tausendertrennzeichen verwendet.

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

ceil (int $precision=0)

Rundet eine Zahl auf eine bestimmte Genauigkeit auf.

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

Siehe auch floor, round.

capitalize

Wörter beginnen mit Großbuchstaben, alle verbleibenden Zeichen sind klein. Erfordert die PHP-Erweiterung mbstring.

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

Siehe auch firstUpper, lower, upper.

checkUrl

Erzwingt die Behandlung einer URL-Adresse. Überprüft, ob die Variable eine Web-URL enthält (d.h. HTTP/HTTPS-Protokoll) und verhindert die Ausgabe von Links, die ein Sicherheitsrisiko darstellen können.

{var $link = 'javascript:window.close()'}
<a data-href={$link|checkUrl}>geprüft</a>
<a data-href={$link}>ungeprüft</a>

Gibt aus:

<a data-href="">geprüft</a>
<a data-href="javascript:window.close()">ungeprüft</a>

Siehe auch nocheck.

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

Begrenzt einen Wert auf den angegebenen inklusiven Bereich von min und max.

{$level|clamp: 0, 255}

Existiert auch als Funktion.

dataStream (string $mimetype=detect)

Konvertiert den Inhalt in das Data URI-Schema. Damit können Bilder ohne die Notwendigkeit externer Dateien in HTML oder CSS eingebettet werden.

Angenommen, wir haben ein Bild in der Variable $img = Image::fromFile('bild.gif'), dann

<img src={$img|dataStream}>

Gibt beispielsweise aus:

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

Erfordert die PHP-Erweiterung fileinfo.

date (string $format)

Formatiert Datum und Uhrzeit gemäß der von der PHP-Funktion date verwendeten Maske. Der Filter akzeptiert Datum im UNIX-Timestamp-Format, als Zeichenkette oder als Objekt vom Typ DateTimeInterface.

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

Siehe auch localDate.

escapeUrl

Escapet eine Variable zur Verwendung als Parameter in einer URL.

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

Siehe auch query.

explode (string $separator='')

Teilt eine Zeichenkette anhand eines Trennzeichens in ein Array. Alias für split.

{='one,two,three'|explode:','}    {* gibt ['one', 'two', 'three'] zurück *}

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

{='123'|explode}                  {* gibt ['1', '2', '3'] zurück *}

Sie können auch den Alias split verwenden:

{='1,2,3'|split:','}              {* gibt ['1', '2', '3'] zurück *}

Siehe auch implode.

first

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

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

Siehe auch last, random.

floor (int $precision=0)

Rundet eine Zahl auf eine bestimmte Genauigkeit ab.

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

Siehe auch ceil, round.

firstUpper

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

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

Siehe auch capitalize, lower, upper.

group (string|int|\Closure $by)array

Filter, der Daten nach verschiedenen Kriterien gruppiert.

In diesem Beispiel werden die Tabellenzeilen nach der Spalte categoryId gruppiert. Die Ausgabe ist ein Array von Arrays, wobei der Schlüssel der Wert in der Spalte categoryId ist. Lesen Sie die detaillierte Anleitung.

{foreach ($items|group: categoryId) as $categoryId => $categoryItems}
    <ul>
        {foreach $categoryItems as $item}
            <li>{$item->name}</li>
        {/foreach}
    </ul>
{/foreach}

Siehe auch batch, die Funktion group und das Tag iterateWhile.

implode (string $glue='')

Gibt eine Zeichenkette zurück, die eine Verkettung der Elemente einer Sequenz ist. Alias für join.

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

Sie können auch den Alias join verwenden:

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

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

Rückt Text von links um eine bestimmte Anzahl von Tabulatoren oder anderen Zeichen ein, die im zweiten Argument angegeben werden können. Leere Zeilen werden nicht eingerückt.

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

Gibt aus:

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

last

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

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

Siehe auch first, random.

length

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

  • für Zeichenketten gibt es die Länge in UTF-8-Zeichen zurück
  • für Arrays gibt es die Anzahl der Elemente zurück
  • für Objekte, die das Countable-Interface implementieren, verwendet es den Rückgabewert der count()-Methode
  • für Objekte, die das IteratorAggregate-Interface implementieren, verwendet es den Rückgabewert der iterator_count()-Funktion
{if ($users|length) > 10}
	...
{/if}

localDate (?string $format=null, ?string $date=null, ?string $time=null)

Formatiert Datum und Uhrzeit gemäß den Ländereinstellungen, was eine konsistente und lokalisierte Darstellung von Zeitangaben in verschiedenen Sprachen und Regionen gewährleistet. Der Filter akzeptiert ein Datum als UNIX-Timestamp, Zeichenkette oder Objekt vom Typ DateTimeInterface.

{$date|localDate}                  {* 15. April 2024 *}
{$date|format: yM}                 {* 4/2024 *}
{$date|localDate: date: medium}    {* 15. 4. 2024 *}

Wenn Sie den Filter ohne Parameter verwenden, wird das Datum auf der Ebene long ausgegeben, siehe unten.

a) Verwendung des Formats

Der Parameter format beschreibt, welche Zeitkomponenten angezeigt werden sollen. Es verwendet Buchstabencodes dafür, deren Wiederholungsanzahl die Breite der Ausgabe beeinflusst:

Jahr y / yy / yyyy 2024 / 24 / 2024
Monat M / MM / MMMMMMM 8 / 08 / AugAugust
Tag d / dd / EEEEE 1 / 01 / SoSonntag
Stunde j / H / h bevorzugt / 24-Stunden / 12-Stunden
Minute m / mm 5 / 05 (2 Ziffern in Kombination mit Sekunden)
Sekunde s / ss 8 / 08 (2 Ziffern in Kombination mit Minuten)

Die Reihenfolge der Codes im Format spielt keine Rolle, da die Reihenfolge der Komponenten gemäß den Konventionen der Ländereinstellungen ausgegeben wird. Das Format ist also unabhängig davon. Zum Beispiel wird das Format yyyyMMMMd in der Umgebung en_US als April 15, 2024 ausgegeben, während es in der Umgebung de_DE als 15. April 2024 ausgegeben wird:

locale: de-DE en_US
format: 'dMy' 10.8.2024 8/10/2024
format: 'yM' 08/2024 8/2024
format: 'yyyyMMMM' August 2024 August 2024
format: 'MMMM' August August
format: 'jm' 17:54 5:54 PM
format: 'Hm' 17:54 17:54
format: 'hm' 5:54 PM 5:54 PM

b) Verwendung vordefinierter Stile

Die Parameter date und time bestimmen, wie detailliert Datum und Uhrzeit ausgegeben werden sollen. Sie können aus mehreren Ebenen wählen: full, long, medium, short. Es ist möglich, nur das Datum, nur die Uhrzeit oder beides ausgeben zu lassen:

locale: de-DE en_US
date: short 23.01.78 1/23/78
date: medium 23.01.1978 Jan 23, 1978
date: long 23. Januar 1978 January 23, 1978
date: full Montag, 23. Januar 1978 Monday, January 23, 1978
time: short 08:30 8:30 AM
time: medium 08:30:59 8:30:59 AM
time: long 08:30:59 MEZ 8:30:59 AM GMT+1
date: short, time: short 23.01.78, 08:30 1/23/78, 8:30 AM
date: medium, time: short 23.01.1978, 08:30 Jan 23, 1978, 8:30 AM
date: long, time: short 23. Januar 1978 um 08:30 January 23, 1978 at 8:30 AM

Für das Datum können Sie außerdem das Präfix relative- verwenden (z.B. relative-short), das für Daten nahe der Gegenwart gestern, heute oder morgen anzeigt, andernfalls wird es auf die Standardweise ausgegeben.

{$date|localDate: date: relative-short}    {* gestern *}

Siehe auch date.

lower

Konvertiert eine Zeichenkette in Kleinbuchstaben. Erfordert die PHP-Erweiterung mbstring.

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

Siehe auch capitalize, firstUpper, upper.

nocheck

Verhindert die automatische Behandlung einer URL-Adresse. Latte überprüft automatisch, ob die Variable eine Web-URL enthält (d.h. HTTP/HTTPS-Protokoll) und verhindert die Ausgabe von Links, die ein Sicherheitsrisiko darstellen können.

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

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

<a href={$link}>geprüft</a>
<a href={$link|nocheck}>ungeprüft</a>

Gibt aus:

<a href="">geprüft</a>
<a href="javascript:window.close()">ungeprüft</a>

Siehe auch checkUrl.

noescape

Deaktiviert automatisches Escaping.

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

Gibt aus:

Escaped: &lt;b&gt;hello&lt;/b&gt;
Unescaped: <b>hello</b>

Falsche Verwendung des noescape-Filters kann zu XSS-Schwachstellen führen! Verwenden Sie ihn niemals, wenn Sie nicht absolut sicher sind, was Sie tun, und dass die ausgegebene Zeichenkette aus einer vertrauenswürdigen Quelle stammt.

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

Formatiert eine Zahl auf eine bestimmte Anzahl von Dezimalstellen. Wenn Ländereinstellungen gesetzt sind, werden die entsprechenden Dezimal- und Tausendertrennzeichen verwendet.

{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

number (string $format)

Der Parameter format ermöglicht es Ihnen, das Aussehen von Zahlen genau nach Ihren Bedürfnissen zu definieren. Dafür müssen Ländereinstellungen gesetzt sein. Das Format besteht aus mehreren speziellen Zeichen, deren vollständige Beschreibung Sie in der Dokumentation DecimalFormat finden:

  • 0 obligatorische Ziffer, wird immer angezeigt, auch wenn es eine Null ist
  • # optionale Ziffer, wird nur angezeigt, wenn an dieser Stelle tatsächlich eine Zahl steht
  • @ signifikante Ziffer, hilft, eine Zahl mit einer bestimmten Anzahl gültiger Ziffern anzuzeigen
  • . kennzeichnet, wo das Dezimalkomma (oder -punkt, je nach Land) sein soll
  • , dient zur Trennung von Zifferngruppen, meist Tausender
  • % multipliziert die Zahl mit 100 und fügt das Prozentzeichen hinzu

Schauen wir uns einige Beispiele an. Im ersten Beispiel sind zwei Dezimalstellen obligatorisch, im zweiten optional. Das dritte Beispiel zeigt das Auffüllen mit Nullen links und rechts, das vierte zeigt nur existierende Ziffern:

{1234.5|number: '#,##0.00'}     {* 1,234.50 *}
{1234.5|number: '#,##0.##'}     {* 1,234.5 *}
{1.23  |number: '000.000'}      {* 001.230 *}
{1.2   |number: '##.##'}        {* 1.2 *}

Signifikante Ziffern bestimmen, wie viele Ziffern unabhängig vom Dezimalpunkt angezeigt werden sollen, wobei gerundet wird:

{1234|number: '@@'}             {* 1200 *}
{1234|number: '@@@'}            {* 1230 *}
{1234|number: '@@@#'}           {* 1234 *}
{1.2345|number: '@@@'}          {* 1.23 *}
{0.00123|number: '@@'}          {* 0.0012 *}

Ein einfacher Weg, eine Zahl als Prozentsatz anzuzeigen. Die Zahl wird mit 100 multipliziert und das %-Zeichen wird hinzugefügt:

{0.1234|number: '#.##%'}        {* 12.34% *}

Wir können unterschiedliche Formate für positive und negative Zahlen definieren, getrennt durch ein ;-Zeichen. Auf diese Weise können wir zum Beispiel festlegen, dass positive Zahlen mit einem +-Zeichen angezeigt werden sollen:

{42|number: '#.##;(#.##)'}      {* 42 *}
{-42|number: '#.##;(#.##)'}     {* (42) *}
{42|number: '+#.##;-#.##'}      {* +42 *}
{-42|number: '+#.##;-#.##'}     {* -42 *}

Beachten Sie, dass das tatsächliche Aussehen der Zahlen je nach den Ländereinstellungen variieren kann. In einigen Ländern wird beispielsweise ein Komma statt eines Punkts als Dezimaltrennzeichen verwendet. Dieser Filter berücksichtigt dies automatisch, und Sie müssen sich um nichts kümmern.

padLeft (int $length, string $pad=' ')

Füllt eine Zeichenkette auf eine bestimmte Länge mit einer anderen Zeichenkette von links auf.

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

padRight (int $length, string $pad=' ')

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

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

query

Generiert dynamisch einen Query-String in einer URL:

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

Gibt aus:

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

Schlüssel mit dem Wert null werden weggelassen.

Siehe auch escapeUrl.

random

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

{=[1, 2, 3, 4]|random}    {* gibt z.B.: 3 aus *}
{='abcd'|random}          {* gibt z.B.: 'b' aus *}

Siehe auch first, last.

repeat (int $count)

Wiederholt eine Zeichenkette x-mal.

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

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

Ersetzt alle Vorkommen der Suchzeichenkette durch die Ersatzzeichenkette.

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

Es können auch mehrere Ersetzungen auf einmal durchgeführt werden:

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

replaceRE (string $pattern, string $replace='')

Führt eine Suche und Ersetzung mit regulären Ausdrücken durch.

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

reverse

Kehrt die gegebene Zeichenkette oder das Array um.

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

round (int $precision=0)

Rundet eine Zahl auf die angegebene Genauigkeit.

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

Siehe auch ceil, floor.

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

Extrahiert einen Teil eines Arrays oder einer Zeichenkette.

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

Der Filter funktioniert wie die PHP-Funktion array_slice für Arrays oder mb_substr für Zeichenketten mit Fallback auf die Funktion iconv_substr im UTF-8-Modus.

Wenn start positiv ist, beginnt die Sequenz um diese Anzahl vom Anfang des Arrays/der Zeichenkette verschoben. Wenn es negativ ist, beginnt die Sequenz um diese Anzahl vom Ende verschoben.

Wenn der Parameter length angegeben und positiv ist, enthält die Sequenz so viele Elemente. Wenn ein negativer length-Parameter an diese Funktion übergeben wird, enthält die Sequenz alle Elemente des ursprünglichen Arrays, beginnend an der Position start und endend an der Position, die um length Elemente vom Ende des Arrays entfernt ist. Wenn Sie diesen Parameter weglassen, enthält die Sequenz alle Elemente des ursprünglichen Arrays, beginnend an der Position start.

Standardmäßig ändert der Filter die Reihenfolge und setzt die ganzzahligen Schlüssel des Arrays 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 (?Closure $comparison, string|int|\Closure|null $by=null, string|int|\Closure|bool $byKey=false)

Der Filter sortiert die Elemente eines Arrays oder Iterators und behält ihre assoziativen Schlüssel bei. Bei gesetzten Ländereinstellungen folgt die Sortierung deren Regeln, wenn keine eigene Vergleichsfunktion angegeben ist.

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

Sortiertes Array in umgekehrter Reihenfolge:

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

Sie können eine eigene Vergleichsfunktion für die Sortierung angeben (das Beispiel zeigt, wie die Sortierung von größter zu kleinster umgekehrt wird):

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

Der Filter |sort ermöglicht auch die Sortierung von Elementen nach Schlüsseln:

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

Wenn Sie eine Tabelle nach einer bestimmten Spalte sortieren müssen, können Sie den Parameter by verwenden. Der Wert 'name' im Beispiel gibt an, dass nach $item->name oder $item['name'] sortiert wird, je nachdem, ob $item ein Array oder ein Objekt ist:

{foreach ($items|sort: by: 'name') as $item}
	{$item->name}
{/foreach}

Sie können auch eine Callback-Funktion definieren, die den Wert bestimmt, nach dem sortiert werden soll:

{foreach ($items|sort: by: fn($items) => $items->category->name) as $item}
	{$item->name}
{/foreach}

Der Parameter byKey kann auf die gleiche Weise verwendet werden.

spaceless

Entfernt überflüssige Leerzeichen aus der Ausgabe. Sie können auch den Alias strip verwenden.

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

Gibt aus:

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

stripHtml

Konvertiert HTML in reinen Text. Das heißt, es entfernt HTML-Tags und konvertiert HTML-Entities in Text.

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

Der resultierende reine Text kann natürlich Zeichen enthalten, die HTML-Tags darstellen, zum Beispiel wird '&lt;p&gt;'|stripHtml zu <p> konvertiert. Geben Sie den so erzeugten Text auf keinen Fall mit |noescape aus, da dies zu einer Sicherheitslücke führen kann.

substr (int $offset, ?int $length=null)

Extrahiert einen Teil einer Zeichenkette. Dieser Filter wurde durch den Filter slice ersetzt.

{$string|substr: 1, 2}

translate (string $message, …$args)

Übersetzt Ausdrücke in andere Sprachen. Damit der Filter verfügbar ist, muss ein Übersetzer eingerichtet sein. Sie können auch Tags für Übersetzungen verwenden.

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

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

Entfernt Leerzeichen (oder andere Zeichen) vom Anfang und Ende einer Zeichenkette.

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

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

Kürzt eine Zeichenkette auf die angegebene maximale Länge, wobei versucht wird, ganze Wörter zu erhalten. Wenn die Zeichenkette gekürzt wird, wird am Ende ein Auslassungszeichen hinzugefügt (kann mit dem 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 eine Zeichenkette in Großbuchstaben. Erfordert die PHP-Erweiterung mbstring.

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

Siehe auch capitalize, firstUpper, lower.

webalize

Konvertiert eine UTF-8-Zeichenkette in die in URLs verwendete Form.

Es wird in ASCII konvertiert. Konvertiert Leerzeichen in Bindestriche. Entfernt Zeichen, die nicht alphanumerisch, Unterstriche oder Bindestriche sind. Konvertiert in Kleinbuchstaben. Entfernt auch führende und abschließende Leerzeichen.

{var $s = 'Unser 10. Produkt'}
{$s|webalize}   {* gibt 'unser-10-produkt' aus *}

Erfordert die Bibliothek nette/utils.

Version: 3.0