Filtri Liquid disponibili
Nota
A partire dal 12 ottobre 2022, i portali Power Apps sono denominati Power Pages. Altre informazioni: Microsoft Power Pages è ora generalmente disponibile (blog)
A breve verrà eseguita la migrazione e l'unione della documentazione dei portali Power Apps con la documentazione di Power Pages.
I filtri Liquid vengono utilizzati per modificare l'output delle stringhe, i numeri, le variabili e gli oggetti. Sono separati dal valore a cui sono applicati da un |.
{{ 'hal 9000' | upcase }} <!-- Output: HAL 9000 -->
Alcuni filtri accettano i parametri. I filtri possono inoltre essere combinati e sono applicati in ordine da sinistra a destra.
{{ 2 | times: 2 | minus: 1 }} <!-- Output: 3 -->
{{ "Hello, " | append: user.firstname }} <!-- Output: Hello, Dave -->
La sezione seguente descrive vari filtri.
Filtri di matrice
I filtri di matrice sono utilizzati per lavorare con le matrici.
batch
Divide una matrice in più matrici di una dimensione specificata.
Codice
{% assign batches = entityview.records | batch: 2 %}
{% for batch in batches %}
<ul>
{% for item in batch %}
<li>{{ item.fullname }}</li>
{% endfor %}
</ul>
{% endfor %}
Output
<ul>
<li>John Smith</li>
<li>Dave Thomas</li>
</ul>
<ul>
<li>Jake Johnson</li>
<li>Jack Robinson</li>
</ul>
concat
Concatena due matrici in un'unica nuova matrice.
Dato un singolo elemento come parametro, concat restituisce una nuova matrice costituita dalla matrice originale, con l'elemento specificato come ultimo elemento.
Codice
Group #1: {{ group1 | join: ', ' }}
Group #2: {{ group2 | join: ', ' }}
Group #1 + Group #2: {{ group1 | concat: group2 | join: ', ' }}
Output
Group #1: John, Pete, Hannah
Group #2: Joan, Bill
Group #1 + Group #2: John, Pete, Hannah, Joan, Bill
except
Selezionare tutti gli oggetti in una matrice in cui un attributo specificato non ha un valore specificato. (È l'inverso di where).
Codice
{% assign redmond = entityview.records | except: 'address1_city', 'Redmond' %}
{% for item in redmond %}
{{ item.fullname }}
{% endfor %}
Output
Jack Robinson
primo
Restituisce il primo elemento di una matrice.
first può anche essere utilizzato con una speciale annotazione con punto, quando deve essere utilizzato in un tag.
Codice
{% assign words = This is a run of text | split: %}
{{ words | first }}
{% if words.first == This %}
The first word is This.
{% endif %}
Output
This
The first word is This.
group_by
Raggruppare gli elementi in una matrice per mezzo di un attributo specificato.
Codice
{% assign groups = entityview.records | group_by: 'address1_city' %}
{% for group in groups %}
{{ group.key }}:
{% for item in group.items %}
{{ item.fullname }}
{% endfor %}
{% endfor %}
Output
Redmond:
John Smith
Dave Thomas
Jake Johnson
New York:
Jack Robinson
join
Unisce gli elementi di una matrice con il carattere passato come parametro. Il risultato è una singola stringa.
Codice
{% assign words = This is a run of text | split: %}
{{ words | join: , }}
Output
This, is, a, run, of, text
ultimo
Restituisce l'ultimo elemento di una matrice.
last può anche essere utilizzato con una speciale annotazione con punto, quando deve essere utilizzato in un tag.
Codice
{% assign words = This is a run of text | split: -%}
{{ words | last }}
{% if words.last == text -%}
The last word is text.
{% endif -%}
Output
text
The last word is text.
order_by
Restituisce elementi di una matrice ordinati da un attributo specificato degli elementi della matrice.
Facoltativamente, si può indicare desc come secondo parametro per ordinare gli elementi in ordine decrescente, anziché ascendente.
Codice
{{ entityview.records | order_by: 'fullname' | join: ', ' }}
{{ entityview.records | order_by: 'fullname', 'desc' | join: ', ' }}
Output
Dave Thomas, Jack Robinson, Jake Johnson, John Smith
John Smith, Jake Johnson, Jack Robinson, Dave Thomas
random
Restituisce un elemento selezionato in modo casuale dalla matrice.
Codice
{{ group1 | join: ', ' }}
{{ group1 | random }}
Output
John, Pete, Hannah
Pete
select
Seleziona il valore di un attributo specificato per ogni elemento in una matrice e restituisce questi valori come matrice.
Codice
{{ entityview.records | select: 'address1_city' | join: ', ' }}
Output
Redmond, New York
shuffle
Applicato a una matrice, restituisce una nuova matrice con gli stessi elementi, in ordine casuale.
Codice
{{ group1 | join: ', ' }}
{{ group1 | shuffle | join: ', ' }}
Output
John, Pete, Hannah
Hannah, John, Pete
size
Restituisce il numero di elementi di una matrice.
size può anche essere utilizzato con una speciale annotazione con punto, quando deve essere utilizzato in un tag.
Codice
{% assign words = This is a run of text | split: -%}
{{ words | size }}
{% if words.size == 6 -%}
The text contains 6 words.
{% endif -%}
Output
6
The text contains 6 words.
skip
Ignora un numero specificato di elementi in una matrice e restituisce il resto.
Codice
{% assign words = This is a run of text | split: %}
{{ words | skip: 3 | join: ', ' }}
Output
run, of, text
take
Seleziona un numero specificato di elementi dalla matrice, restituendo gli elementi selezionati.
Codice
{% assign words = This is a run of text | split: %}
{{ words | take: 3 | join: ', ' }}
Output
This, is, a
then_by
Aggiunge l'ordinamento successivo aggiuntivo a una matrice già ordinata con order_by.
Facoltativamente, si può indicare desc come secondo parametro per ordinare gli elementi in ordine decrescente, anziché ascendente.
Codice
{{ entityview.records | order_by: 'address1_city' | then_by: 'fullname' | join: ', ' }}
{{ entityview.records | order_by: 'address1_city' | then_by: 'fullname', 'desc' | join: ', ' }}
Output
Dave Thomas, Jack Robinson, Jake Johnson, John Smith
John Smith, Jake Johnson, Jack Robinson, Dave Thomas
dove
Selezionare tutti gli oggetti in una matrice in cui un attributo specificato ha un valore specificato.
Codice
{% assign redmond = entityview.records | where: 'address1_city', 'Redmond' %}
{% for item in redmond %}
{{ item.fullname }}
{% endfor %}
Output
John Smith
Dave Thomas
Jake Johnson
Filtri data
I filtri data possono essere utilizzati per l'aritmetica relativa alla data o per convertire i valori di tipo DateTime in diversi formati.
data
Formatta un valore DateTime con una stringa di formato .NET.
Stringhe formato data e ora standard
Stringhe formato data e ora personalizzate
Codice
{{ now | date: 'g' }}
{{ now | date: 'MMMM dd, yyyy' }}
Output
5/7/2018 7:20 AM
May 07, 2018
date_add_days
Aggiunge il numero specificato di giorni interi e frazioni di giorni al valore DateTime. Il parametro può essere positivo o negativo.
Codice
{{ now }}
{{ now | date_add_days: 1 }}
{{ now | date_add_days: -2.5 }}
Output
5/7/2018 7:20:46 AM
5/8/2018 7:20:46 AM
5/4/2018 7:20:46 PM
date_add_hours
Aggiunge il numero specificato di ore intere e frazioni di ore al valore DateTime. Il parametro può essere positivo o negativo.
Codice
{{ now }}
{{ now | date_add_hours: 1 }}
{{ now | date_add_hours: -2.5 }}
Output
5/7/2018 7:20:46 AM
5/7/2018 8:20:46 AM
5/7/2018 4:50:46 AM
date_add_minutes
Aggiunge il numero specificato di minuti interi e frazioni di minuti al valore DateTime. Il parametro può essere positivo o negativo.
Codice
{{ now }}
{{ now | date_add_minutes: 10 }}
{{ now | date_add_minutes: -2.5 }}
Output
5/7/2018 7:20:46 AM
5/7/2018 7:30:46 AM
5/7/2018 7:18:16 AM
date_add_months
Aggiunge il numero specificato di mesi interi e frazioni di mesi al valore DateTime. Il parametro può essere positivo o negativo.
Codice
{{ now }}
{{ now | date_add_months: 1 }}
{{ now | date_add_months: -2 }}
Output
5/7/2018 7:20:46 AM
6/7/2018 7:20:46 AM
3/7/2018 7:20:46 AM
date_add_seconds
Aggiunge il numero specificato di secondi interi e frazioni di secondi al valore DateTime. Il parametro può essere positivo o negativo.
Codice
{{ now }}
{{ now | date_add_seconds: 10 }}
{{ now | date_add_seconds: -1.25 }}
Output
5/7/2018 7:20:46 AM
5/7/2018 7:20:56 AM
5/7/2018 7:20:45 AM
date_add_years
Aggiunge il numero specificato di anni interi e frazioni di anni al valore DateTime. Il parametro può essere positivo o negativo.
Codice
{{ now }}
{{ now | date_add_years: 1 }}
{{ now | date_add_years: -2 }}
Output
5/7/2018 7:20:46 AM
5/7/2019 7:20:46 AM
5/7/2016 7:20:46 AM
date_to_iso8601
Formatta un valore DateTime in base allo standard ISO 8601. Utile durante la creazione di Feed Atom o dell'elemento <time> HTML5.
Codice
{{ now | date_to_iso8601 }}
Output
2018-05-07T07:20:46Z
date_to_rfc822
Formatta un valore DateTime in base allo standard RFC 822. Utile durante la creazione di feed RSS.
Codice
{{ now | date_to_rfc822 }}
Output
Mon, 07 May 2018 07:20:46 Z
Filtro elenco
I filtri elenco sono utilizzati con alcuni valori di attributo entitylist e consentono la creazione di visualizzazioni elenco di entità.
current_sort
Una volta specificata un'espressione di ordinamento, viene restituita la direzione di ordinamento corrente per un determinato attributo.
Codice
{{ 'name ASC, createdon DESC' | current_sort: 'createdon' }}
Output
DESC
metafilters
Analizza un valore JSON entitylist filter_definition in oggetti del gruppo di opzioni del filtro.
metafilters può essere facoltativamente fornito con una query del filtro dell'attributo corrente e entitylist corrente, consentendo di contrassegnare gli oggetti del filtro restituiti come selezionati o non selezionati.
Codice
{% assign filters = entitylist | metafilters: params.mf, entityview %}
{% if filters.size > 0 %}
<ul id=entitylist-filters>
{% for filter in filters %}
<li class=entitylist-filter-option-group>
{% if filter.selection_mode == 'Single' %}
{% assign type = 'radio' %}
{% else %}
{% assign type = 'checkbox' %}
{% endif %}
<h4 class=entitylist-filter-option-group-label
data-filter-id={{ filter.id | h }}>
{{ filter.label | h }}
</h4>
<ul>
{% for option in filter.options %}
<li class=entitylist-filter-option>
{% if option.type == 'text' %}
<div class=input-group entitylist-filter-option-text>
<span class=input-group-addon>
<span class=fa fa-filter aria-hidden=true></span>
</span>
<input class=form-control
type=text
name={{ filter.id | h }}
value={{ option.text | h }} />
</div>
{% else %}
<div class={{ type | h }}>
<label>
<input
type={{ type | h }}
name={{ filter.id | h }}
value={{ option.id | h }}
{% if option.checked %}
checked=checked
data-checked=true{% endif %}
/>
{{ option.label | h }}
</label>
</div>
{% endif %}
</li>
{% endfor %}
</ul>
</li>
{% endfor %}
</ul>
<button class=btn btn-default data-serialized-query=mf data-target=#entitylist-filters>Apply Filters</button>
{% endif %}
reverse_sort
Una volta specificata una direzione di ordinamento, restituisce la direzione di ordinamento opposta.
Codice
<!-- Sort direction is not case-sensitive -->
{{ 'ASC' | reverse_sort }}
{{ 'desc' | reverse_sort }}
Output
DESC
ASC
Filtri per la matematica
I filtri per la matematica consentono di realizzare operazioni matematiche su numeri.
Come con tutti i filtri, i filtri per la matematica possono essere concatenati e sono applicato in ordine da destra a sinistra.
Codice
{{ 10 | times: 2 | minus: 5 | divided_by: 3 }}
Output
5
ceil
Arrotonda per un valore fino al numero intero più vicino.
Codice
{{ 4.6 | ceil }}
{{ 4.3 | ceil }}
Output
5
5
divided_by
Divide un numero per un altro numero.
Codice
{{ 10 | divided_by: 2 }}
{{ 10 | divided_by: 3 }}
{{ 10.0 | divided_by: 3 }}
Output
5
3
3.333333
floor
Arrotonda per un valore fino al numero intero più vicino.
Codice
{{ 4.6 | floor }}
{{ 4.3 | floor }}
Output
4
4
minus
Sottrae un numero da un altro numero.
Codice
<!-- entityview.page = 11 -->
{{ entityview.page | minus: 1 }}
{{ 10 | minus: 1.1 }}
{{ 10.1 | minus: 1 }}
Output
10
9
9.1
modulo
Divide un numero per un altro numero e restituisce il resto.
Codice
{{ 12 | modulo: 5 }}
Output
2
plus
Aggiunge un numero a un altro numero.
Codice
<!-- entityview.page = 11 -->
{{ entityview.page | plus: 1 }}
{{ 10 | plus: 1.1 }}
{{ 10.1 | plus: 1 }}
Output
12
11
11.1
round
Arrotonda un valore al numero intero più vicino o il numero specificato di decimali.
Codice
{{ 4.6 | round }}
{{ 4.3 | round }}
{{ 4.5612 | round: 2 }}
Output
5
4
4.56
times
Moltiplica un numero per un altro numero.
Codice
{{ 10 | times: 2 }}
{{ 10 | times: 2.2 }}
{{ 10.1 | times: 2 }}
Output
20
20
20.2
Filtri stringa
I filtri stringa modificano le stringhe.
append
Aggiunge una stringa alla fine di un'altra stringa.
Codice
{{ 'filename' | append: '.js' }}
Output
filename.js
capitalize
scrive in lettere maiuscole la prima parola in una stringa.
Codice
{{ 'capitalize me' | capitalize }}
Output
Capitalize Me
downcase
Converte una stringa in lettere minuscole.
Codice
{{ 'MIxed Case TExt' | downcase }}
Output
mixed case text
escape
Esegue la sequenza escape HTML di una stringa.
Codice
{{ '<p>test</p>' | escape }}
Output
<p>test</p>
newline_to_br
Inserisce un tag HTML di interruzione di riga <br /> ad ogni interruzione di riga in una stringa.
Codice
{% capture text %}
A
B
C
{% endcapture %}
{{ text | newline_to_br }}
Output
A<br />
B<br />
C<br />
prepend
Antepone una stringa all'inizio di un'altra stringa.
Codice
{{ 'Jane Johnson' | prepend: 'Dr. ' }}
Output
Dr. Jane Johnson
remove
Elimina tutte le ricorrenze di una stringa secondaria da una stringa.
Codice
{{ 'Hello, Dave. How are you, Dave?' | remove: 'Dave' }}
Output
Hello, . How are you, ?
remove_first
Elimina tutte le prime ricorrenze di una stringa secondaria da una stringa.
Codice
{{ 'Hello, Dave. How are you, Dave?' | remove_first: 'Dave' }}
Output
Hello, . How are you, Dave?
replace
Sostituisce tutte le ricorrenze di una stringa con una stringa secondaria.
Codice
{{ 'Hello, Dave. How are you, Dave?' | replace: 'Dave', 'John' }}
Output
Hello, John. How are you, John?
replace_first
Sostituisce la prime ricorrenza di una stringa con una stringa secondaria.
Codice
{{ 'Hello, Dave. How are you, Dave?' | replace_first: 'Dave', 'John' }}
Output
Hello, John. How are you, Dave?
split
Il filtro split richiede una sottostringa come parametro. La sottostringa viene utilizzata come delimitatore per dividere una stringa in una matrice.
Codice
{% assign words = This is a demo of the split filter | split: ' ' %}
First word: {{ words.first }}
First word: {{ words[0] }}
Second word: {{ words[1] }}
Last word: {{ words.last }}
All words: {{ words | join: ', ' }}
Output
First word: This
First word: This
Second word: is
Last word: filter
All words: This, is, a, demo, of, the, split, filter
strip_html
Rimuove tutti i tag HTML da una stringa.
Codice
<p>Hello</p>
Output
Hello
strip_newlines
Rimuove tutte le interruzioni di riga da una stringa.
Codice
{% capture text %}
A
B
C
{% endcapture %}
{{ text | strip_newlines }}
Output
ABC
text_to_html
Formatta una stringa di testo normale come HTML semplice. Tutto il testo verrà codificato in formato HTML, i blocchi di testo separati da una riga vuota verranno suddivisi in tag di paragrafo <p>, le singole interruzioni di riga verranno sostituite con <br> e gli URL verranno convertiti in collegamenti ipertestuali.
Codice
{{ note.notetext | text_to_html }}
Output
<p>This is the first paragraph of notetext. It contains a URL: <a href="https://example.com/" rel="nofollow">https://example.com</a></p>
<p>This is a second paragraph.</p>
truncate
Tronca una stringa in un numero specificato di caratteri. I puntini sospensivi (...) sono aggiunti la stringa e sono inclusi nel numero di caratteri.
Codice
{{ 'This is a long run of text.' | truncate: 10 }}
Output
This is...
truncate_words
Tronca una stringa in un numero specificato di parole. I puntini sospensivi (...) sono aggiunti alla stringa troncata.
Codice
{{ 'This is a long run of text.' | truncate_words: 3 }}
Output
This is a...
upcase
Converte una stringa in lettere maiuscole.
Codice
{{ 'MIxed Case TExt' | upcase }}
Output
MIXED CASE TEXT
url_escape
Eseguire l'escape con URI da includere in un URL.
Codice
{{ 'This & that//' | url_escape }}
Output
This+%26+that%2F%2F
xml_escape
Eseguire l'escape con XML da includere in un output XML.
Codice
{{ '<p>test</p>' | xml_escape }}
Output
<p>test</p>
Filtri tipo
I filtri tipo consentono di convertire i valori di un tipo in altri tipi.
boolean
Tenta di convertire un valore di stringa in un valore booleano. Se il valore è già booleano, verrà restituito invariato. Se il valore non può essere convertito in booleano, verrà restituito null.
Questo filtro accetterà anche on, enabled o sì come true e off, disabled e no come false.
Codice
{{ true | boolean }}
{{ 'false' | boolean }}
{{ 'enabled' | boolean }}
{{ settings['something/enabled'] | boolean | default: false }}
Output
true
false
true
false
decimal
Tenta di convertire un valore di stringa in un numero decimale. Se il valore è già un numero booleano, verrà restituito invariato. Se il valore non può essere convertito in un numero decimale, verrà restituito il valore null.
Codice
{{ 10.1 | decimal }}
{{ '3.14' | decimal }}
{{ 'text' | decimal | default: 3.14 }}
Output
10.1
3.14
3.14
integer
Tenta di convertire un valore di stringa in un numero intero. Se il valore è già un numero intero, verrà restituito invariato. Se il valore non può essere convertito in un numero intero, verrà restituito il valore null.
Codice
{{ 10 | integer }}
{{ '10' | integer }}
{{ '10.1' | integer }}
{{ 'text' | integer | default: 2 }}
Output
10
10
2
string
Tenta di convertire un valore nella sua rappresentazione di stringa. Se il valore è già una stringa, verrà restituito invariato. Se il valore è null, verrà restituito null.
Filtri URL
I filtri URL consentono di creare o estrarre parti di URL.
add_query
Aggiunge un parametro di stringa di query a un URL. Se il parametro è già presente nell'URL, il valore del parametro verrà aggiornato.
Se questo filtro è applicato a un URL assoluto completo, un URL assoluto aggiornato sarà il risultato. Se viene applicato a un percorso, un percorso aggiornato sarà il risultato.
Codice
{{ 'https://example.com/path?page=1' | add_query: 'foo', 'bar' }}
{{ '/path?page=1' | add_query: 'page', 2 }}
Output
https://example.com/path?page=1&foo=bar
/path?page=2
base
Ottiene l'URL di base di un URL specificato.
Codice
{{ 'https://example.com/path?foo=bar&page=2' | base }}
Output
https://example.com
host
Ottiene la parte host di un URL.
Codice
{{ 'https://example.com/path?foo=bar&page=2' | host }}
Output
example.com
path
Ottiene la parte del percorso di un URL.
Codice
{{ 'https://example.com/path?foo=bar&page=2' | path }}
{{ '/path?foo=bar&page=2' | path }}
Output
/path
/path
path_and_query
Ottiene la parte percorso e query di un URL.
Codice
{{ 'https://example.com/path?foo=bar&page=2' | path_and_query }}
{{ '/path?foo=bar&page=2' | path_and_query }}
Output
/path?foo=bar&page=2
/path?foo=bar&page=2
port
Visualizza il numero di porta di un URL.
Codice
{{ 'https://example.com/path?foo=bar&page=2' | port }}
{{ 'https://example.com/path?foo=bar&page=2' | port }}
{{ 'https://example.com:9000/path?foo=bar&page=2' | port }}
Output
80
443
9000
remove_query
Rimuove un parametro di stringa di query da un URL. Se il parametro non esiste nell'URL, l'URL verrà restituito invariato.
Se questo filtro è applicato a un URL assoluto completo, un URL assoluto aggiornato sarà il risultato. Se viene applicato a un percorso, un percorso aggiornato sarà il risultato.
Codice
{{ 'https://example.com/path?page=1' | remove_query: 'page' }}
{{ '/path?page=1' | remove_query: 'page' }}
Output
https://example.com/path
/path
scheme
Ottiene la parte dello scherma di un URL.
Codice
{{ 'https://example.com/path?foo=bar&page=2' | scheme }}
{{ 'https://example.com/path?foo=bar&page=2' | scheme }}
Output
http
https
Filtri aggiuntivi
Questi filtri offrono utili funzionalità generali.
default
Restituisce un valore predefinito per qualsiasi variabile senza valore assegnato (ad esempio null).
Codice
{{ snippets[Header] | default: 'My Website' }}
Output
<!-- If a snippet with the name Header returns null -->
My Website
file_size
Applicato a un valore del numero che rappresenta una serie di byte, restituisce una dimensione file formattata con un'unità di scala appropriata.
Facoltativamente, è possibile passare un parametro di precisione, per controllare il numero di posizioni decimali nel risultato. La precisione predefinita è 1.
Codice
{{ 10000000 | file_size }}
{{ 2050 | file_size: 0 }}
{{ entity.notes.first.filesize | file_size: 2 }}
Output
9.5 MB
2 KB
207.14 KB
has_role
Applicato a un utente, restituisce true se l'utente appartiene al ruolo specificato. In caso contrario, restituisce false.
Codice
{% assign is_admin = user | has_role: 'Administrators' %}
{% if is_admin %}
User is an administrator.
{% endif %}
liquid
Esegue il rendering di un codice Liquid. Questo codice avrà accesso al contesto di esecuzione Liquid corrente (variabili, ecc.).
Nota
Questo filtro deve essere utilizzato con prudenza e devono in genere essere applicati solo ai valori sotto controllo esclusivo degli autori del contenuto del portale, o altri utenti che possono considerarsi fidati per scrivere il codice Liquid.
Codice
{{ page.adx_copy | liquid }}
Vedi anche
Archiviazione di contenuto di origine utilizzando modelli Web
Informazioni sugli operatori Liquid
Tipi Liquid
Oggetti Liquid
Tag Liquid
Filtri Liquid
Nota
Puoi indicarci le tue preferenze di lingua per la documentazione? Partecipa a un breve sondaggio. (il sondaggio è in inglese)
Il sondaggio richiederà circa sette minuti. Non viene raccolto alcun dato personale (Informativa sulla privacy).