Käytettävissä olevat Liquid-suodattimet

Liquid-suodattimia käytetään muokkaamaan tuotoksen merkkijonoja, lukuja, muuttujia ja objekteja. Ne erotetaan kohdearvostaan |-merkillä.

{{ 'hal 9000' | upcase }} <!-- Output: HAL 9000 -->

Jotkin suodattimet hyväksyvät parametreja. Suodattimia voidaan myös yhdistää, ja ne sovelletaan järjestyksessä vasemmalta oikealle.

{{ 2 | times: 2 | minus: 1 }} <!-- Output: 3 -->

{{ "Hello, " | append: user.firstname }} <!-- Output: Hello, Dave -->

Seuraavassa osassa kuvataan erilaiset suodattimet.

Matriisin suodattimet

Matriisin suodattimia käytetään Liquid-tyyppien kanssa työskentelyyn.

batch

Jakaa matriisin useampaan tietynkokoiseen matriisiin.

Koodi

{% assign batches = entityview.records | batch: 2 %}

{% for batch in batches %}

<ul>

{% for item in batch %}

<li>{{ item.fullname }}</li>

{% endfor %}

</ul>

{% endfor %}

Tuloste

<ul>

<li>John Smith</li>

<li>Dave Thomas</li>

</ul>

<ul>

<li>Jake Johnson</li>

<li>Jack Robinson</li>

</ul>

concat

Yhdistää kaksi matriisia yhdeksi uudeksi matriisiksi.

Yksittäisen kohdeparametrin kanssa concat palauttaa uuden matriisin, joka koostuu alkuperäisestä matriisista, jossa annettu kohde on viimeinen elementti.

Koodi

Group #1: {{ group1 | join: ', ' }}

Group #2: {{ group2 | join: ', ' }}

Group #1 + Group #2: {{ group1 | concat: group2 | join: ', ' }}

Group #1 + Leslie: {{ group1 | concat: 'Leslie' | join: ', ' }}

Tuloste

Group #1: John, Pete, Hannah

Group #2: Joan, Bill

Group #1 + Group #2: John, Pete, Hannah, Joan, Bill

Group #1 + Leslie: John, Pete, Hannah, Leslie

except

Valitse kaikki matriisin objektit, joissa tietyllä määritteellä ei ole annettua arvoa. (Tämä on where-toiminnon käänteistoiminto.)

Koodi

{% assign redmond = entityview.records | except: 'address1_city', 'Redmond' %}

{% for item in redmond %}

{{ item.fullname }}

{% endfor %}

Tuloste

Jack Robinson

first

Palauttaa matriisin ensimmäisen elementin.

first-suodatinta voidaan käyttää myös erityisen pistenotaation kanssa tapauksissa, joissa sitä on käytettävä tunnisteen sisällä.

Koodi

{% assign words = "This is a run of text" | split: " " %}

{{ words | first }}

{% if words.first == "This" %}

The first word is "This".

{% endif %}

Tuloste

{% assign words = "This is a run of text" | split: " " %}

{{ words | first }}

{% if words.first == "This" %}

The first word is "This".

{% endif %}

group_by

Ryhmittele matriisin kohteet tietyn määritteen mukaan.

Koodi

{% assign groups = entityview.records | group_by: 'address1_city' %}

{% for group in groups %}

{{ group.key }}:

{% for item in group.items %}

{{ item.fullname }}

{% endfor %}

{% endfor %}

Tuloste

Redmond:

John Smith

Dave Thomas

Jake Johnson

New York:

Jack Robinson

join

Yhdistää taulukon elementit parametrinä välitetyllä merkillä. Tuloksena on yksi merkkijono.

Koodi

{% assign words = "This is a run of text" | split: " " %}

{{ words | join: ", " }}

Tuloste

{% assign words = "This is a run of text" | split: " " %}

{{ words | join: ", " }}

last

Palauttaa matriisin viimeisen elementin.

last-suodatinta voidaan käyttää myös erityisen pistenotaation kanssa tapauksissa, joissa sitä on käytettävä tunnisteen sisällä.

Koodi

{% assign words = "This is a run of text" | split: " " -%}

{{ words | last }}

{% if words.last == "text" -%}

The last word is "text".

{% endif -%}

Tuloste

{% assign words = "This is a run of text" | split: " " -%}

{{ words | last }}

{% if words.last == "text" -%}

The last word is "text".

{% endif -%}

order_by

Palauttaa matriisin elementit järjestettynä tietyllä matriisin elementtien määritteellä.

Voit halutessasi antaa desc-suodattimen toisena parametrina lajitellaksesi elementit laskevaan järjestykseen nousevan järjestyksen sijaan.

Koodi

{{ entityview.records | order_by: 'fullname' | join: ', ' }}

{{ entityview.records | order_by: 'fullname', 'desc' | join: ', ' }}

Tuloste

Dave Thomas, Jack Robinson, Jake Johnson, John Smith

John Smith, Jake Johnson, Jack Robinson, Dave Thomas

random

Palauttaa matriisin yhden satunnaisesti valitun kohteen.

Koodi

{{ group1 | join: ', ' }}

{{ group1 | random }}

Tuloste

John, Pete, Hannah

Pete

select

Valitsee tietyn määritteen arvon jokaiselle matriisin kohteelle ja palauttaa kyseiset arvot matriisina.

Koodi

{{ entityview.records | select: 'address1_city' | join: ', ' }}

Tuloste

Redmond, New York

shuffle

Matriisiin käytettynä palauttaa uuden matriisin, joka sisältää samat kohteet satunnaisessa järjestyksessä.

Koodi

{{ group1 | join: ', ' }}

{{ group1 | shuffle | join: ', ' }}

Tuloste

John, Pete, Hannah

Hannah, John, Pete

size

Palauttaa matriisin kohteiden määrän.

size-suodatinta voidaan käyttää myös erityisen pistenotaation kanssa tapauksissa, joissa sitä on käytettävä tunnisteen sisällä.

Koodi

{% assign words = "This is a run of text" | split: " " -%}

{{ words | size }}

{% if words.size == 6 -%}

The text contains 6 words.

{% endif -%}

Tuloste

{% assign words = "This is a run of text" | split: " " -%}

{{ words | size }}

{% if words.size == 6 -%}

The text contains 6 words.

{% endif -%}

skip

Ohittaa tietyn määrän matriisin kohteista ja palauttaa loput.

Koodi

{% assign words = "This is a run of text" | split: " " %}

{{ words | skip: 3 | join: ', ' }}

Tuloste

{% assign words = "This is a run of text" | split: " " %}

{{ words | skip: 3 | join: ', ' }}

take

Poimii tietyn määrän matriisin kohteita ja palauttaa poimitut kohteet.

Koodi

{% assign words = "This is a run of text" | split: " " %}

{{ words | take: 3 | join: ', ' }}

Tuloste

{% assign words = "This is a run of text" | split: " " %}

{{ words | take: 3 | join: ', ' }}

then_by

Lisää order_by-suodatettuun matriisiin lisäjärjestyksen.

Voit halutessasi antaa desc-suodattimen toisena parametrina lajitellaksesi elementit laskevaan järjestykseen nousevan järjestyksen sijaan.

Koodi

{{ entityview.records | order_by: 'address1_city' | then_by: 'fullname' | join: ', ' }}

{{ entityview.records | order_by: 'address1_city' | then_by: 'fullname', 'desc' | join: ', ' }}

Tuloste

Dave Thomas, Jack Robinson, Jake Johnson, John Smith

John Smith, Jake Johnson, Jack Robinson, Dave Thomas

where

Valitse kaikki matriisin objektit, joissa tietyllä määritteellä on annettu arvo.

Koodi

{% assign redmond = entityview.records | where: 'address1_city', 'Redmond' %}

{% for item in redmond %}

{{ item.fullname }}

{% endfor %}

Tuloste

John Smith

Dave Thomas

Jake Johnson

Päivämääräsuodattimet

Päivämääräsuodattimia voidaan käyttää päivämäärälaskuihin tai DateTime-arvojen muuntamiseen eri muotoihin.

date

Muotoilee DateTime-arvon .NET-muotoilumerkkijonon avulla.

Tavanomaiset päivämäärän ja ajan muotoilumerkkijonot

Mukautetut päivämäärän ja ajan muotoilumerkkijonot

Koodi

{{ now | date: 'g' }}

{{ now | date: 'MMMM dd, yyyy' }}

Tuloste

{{ now | date: 'g' }}

{{ now | date: 'MMMM dd, yyyy' }}

date_add_days

Lisää määritetyn määrän kokonaisia ja osittaisia päiviä DateTime-arvoon. Parametri voi olla positiivinen tai negatiivinen.

Koodi

{{ now }}

{{ now | date_add_days: 1 }}

{{ now | date_add_days: -2.5 }}

Tuloste

{{ now }}

{{ now | date_add_days: 1 }}

{{ now | date_add_days: -2.5 }}

date_add_hours

Lisää määritetyn määrän kokonaisia ja osittaisia tunteja DateTime-arvoon. Parametri voi olla positiivinen tai negatiivinen.

Koodi

{{ now }}

{{ now | date_add_hours: 1 }}

{{ now | date_add_hours: -2.5 }}

Tuloste

{{ now }}

{{ now | date_add_hours: 1 }}

{{ now | date_add_hours: -2.5 }}

date_add_minutes

Lisää määritetyn määrän kokonaisia ja osittaisia minuutteja DateTime-arvoon. Parametri voi olla positiivinen tai negatiivinen.

Koodi

{{ now }}

{{ now | date_add_minutes: 10 }}

{{ now | date_add_minutes: -2.5 }}

Tuloste

{{ now }}

{{ now | date_add_minutes: 10 }}

{{ now | date_add_minutes: -2.5 }}

date_add_months

Lisää määritetyn määrän kokonaisia kuukausia DateTime-arvoon. Parametri voi olla positiivinen tai negatiivinen.

Koodi

{{ now }}

{{ now | date_add_months: 1 }}

{{ now | date_add_months: -2 }}

Tuloste

{{ now }}

{{ now | date_add_months: 1 }}

{{ now | date_add_months: -2 }}

date_add_seconds

Lisää määritetyn määrän kokonaisia ja osittaisia sekunteja DateTime-arvoon. Parametri voi olla positiivinen tai negatiivinen.

Koodi

{{ now }}

{{ now | date_add_seconds: 10 }}

{{ now | date_add_seconds: -1.25 }}

Tuloste

{{ now }}

{{ now | date_add_seconds: 10 }}

{{ now | date_add_seconds: -1.25 }}

date_add_years

Lisää määritetyn määrän kokonaisia vuosia DateTime-arvoon. Parametri voi olla positiivinen tai negatiivinen.

Koodi

{{ now }}

{{ now | date_add_years: 1 }}

{{ now | date_add_years: -2 }}

Tuloste

{{ now }}

{{ now | date_add_years: 1 }}

{{ now | date_add_years: -2 }}

date_to_iso8601

Muotoilee DateTime-arvon ISO 8601 -standardin mukaisesti. Hyödyllinen, kun luodaan Atom-syötteitä tai HTML5:n <time>-elementtejä.

Koodi

{{ now | date_to_iso8601 }}

Tuloste

{{ now | date_to_iso8601 }}

date_to_rfc822

Muotoilee DateTime-arvon RFC 822 -standardin mukaisesti. Hyödyllinen, kun luodaan RSS-syötteitä.

Koodi

{{ now | date_to_rfc822 }}

Tuloste

{{ now | date_to_rfc822 }}

Entiteettiluettelon suodattimet

Entiteettiluettelon suodattimia käytetään tiettyjen entitylist-määritteiden arvojen käsittelyyn ja uusien entiteettiluettelonäkymien luomiseen.

current_sort

Palauttaa lajittelulausekkeelle tietyn määritteen nykyisen lajittelusuunnan.

Koodi

{{ 'name ASC, createdon DESC' | current_sort: 'createdon' }}

Tuloste

DESC

metafilters

Jäsentää entitylist filter_definition-määritteen JSON-arvon suodatinasetusten ryhmäobjekteihin.

metafilters-suodattimelle voi vaihtoehtoisesti antaa nykyisen määritesuodattimen kyselyn ja nykyisen entitylist-objektin, jolloin palautetut suodatinobjektit merkitään joko valituksi tai ei valituksi.

reverse_sort

Kääntää lajittelun suunnan annetulle lajittelusuunnalle.

Koodi

<!-- Sort direction is not case-sensitive -->

{{ 'ASC' | reverse_sort }}

{{ 'desc' | reverse_sort }}

Tuloste

DESC

ASC

Matemaattiset suodattimet

Matemaattisten suodattimien avulla voit suorittaa laskutoimituksia Liquid-tyypeille.

Matemaattisia suodattimia voi ketjuttaa muiden suodattimien tapaan, ja ne käsitellään järjestyksessä vasemmalta oikealle.

Koodi

{{ 10 | times: 2 | minus: 5 | divided_by: 3 }}

Tuloste

{{ 10 | times: 2 | minus: 5 | divided_by: 3 }}

ceil

Pyöristää arvon ylöspäin lähimpään kokonaislukuun.

Koodi

{{ 4.6 | ceil }}

{{ 4.3 | ceil }}

Tuloste

5

5

divided_by

Jakaa luvun toisella luvulla.

Koodi

{{ 10 | divided_by: 2 }}

{{ 10 | divided_by: 3 }}

{{ 10.0 | divided_by: 3 }}

Tuloste

{{ 10 | divided_by: 2 }}

{{ 10 | divided_by: 3 }}

{{ 10.0 | divided_by: 3 }}

floor

Pyöristää arvon alaspäin lähimpään kokonaislukuun.

Koodi

{{ 4.6 | floor }}

{{ 4.3 | floor }}

Tuloste

4

4

minus

Vähentää luvun toisesta luvusta.

Koodi

<!-- entityview.page = 11 -->

{{ entityview.page | minus: 1 }}

{{ 10 | minus: 1.1 }}

{{ 10.1 | minus: 1 }}

Tuloste

10

{{ 10 | minus: 1.1 }}

{{ 10.1 | minus: 1 }}

modulo

Jakaa luvun toisella luvulla ja palauttaa jakojäännöksen.

Koodi

{{ 12 | modulo: 5 }}

Tuloste

{{ 12 | modulo: 5 }}

plus

Lisää numeron toiseen numeroon.

Koodi

<!-- entityview.page = 11 -->

{{ entityview.page | plus: 1 }}

{{ 10 | plus: 1.1 }}

{{ 10.1 | plus: 1 }}

Tuloste

12

{{ 10 | plus: 1.1 }}

{{ 10.1 | plus: 1 }}

round

Pyöristää arvon lähimpään kokonaislukuun tai annettuun määrään desimaaleja.

Koodi

{{ 4.6 | round }}

{{ 4.3 | round }}

{{ 4.5612 | round: 2 }}

Tuloste

5

4

4.56

times

Kertoo luvun toisella luvulla.

Koodi

{{ 10 | times: 2 }}

{{ 10 | times: 2.2 }}

{{ 10.1 | times: 2 }}

Tuloste

{{ 10 | times: 2 }}

{{ 10 | times: 2.2 }}

{{ 10.1 | times: 2 }}

Merkkijonosuodattimet

Merkkijonosuodattimet käsittelevät Liquid-tyyppejä.

append

Liittää merkkijonon toisen merkkijonon loppuun.

Koodi

{{ 'filename' | append: '.js' }}

Tuloste

{{ 'filename' | append: '.js' }}

capitalize

vaihtaa merkkijonon ensimmäisen kirjaimen isoksi.

Koodi

{{ 'capitalize me' | capitalize }}

Tuloste

{{ 'capitalize me' | capitalize }}

downcase

Muuntaa merkkijonon pieniksi kirjaimiksi.

Koodi

{{ 'MIxed Case TExt' | downcase }}

Tuloste

{{ 'MIxed Case TExt' | downcase }}

escape

Erottaa merkkijonon HTML-koodissa.

Koodi

{{ '<p>test</p>' | escape }}

Tuloste

<p>test</p>

newline_to_br

Lisää <br /> -rivinvaihdon HTML-tunnisteen jokaiselle merkkijonon rivinvaihdolle.

Koodi

{% capture text %}

A

B

C

{% endcapture %}

{{ text | newline_to_br }}

Tuloste

A<br />

B<br />

C<br />

prepend

Liittää merkkijonon toisen merkkijonon alkuun.

Koodi

{{ 'Jane Johnson' | prepend: 'Dr. ' }}

Tuloste

{{ 'Jane Johnson' | prepend: 'Dr. ' }}

remove

Poistaa kaikki alimerkkijonon esiintymät merkkijonosta.

Koodi

{{ 'Hello, Dave. How are you, Dave?' | remove: 'Dave' }}

Tuloste

{{ 'Hello, Dave. How are you, Dave?' | remove: 'Dave' }}

remove_first

Poistaa alimerkkijonon ensimmäisen esiintymän merkkijonosta.

Koodi

{{ 'Hello, Dave. How are you, Dave?' | remove_first: 'Dave' }}

Tuloste

{{ 'Hello, Dave. How are you, Dave?' | remove_first: 'Dave' }}

replace

Korvaa kaikki merkkijonon esiintymät alimerkkijonolla.

Koodi

{{ 'Hello, Dave. How are you, Dave?' | replace: 'Dave', 'John' }}

Tuloste

{{ 'Hello, Dave. How are you, Dave?' | replace: 'Dave', 'John' }}

replace_first

Korvaa merkkijonon ensimmäisen esiintymän alimerkkijonolla.

Koodi

{{ 'Hello, Dave. How are you, Dave?' | replace_first: 'Dave', 'John' }}

Tuloste

{{ 'Hello, Dave. How are you, Dave?' | replace_first: 'Dave', 'John' }}

split

Split-suodatin käyttää alimerkkijonoa parametrinä. Alimerkkijonoa käytetään erottimena, jolla merkkijon jaetaan matriisiksi.

Koodi

{% 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: ', ' }}

Tuloste

{% 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: ', ' }}

strip_html

Poistaa merkkijonosta kaikki HTML-tunnisteet.

Koodi

<p>Hello</p>

Tuloste

Hello

strip_newlines

Poistaa merkkijonosta kaikki rivinvaihdot.

Koodi

{% capture text %}

A

B

C

{% endcapture %}

{{ text | strip_newlines }}

Tuloste

ABC

text_to_html

Muotoilee tekstimuotoinen merkkijonon yksinkertaisessa HTML-muodossa. Kaikki teksti HTML-koodataan, tyhjien rivien erottamat tekstilohkot ympäröidään kappalejaon <p>-tunnisteilla, yksittäiset rivinvaihdot korvataan <br>-tunnisteilla ja URL-osoitteet muutetaan hyperlinkeiksi.

Koodi

{{ note.notetext | text_to_html }}

Tuloste

<p>This is the first paragraph of notetext. It contains a URL: <a href="http://example.com/" rel="nofollow">http://example.com</a></p>

<p>This is a second paragraph.</p>

truncate

Katkaisee merkkijonon määritetyn merkkimäärän mittaiseksi. Kolme pistettä, jotka lasketaan merkkimäärään, liitetään merkkijonon loppuun.

Koodi

{{ 'This is a long run of text.' | truncate: 10 }}

Tuloste

{{ 'This is a long run of text.' | truncate: 10 }}

truncate_words

Katkaisee merkkijonon määritetyn sanamäärän mittaiseksi. Kolme pistettä lisätään katkaistun merkkijonon loppuun.

Koodi

{{ 'This is a long run of text.' | truncate_words: 3 }}

Tuloste

{{ 'This is a long run of text.' | truncate_words: 3 }}

upcase

Muuntaa merkkijonon isoiksi kirjaimiksi.

Koodi

{{ 'MIxed Case TExt' | upcase }}

Tuloste

{{ 'MIxed Case TExt' | upcase }}

url_escape

URI-erottaa merkkijonon käytettäväksi URL-osoitteessa.

Koodi

{{ 'This & that//' | url_escape }}

Tuloste

This+%26+that%2F%2F

xml_escape

XML-erottaa merkkijonon käytettäväksi XML-tulosteessa.

Koodi

{{ '<p>test</p>' | xml_escape }}

Tuloste

<p>test</p>

Tyypin suodattimet

Tyypin suodattimien avulla muuntaa tietyn tyypin arvot toisiksi tyypeiksi.

boolean

Merkkijonoarvon muuntaminen totuusarvoksi. Jos arvo on jo totuusarvo, se palautetaan muuttumattomana. Jos arvoa ei voi muuntaa totuusarvoksi, palautetaan tyhjäarvo.

Suodatin hyväksyy myös Tosi-arvoiksi "on", "käytössä" tai "kyllä" ja Epätosi-arvoiksi "off", "ei käytössä" ja "ei".

Koodi

{{ true | boolean }}

{{ 'false' | boolean }}

{{ 'enabled' | boolean }}

{{ settings['something/enabled'] | boolean | default: false }}

Tuloste

{{ true | boolean }}

{{ 'false' | boolean }}

{{ 'enabled' | boolean }}

false

decimal

Merkkijonoarvon muuntaminen desimaaliluvuksi. Jos arvo on jo desimaaliluku, se palautetaan muuttumattomana. Jos arvoa ei voi muuntaa desimaaliluvuksi, palautetaan tyhjäarvo.

Koodi

{{ 10.1 | decimal }}

{{ '3.14' | decimal }}

{{ 'text' | decimal | default: 3.14 }}

Tuloste

{{ 10.1 | decimal }}

{{ '3.14' | decimal }}

{{ 'text' | decimal | default: 3.14 }}

integer

Merkkijonoarvon muuntaminen kokonaisluvuksi. Jos arvo on jo kokonaisluku, se palautetaan muuttumattomana. Jos arvoa ei voi muuntaa kokonaisluvuksi, palautetaan tyhjäarvo.

Koodi

{{ 10 | integer }}

{{ '10' | integer }}

{{ '10.1' | integer }}

{{ 'text' | integer | default: 2 }}

Tuloste

{{ 10 | integer }}

{{ '10' | integer }}

{{ '10.1' | integer }}

{{ 'text' | integer | default: 2 }}

string

Arvon muuntaminen merkkijonoesitykseksi. Jos arvo on jo merkkijono, se palautetaan muuttumattomana. Jos arvo on tyhjäarvo, palautetaan myös tyhjäarvo.

URL-osoitteen suodattimet

URL-osoitteen suodattimien avulla voit rakentaa tai purkaa URL-osoitteiden osia.

add_query

Lisää kyselyn merkkijonoparametrin URL-osoitteeseen. Jos URL-osoitteen parametri on jo olemassa, parametriarvo päivitetään.

Jos tätä suodatinta käytetään koko absoluuttinen URL-osoitteeseen, tulos on päivitetty absoluuttinen URL-osoite. Jos sitä käytetään polkuun, tulos on päivitetty polku.

Koodi

{{ 'http://example.com/path?page=1' | add_query: 'foo', 'bar' }}

{{ '/path?page=1' | add_query: 'page', 2 }}

Tuloste

{{ 'http://example.com/path?page=1' | add_query: 'foo', 'bar' }}

{{ '/path?page=1' | add_query: 'page', 2 }}

base

Hakee määritetyn URL-osoitteen perusosan.

Koodi

{{ 'http://example.com/path?foo=bar&page=2' | base }}

Tuloste

http://example.com

host

Hakee URL-osoitteen isäntäosan.

Koodi

{{ 'http://example.com/path?foo=bar&page=2' | host }}

Tuloste

{{ 'http://example.com/path?foo=bar&page=2' | host }}

path

Hakee URL-osoitteen polkuosan.

Koodi

{{ 'http://example.com/path?foo=bar&page=2' | path }}

{{ '/path?foo=bar&page=2' | path }}

Tuloste

{{ 'http://example.com/path?foo=bar&page=2' | path }}

{{ '/path?foo=bar&page=2' | path }}

path_and_query

Hakee URL-osoitteen polku- ja kyselyosan.

Koodi

{{ 'http://example.com/path?foo=bar&page=2' | path_and_query }}

{{ '/path?foo=bar&page=2' | path_and_query }}

Tuloste

/path?foo=bar&page=2

/path?foo=bar&page=2

port

Hakee URL-osoitteen porttinumeron.

Koodi

{{ 'http://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 }}

Tuloste

{{ 'http://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 }}

remove_query

Poistaa kyselyn merkkijonoparametrin URL-osoitteesta. Jos parametria ei ole URL-osoitteessa, URL-osoite palautetaan muuttumattomana.

Jos tätä suodatinta käytetään koko absoluuttinen URL-osoitteeseen, tulos on päivitetty absoluuttinen URL-osoite. Jos sitä käytetään polkuun, tulos on päivitetty polku.

Koodi

{{ 'http://example.com/path?page=1' | remove_query: 'page' }}

{{ '/path?page=1' | remove_query: 'page' }}

Tuloste

{{ 'http://example.com/path?page=1' | remove_query: 'page' }}

{{ '/path?page=1' | remove_query: 'page' }}

scheme

Hakee URL-osoitteen rakenneosan.

Koodi

{{ 'http://example.com/path?foo=bar&page=2' | scheme }}

{{ 'https://example.com/path?foo=bar&page=2' | scheme }}

Tuloste

{{ 'http://example.com/path?foo=bar&page=2' | scheme }}

{{ 'https://example.com/path?foo=bar&page=2' | scheme }}

Lisäsuodattimet

Nämä suodattimet mahdollistavat hyödyllisiä yleistoimintoja.

default

Palauttaa minkä tahansa muuttujan oletusarvon, jolle ei ole määritetty arvoa (eli tyhjäarvoa).

Koodi

{{ snippets["Header"] | default: 'My Website' }}

Tuloste

<!-- If a snippet with the name "Header" returns null -->

My Website

file_size

Kun tätä käytetään useita tavuja edustavaan numeroarvoon, palauttaa muotoillun tiedostokoon ja asianmukaisen yksikön.

Voit myös antaa vapaaehtoisen tarkkuusparametrin, jolla voit hallita tuloksen desimaalipaikkojen määrää. Oletustarkkuus on 1.

Koodi

{{ 10000000 | file_size }}

{{ 2050 | file_size: 0 }}

{{ entity.notes.first.filesize | file_size: 2 }}

Tuloste

9.5 MB

2 KB

207.14 KB

has_role

Kohdistetaan user-objektille, palauttaa Tosi-arvon, jos käyttäjä kuuluu tiettyyn rooliin. Palauttaa Epätosi-arvon, jos ei kuulu.

Koodi

{% assign is_admin = user | has_role: 'Administrators' %}

{% if is_admin %}

User is an administrator.

{% endif %}

liquid

Hahmontaa merkkijonon Liquid-koodina. Tällä koodilla on pääsy nykyiseen Liquid-suorituskontekstiin (muuttujat jne.).

Huomautus

Tätä suodatinta tulisi käyttää varoen ja yleensä ainoastaan arvoille, jotka ovat portaalin sisällöntuottajien tai muiden, Liquid-koodin käytössä luotettavien käyttäjien yksinomaisessa hallinnassa.

Koodi

{{ page.adx_copy | liquid }}

Katso myös

Dynaamisen sisällön lisääminen ja mukautettujen mallien luominen
Lähdesisällön tallentaminen verkkomallien avulla
Tietoja Liquid-operaattoreista Liquid-tyypit
Liquid-objektit
Liquid-tunnisteet
Liquid Filters