Filteri - Izmena promenljivih u Twig šablonima

Filteri u Twig-u se mogu koristiti za izmenu promenljivih. Filteri se odvajaju od promenljive simbolom cevi (|). Mogu imati opcionе argumente u zagradama. Više filtera može biti povezano zajedno. Izlaz jednog filtera se primenjuje na sledeći.

Primer:

{{ content|safe_join(", ")|lower }}

Možda ćete morati da renderujete element pre nego što ga filtrirate:

{{ item|render|filter }}

Twig dolazi sa mnoštvom ugrađenih filtera koje možete pogledati u njihovoj zvaničnoj dokumentaciji. Drupal ima mnogo sopstvenih filtera.

Drupal Specijalni filteri

Oni su deklarisani u TwigExtension::getFilters().

Filteri za prevod

trans
Ovaj filter (alternativno, t) prosleđuje promenljivu kroz Drupal funkciju t(), koja vraća prevedeni string. Ovaj filter treba koristiti za sve interfejsne stringove ručno ubačene u šablon koji će biti prikazan korisnicima.

Primer:

<a href="{{ url('<front>') }}" title="{{ 'Početna'|t }}" rel="home" class="site-logo"></a>

placeholder
Ovaj filter escapuje sadržaj u HTML i formatira ga pomoću drupal_placeholder(), što omogućava isticanje teksta.

Primer:

{% trans %}Poslato {{ date|placeholder }}{% endtrans %}

Nesiguran prevod
Neki šabloni su nesigurni i ne bi trebalo da se koriste jer prosleđuju promenljivu direktno u prevod. To ne samo da povećava broj stringova za prevod, već može biti i sigurnosni rizik, naročito ako izlaz može biti unet od strane korisnika. Neki primeri lošeg korišćenja prevoda:

{# NE RADITE OVAKO #}
{{ var1|t }}
{{ var1|placeholder }}
{% trans %}{{ var1 }}{% endtrans %}

Dodatni filteri

clean_class
Ovaj filter priprema string da bude validno ime HTML klase. Pogledajte Html::getClass()

clean_id
Ovaj filter priprema string da bude validan HTML ID. Pogledajte Html::getID()

format_date
Ovaj filter formatira vremensku oznaku u formatirani datum. Pogledajte DateFormatter::format()

raw
Ovaj filter treba izbegavati kad god je to moguće, naročito ako prikazujete podatke koje može uneti korisnik. Pogledajte ovu stranicu za dodatne informacije o automatskom escapovanju u Drupalu 8.

render
Ovaj filter je omot za funkciju render(). Prima niz render podataka i vraća renderovani HTML. Koristan je ako želite primeniti dodatne filtere (npr. parsiranje tagova) ili ako želite uslov baziran na renderovanom izlazu (npr. ako imate nenulti render niz koji vraća prazan string). Može se koristiti i za stringove i za određene objekte, uglavnom one koji imaju implementiran metod toString().

safe_join
Filter safe_join spaja više stringova sa zadatim separatorom. Pogledajte TwigExtension::safeJoin().

Primer:

{{ items|safe_join(', ') }}

Ovo će ispisati svaki string iz promenljive items, spojene zarezom kao separatorom.

without
Filter without kreira kopiju render niza i uklanja decu po ključu koji se prosleđuje filteru kao argument. Kopija se može ispisati bez tih elemenata. Izvorni render niz ostaje dostupan i može se koristiti za potpunu štampu svih elemenata u šablonu grane. Pogledajte twig_without.

Primeri:

{{ content|without('links') }}

Ovo ispisuje sve iz promenljive content, osim content.links.

{{ content|without('links', 'field_some_data') }}

Primer isključivanja dva elementa iz prikaza. Izuzima „links“ i „field_some_data“.