Grav-Twig filtri e funzioni

In questo capitolo, studiamo Twig Filters and Functions. I filtri vengono utilizzati per formattare i dati nel modo desiderato anche con l'output richiesto. Le funzioni vengono utilizzate per generare contenuti.

I modelli Twig sono file di testo che contengono espressioni e variabili sostituite da valori. Twig utilizza tre tipi di tag.

  • Output tags - La seguente sintassi viene utilizzata per visualizzare qui il risultato delle espressioni valutate.

{{  Place Your Output Here  }}

  • Action Tags - La seguente sintassi viene utilizzata per eseguire le istruzioni qui.

{%  executable statements are placed here  %}

  • Comment tags - La seguente sintassi viene utilizzata per scrivere commenti nel file modello Twig.

{#  write your comment here  #}

Filtri Twig

Twig Filters utilizza l'estensione |carattere per applicare i filtri alla variabile Twig seguito dal nome del filtro. Gli argomenti possono essere passati tra parentesi in modo simile alle funzioni Twig.

La tabella seguente mostra i filtri Twig utilizzati in Grav -

Sr.No. Filtro e descrizione Esempio
1

Absolute URL

Prende il percorso relativo e lo converte in un URL assoluto.

 
'<img src="/some/path/img.jpg"/>' |absolute_url

converte in -

<img src="http://learn.getGrav.org/some/path/img.jpg" />
2

Camelize

Converte una stringa in formato CamelCase.

 
'contact_us'| camelize

converte in -

ContactUs
3

Contains

se trova la stringa.

 
'This is some string' | contains('some')

l'uscita è -

1
4

Defined

Puoi controllare se qualche variabile è definita o meno. Se la variabile non è definita, è possibile fornire un valore predefinito.

 
set header_image_width = 
page.header.header_image_width|defined(900)

Si imposta header_image_width con valore 900 se non è definito.
5

Ends-With

È possibile determinare se una stringa termina con una determinata stringa utilizzando il filtro Ends-With.

 
'this is an example for ends-with filter' | ends_with('filter')

viene visualizzato come -

True
6

FieldName

Filtra il nome del campo cambiando il punto nella notazione dell'array.

 
'field.name'|fieldName

viene visualizzato come -

field[name]
7

Humanize

Viene utilizzato per convertire una stringa in un formato leggibile dall'uomo.

 
'some_text_to_read'|humanize

viene visualizzato come -

Some text to read
8

Ksort

Ordina una mappa di array usando la chiave.

 
{% set ritems = {'orange':1, 'apple':2, 'peach':3}|ksort %}
{% for key, value in ritems %}{{ key }}:{{ value }}, {% endfor %}

viene visualizzato come -

apple:2, orange:1, peach:3,
9

Left Trim

Viene utilizzato per rimuovere gli spazi bianchi all'inizio di una stringa e rimuove il carattere corrispondente dato dal lato sinistro della stringa.

 
'/strip/leading/slash/'|ltrim('/')

viene visualizzato come -

strip/leading/slash/
10

Markdown

Viene utilizzato per convertire la stringa contenente markdown in HTML utilizzando il parser markdown di Grav.

 
'## some text with markdown'|markdown

viene visualizzato come -

some text with markdown
11

MD5

L'hash md5 per la stringa può essere creato utilizzando questo filtro.

 
'something'|md5

viene visualizzato come -

437b930db84b8079c2dd804a71936b5f
12

Monthize

Utilizzando il filtro Monthize, possiamo convertire un numero intero di giorni in un numero di mesi.

 
'61'|monthize

viene visualizzato come -

2
13

Nice Time

Utilizzando il filtro Nice Time, possiamo ottenere una data in un bel formato ora leggibile come output.

 
page.date|nicetime(false)

viene visualizzato come -

3 hrs ago
14

Ordinalize

Ordinali (come 1 ° , 2 ° , 3 ° ) possono essere somministrati in numeri interi utilizzando il filtro Ordinalize.

 
'78'| ordinalize

viene visualizzato come -

78th
15

Pluralize

Una stringa può essere convertita nella sua forma inglese plurale utilizzando il filtro Pluralize.

 
'child'|pluralize

viene visualizzato come -

children
16

Randomize

Questo filtro aiuta a randomizzare l'elenco fornito. Se il parametro contiene valori, tali valori vengono ignorati dalla randomizzazione.

 
{% set ritems = ['one', 'two', 'three', 'four', 'five', 'six', 'seven', 'eight', 'nine', 'ten']|randomize(3) %}
{% for ritem in ritems %}{{ ritem }}, {% endfor %}

viene visualizzato come -

one, two, three, eight, six, five, nine, seven, ten, four,
17

Right Trim

È abbastanza simile al taglio a sinistra tranne per il fatto che rimuove gli spazi bianchi e i caratteri corrispondenti dal lato destro della stringa.

 
'/strip/leading/slash/'|rtrim('/')

viene visualizzato come -

/strip/leading/slash
18

Singularize

Una stringa può essere convertita nella versione singolare inglese utilizzando il filtro singolare.

 
'vehicles'|singularize

viene visualizzato come -

vehicle
19

Safe Email

Il filtro Safe Email viene utilizzato per convertire un indirizzo e-mail in caratteri ASCII in modo che sia più difficile che un'e-mail venga spam.

 
"[email protected]"|safe_email

l'uscita è -

[email protected]
20

SortByKey

Viene utilizzato per ordinare la mappa dell'array utilizzando i tasti.

 
{% set people = [{'email':'[email protected]', 'id':3}, {'email':'[email protected]', 'id':1}, {'email':'[email protected]', 'id':7}]|sort_by_key('id') %}
{% for person in people %}{{ person.email }}:{{ person.id }}, {% endfor %}

mostra -

[email protected]:1, [email protected]:3, [email protected]:7,
21

Starts-With

È possibile determinare se una stringa inizia con una determinata stringa utilizzando il filtro Inizia con.

 
'this is an example for starts-with filter' |starts_with('this')

l'uscita è -

true
22

Translate

per informazioni più dettagliate.

 
MY_LANGUAGE_KEY_STRING

mostra -

'Some text in English'
23

Translate Admin

Traduce una stringa nella lingua corrente impostata nel file user.yaml file.
24

Titleize

Una stringa viene convertita in formato maiuscole / minuscole utilizzando Titleize.

 
'welcome page'|titleize

viene visualizzato come -

Welcome Page
25

UnderScoreize

formato utilizzando il filtro UnderScoreize.

 
'ContactUs'|underscorize

è convertito in -

contact_us
26

Truncate a string

È possibile utilizzare Truncate per troncare una stringa o accorciare la stringa, è necessario specificare il numero di caratteri.

 
'one sentence. two sentences'|truncate(5)

tronca a -

one s...

Puoi usare true come parametro se non si desidera troncare la stringa alla fine della frase più vicina dopo il numero di caratteri specificato.

'one sentence. two sentences'|truncate(5, true)

tronca a -

one sentence
Puoi anche rimuovere il testo HTML, ma dovresti usare striptags filtro prima truncate filtro. 
'<p>one <strong>sentence<strong>. two sentences</p>'|striptags|truncate(5)

viene visualizzato come -

one s

Funzioni Twig

Le funzioni Twig vengono chiamate direttamente passando il parametro. La tabella seguente elenca le funzioni:

Sr.No. Descrizione della funzione Esempio
1

Array

Questa funzione esegue il cast di un valore su array.

 
array(value)
2

Authorize

Questa funzione consente a un utente autenticato di visualizzare una risorsa e accetta una stringa di autorizzazione o un array di stringhe di autorizzazione.

 
authorize(['admin.statistics', 'admin.super'])
3

Dump

Accetta una variabile twig valida e la scarica nel pannello del debugger di Grav. Tuttavia, il debugger dovrebbe essere abilitato per visualizzare i valori della scheda dei messaggi.

 
dump(page.header)
4

Debug

Funziona come la funzione dump ().
5

Gist

Questa funzione crea il codice di incorporamento Gist in base all'ID Gist di Github.
6

Random String Generation

Questa funzione creerà una stringa casuale con il numero di caratteri specificato. Queste stringhe possono essere utilizzate come ID o chiave univoci.

 
generate_random_string(10)
7

Repeat

Questa funzione ripeterà la stringa per un determinato periodo di tempo.

 
repeat('Grav ', 10) will repeat Grav 10 times.
8

String

Genera una stringa casuale della lunghezza di caratteri specificata.

 
ta (23)
9

Translate Array

È una funzione connessa con |ta filtro.
10

Url

Questo filtro creerà un URL e convertirà anche i flussi di URL PHP in risorse HTML valide. Se l'URL non può essere risolto, è possibile passare un valore predefinito.

 
url('theme://images/logo.png') | default('http://www.placehold.it/150x100/f4f4f4')
11

Translate

Utilizzando il filtro Traduci, una stringa viene tradotta come |t filtro.

 
t('SITE_NAME')

è tradotto in -

Site Name