Käytettävissä olevat Liquid-suodattimet

Artikkeli
08/15/2023

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

{{ 'hal 9000' | upcase }} 

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 suodattimien avulla käytetään arrays-objekteja.

erä

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

Tuloste

Group #1: John, Pete, Hannah

Group #2: Joan, Bill

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

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

Ensimmäinen

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

This

The first word is This.

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

This, is, a, run, of, text

Viimeinen

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

text

The last word is text.

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

6

The text contains 6 words.

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

run, of, text

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


This, is, a

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

jossa

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.

päivämäärä

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

5/7/2018 7:20 AM

May 07, 2018

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

5/7/2018 7:20:46 AM

5/8/2018 7:20:46 AM

5/4/2018 7:20:46 PM

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

5/7/2018 7:20:46 AM

5/7/2018 8:20:46 AM

5/7/2018 4:50:46 AM

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

5/7/2018 7:20:46 AM

5/7/2018 7:30:46 AM

5/7/2018 7:18:16 AM

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

5/7/2018 7:20:46 AM

6/7/2018 7:20:46 AM

3/7/2018 7:20:46 AM

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

5/7/2018 7:20:46 AM

5/7/2018 7:20:56 AM

5/7/2018 7:20:45 AM

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

5/7/2018 7:20:46 AM

5/7/2019 7:20:46 AM

5/7/2016 7:20:46 AM

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

2018-05-07T07:20:46Z

date_to_rfc822

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

Koodi

{{ now | date_to_rfc822 }}

Tuloste

Mon, 07 May 2018 07:20:46 Z

Ohitussuodattimet

Ohitussarjoilla voit lisätä merkkijonoihin erikoismerkkejä ilman, että ne ovat ristiriidassa kyseisten merkkien säännöllisen tulkitsemisen kanssa ohjelmointikielen tai muodon mukaan.

Seuraavat ohitussuodattimet korvaavat merkkijonomerkit ohitussarjoilla tai poistavat kohdetyyppiin perustuvat virheelliset merkkijonomerkit.

escape

Erottaa merkkijonon HTML-koodissa.

Koodi

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

Tuloste

&lt;p&gt;test&lt;/p&gt;

html_safe_escape

Muuntaa tietyn HTML-merkkijonon turvalliseksi HTML-osaksi.

Koodi

{{ '<img src="images/myimage.jpg" onerror="alert(1);">' | html_safe_escape }}

Tuloste

<img src="images/myimage.jpg">

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

&lt;p&gt;test&lt;/p&gt;

Luettelon suodattimet

Luettelon suodattimia käytetään tiettyjen entitylist-määritteiden arvojen käsittelyyn ja uusien luettelonä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-suodatinmäärityksen 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.

Koodi

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

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 numbers-objekteissa.

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

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

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

modulo

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

Koodi

{{ 12 | modulo: 5 }}

Tuloste

plus

Lisää numeron toiseen numeroon.

Koodi

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

{{ entityview.page | plus: 1 }}

{{ 10 | plus: 1.1 }}

{{ 10.1 | plus: 1 }}

Tuloste

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

times

Kertoo luvun toisella luvulla.

Koodi

{{ 10 | times: 2 }}

{{ 10 | times: 2.2 }}

{{ 10.1 | times: 2 }}

Tuloste

Merkkijonosuodattimet

Merkkijonosuodattimet käsittelevät strings-objekteja.

lisäys

Liittää merkkijonon toisen merkkijonon loppuun.

Koodi

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

Tuloste

filename.js

capitalize

vaihtaa merkkijonon jokaisen sanan ensimmäisen kirjaimen isoksi.

Koodi

{{ 'capitalize me' | capitalize }}

Tuloste

Capitalize Me

downcase

Muuntaa merkkijonon pieniksi kirjaimiksi.

Koodi

{{ 'MIxed Case TExt' | downcase }}

Tuloste

mixed case text

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

Dr. Jane Johnson

remove

Poistaa kaikki alimerkkijonon esiintymät merkkijonosta.

Koodi

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

Tuloste

Hello, . How are you, ?

remove_first

Poistaa alimerkkijonon ensimmäisen esiintymän merkkijonosta.

Koodi

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

Tuloste

Hello, . How are you, Dave?

replace

Korvaa kaikki merkkijonon esiintymät alimerkkijonolla.

Koodi

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

Tuloste

Hello, John. How are you, John?

replace_first

Korvaa merkkijonon ensimmäisen esiintymän alimerkkijonolla.

Koodi

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

Tuloste

Hello, John. How are you, Dave?

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

First word: This

First word: This

Second word: is

Last word: filter

All words: This, is, a, demo, of, the, split, filter

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. 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="https://example.com/" rel="nofollow">https://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...

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

upcase

Muuntaa merkkijonon isoiksi kirjaimiksi.

Koodi

{{ 'MIxed Case TExt' | upcase }}

Tuloste

MIXED CASE TEXT

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 pois, ei käytössä ja ei.

Koodi

{{ true | boolean }}

{{ 'false' | boolean }}

{{ 'enabled' | boolean }}

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

Tuloste

true

false

true

false

desimaali

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

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

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

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

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

Tuloste

https://example.com/path?page=1&foo=bar

/path?page=2

base

Hakee määritetyn URL-osoitteen perusosan.

Koodi

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

Tuloste

https://example.com

host

Hakee URL-osoitteen isäntäosan.

Koodi

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

Tuloste

example.com

path

Hakee URL-osoitteen polkuosan.

Koodi

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

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

Tuloste

/path

/path

path_and_query

Hakee URL-osoitteen polku- ja kyselyosan.

Koodi

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

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

Tuloste

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

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

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

Tuloste

https://example.com/path

/path

scheme

Hakee URL-osoitteen rakenneosan.

Koodi

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

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

Tuloste

http

https

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

H

Antaa määritteen HTML-esityksen. Esimerkki: FetchXML-kyselyn XML-määritteen HTML-esitys.

Koodi

{{ samplequery.xml | h }}

Tuloste

<fetch mapping="logical" count="5000" page="1" returntotalrecordcount="true"> <entity name="contact"> <attribute name="fullname" /> </entity> </fetch>

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

Muistiinpano

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

Koodi

{{ page.adx_copy | liquid }}

Jaa

Käytettävissä olevat Liquid-suodattimet

Matriisin suodattimet

erä

concat

except

Ensimmäinen

group_by

join

Viimeinen

order_by

random

select

shuffle

size

skip

take

then_by

jossa

Päivämääräsuodattimet

päivämäärä

date_add_days

date_add_hours

date_add_minutes

date_add_months

date_add_seconds

date_add_years

date_to_iso8601

date_to_rfc822

Ohitussuodattimet

escape

html_safe_escape

url_escape

xml_escape

Luettelon suodattimet

current_sort

metafilters

reverse_sort

Matemaattiset suodattimet

ceil

divided_by

floor

minus

modulo

plus

round

times

Merkkijonosuodattimet

lisäys

capitalize

downcase

newline_to_br

prepend

remove

remove_first

replace

replace_first

split

strip_html

strip_newlines

text_to_html

truncate

truncate_words

upcase

Tyypin suodattimet

boolean

desimaali

integer

string

URL-osoitteen suodattimet

add_query

base

host

path

path_and_query

port

remove_query

scheme

Lisäsuodattimet

default