Қолжетімді Liquid сүзгілері

Жолдар, нөмірлер, айнымалылар және нысандар шығысын өзгертуге Liquid сүзгілері пайдаланылады. Олар | таңбасы арқылы өздері қолданылатын мәннен бөлінеді.

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

Кейбір сүзгілер параметрлерді қабылдайды. Сонымен қатар, сүзгілерді біріктіруге және сол жақтан оң жаққа қолдануға болады.

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

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

Төмендегі бөлімде әртүрлі сүзгілер сипатталған.

Көрсеткі сүзгілері

Жиым сүзгілері Liquid түрлерімен бірге жұмыс істеу үшін пайдаланылады.

batch

Көрсеткіні берілген өлшемді бірнеше көрсеткіге бөледі.

Код

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

{% for batch in batches %}

<ul>

{% for item in batch %}

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

{% endfor %}

</ul>

{% endfor %}

Нәтиже

<ul>

<li>John Smith</li>

<li>Dave Thomas</li>

</ul>

<ul>

<li>Jake Johnson</li>

<li>Jack Robinson</li>

</ul>

concat

Екі көрсеткіні жалғыз жаңа көрсеткіге біріктіреді.

Жалғыз элемент параметр ретінде берілсе, concat берілген элемент соңғы элемент болатын бастапқы жиымнан тұратын жаңа жиымды қайтарады.

Код

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

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

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

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

Нәтиже

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

Берілген төлсипатта берілген мән болмайтын көрсеткідегі барлық нысандарды таңдаңыз. (Бұл — where инверсиясы.)

Код

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

{% for item in redmond %}

{{ item.fullname }}

{% endfor %}

Нәтиже

Jack Robinson

first

Көрсеткінің бірінші элементін қайтарады.

Сонымен қатар, тег ішінде пайдалану керек жағдайларда first сүзгісін арнайы нүктелі жазуымен бірге пайдалануға болады.

Код

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

{{ words | first }}

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

The first word is "This".

{% endif %}

Нәтиже

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

{{ words | first }}

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

The first word is "This".

{% endif %}

group_by

Элементтерді берілген төлсипат бойынша көрсеткіге топтастырыңыз.

Код

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

{% for group in groups %}

{{ group.key }}:

{% for item in group.items %}

{{ item.fullname }}

{% endfor %}

{% endfor %}

Нәтиже

Redmond:

John Smith

Dave Thomas

Jake Johnson

New York:

Jack Robinson

join

Көрсеткі элементтерін параметр ретінде өткен таңбамен қосады. Нәтижесі — жалғыз жол.

Код

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

{{ words | join: ", " }}

Нәтиже

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

{{ words | join: ", " }}

last

Көрсеткінің соңғы элементін қайтарады.

Сонымен қатар, тег ішінде пайдалану керек жағдайларда last сүзгісін арнайы нүктелі жазуымен бірге пайдалануға болады.

Код

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

{{ words | last }}

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

The last word is "text".

{% endif -%}

Нәтиже

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

{{ words | last }}

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

The last word is "text".

{% endif -%}

order_by

Көрсеткі элементтерінің берілген төлсипаты бойынша реттелетін көрсеткі элементтерін қайтарады.

Оған қоса, элементтерді өсу ретімен емес, кему ретімен сұрыптау үшін desc параметрін екінші параметр ретінде көрсетуге болады.

Код

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

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

Нәтиже

Dave Thomas, Jack Robinson, Jake Johnson, John Smith

John Smith, Jake Johnson, Jack Robinson, Dave Thomas

random

Көрсеткіден жалғыз кездейсоқ таңдалған элементті қайтарады.

Код

{{ group1 | join: ', ' }}

{{ group1 | random }}

Нәтиже

John, Pete, Hannah

Pete

select

Көрсеткідегі әрбір элементтің берілген төлсипаты мәнін таңдайды және осы мәндерді көрсеткі ретінде қайтарады.

Код

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

Нәтиже

Redmond, New York

shuffle

Көрсеткіге қолданылған, жаңа көрсеткіні бір элементтермен кездейсоқ ретпен қайтарады.

Код

{{ group1 | join: ', ' }}

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

Нәтиже

John, Pete, Hannah

Hannah, John, Pete

size

Көрсеткіден элементтер санын қайтарады.

Сонымен қатар, тег ішінде пайдалану керек жағдайларда size сүзгісін арнайы нүктелі жазуымен бірге пайдалануға болады.

Код

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

{{ words | size }}

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

The text contains 6 words.

{% endif -%}

Нәтиже

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

{{ words | size }}

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

The text contains 6 words.

{% endif -%}

skip

Көрсеткідегі элементтердің берілген санын өткізіп жібереді және қалғанын қайтарады.

Код

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

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

Нәтиже

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

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

take

Алынған элементтерді қайтарумен көрсеткіден элементтердің берілген санын алады.

Код

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

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

Нәтиже

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

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

then_by

order_by арқылы реттеліп қойылған жиымға қосымша жүйелі ретті қосады.

Оған қоса, элементтерді өсу ретімен емес, кему ретімен сұрыптау үшін desc параметрін екінші параметр ретінде көрсетуге болады.

Код

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

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

Нәтиже

Dave Thomas, Jack Robinson, Jake Johnson, John Smith

John Smith, Jake Johnson, Jack Robinson, Dave Thomas

where

Берілген төлсипатта берілген мән болатын көрсеткідегі барлық нысандарды таңдаңыз.

Код

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

{% for item in redmond %}

{{ item.fullname }}

{% endfor %}

Нәтиже

John Smith

Dave Thomas

Jake Johnson

Күн сүзгілері

Күн сүзгілері күн арифметикасына пайдаланылады немесе Күн/уақыт мәндері түрлі пішімдерге түрлендіруге мүмкіндік береді.

date

Күн/уақыт мәнін .NET пішім жолымен пішімдейді.

Стандартты күн және уақыт пішімі параметрлері

Реттелетін күн және уақыт пішімі параметрлері

Код

{{ now | date: 'g' }}

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

Нәтиже

{{ now | date: 'g' }}

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

date_add_days

Күн/уақыт мәніне толық және бөлінген күндердің көрсетілгенін санын қосады. Параметр оң немесе теріс болуы мүмкін.

Код

{{ now }}

{{ now | date_add_days: 1 }}

{{ now | date_add_days: -2.5 }}

Нәтиже

{{ now }}

{{ now | date_add_days: 1 }}

{{ now | date_add_days: -2.5 }}

date_add_hours

Күн/уақыт мәніне толық және бөлінген сағаттардың көрсетілгенін санын қосады. Параметр оң немесе теріс болуы мүмкін.

Код

{{ now }}

{{ now | date_add_hours: 1 }}

{{ now | date_add_hours: -2.5 }}

Нәтиже

{{ now }}

{{ now | date_add_hours: 1 }}

{{ now | date_add_hours: -2.5 }}

date_add_minutes

Күн/уақыт мәніне толық және бөлінген минуттардың көрсетілгенін санын қосады. Параметр оң немесе теріс болуы мүмкін.

Код

{{ now }}

{{ now | date_add_minutes: 10 }}

{{ now | date_add_minutes: -2.5 }}

Нәтиже

{{ now }}

{{ now | date_add_minutes: 10 }}

{{ now | date_add_minutes: -2.5 }}

date_add_months

Күн/уақыт мәніне толық айлардың көрсетілгенін санын қосады. Параметр оң немесе теріс болуы мүмкін.

Код

{{ now }}

{{ now | date_add_months: 1 }}

{{ now | date_add_months: -2 }}

Нәтиже

{{ now }}

{{ now | date_add_months: 1 }}

{{ now | date_add_months: -2 }}

date_add_seconds

Күн/уақыт мәніне толық және бөлінген секундтардың көрсетілгенін санын қосады. Параметр оң немесе теріс болуы мүмкін.

Код

{{ now }}

{{ now | date_add_seconds: 10 }}

{{ now | date_add_seconds: -1.25 }}

Нәтиже

{{ now }}

{{ now | date_add_seconds: 10 }}

{{ now | date_add_seconds: -1.25 }}

date_add_years

Күн/уақыт мәніне толық жылдардың көрсетілгенін санын қосады. Параметр оң немесе теріс болуы мүмкін.

Код

{{ now }}

{{ now | date_add_years: 1 }}

{{ now | date_add_years: -2 }}

Нәтиже

{{ now }}

{{ now | date_add_years: 1 }}

{{ now | date_add_years: -2 }}

date_to_iso8601

Күн/уақыт мәнін ISO 8601 стандартына сәйкес пішімдейді. Атом арналарын немесе HTML5 <time> элементін жасау кезінде пайдалы.

Код

{{ now | date_to_iso8601 }}

Нәтиже

{{ now | date_to_iso8601 }}

date_to_rfc822

Күн/уақыт мәнін RFC 822 стандартына сәйкес пішімдейді. RSS арналарын жасау кезінде пайдалы.

Код

{{ now | date_to_rfc822 }}

Нәтиже

{{ now | date_to_rfc822 }}

Нысандар тізімінің сүзгілері

Нысандар тізімінің сүзгілері белгілі бір нысандар тізімі төлсипатының мәндерімен жұмыс істеуге және нысандар тізімі көріністерін жасауға пайдаланылады.

current_sort

Сұрыптау өрнегін беріп, берілген төлсипат үшін ағымдағы сұрыптау бағытын қайтарады.

Код

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

Нәтиже

DESC

метасүзгілер

entitylist filter_definition JSON мәнін сүзгі параметрлері тобының нысандарына талдайды.

метасүзгілерде таңдау бойынша ағымдағы төлсипат сүзгісі сұрауын және ағымдағы нысандан тізімін көрсетуге боалды. Бұл қайтарылған сүзгі нысандарына таңдалған немесе таңдалмаған жалаушасын қоюға мүмкіндік береді.

reverse_sort

Сұрыптау бағытын беріп, кері сұрыптау бағытын қайтарады.

Код

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

{{ 'ASC' | reverse_sort }}

{{ 'desc' | reverse_sort }}

Нәтиже

DESC

ASC

Математикалық сүзгілер

Математикалық сүзгілер Liquid түрлеріне қатысты математикалық әрекеттерді орындауға мүмкіндік береді.

Барлық сүзгілер, математикалық сүзгілер тіркелуі мүмкін және сол жақтан оң жаққа қолданылады.

Код

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

Нәтиже

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

ceil

Мәнді ең жақын бүтін санға жоғары дөңгелектейді.

Код

{{ 4.6 | ceil }}

{{ 4.3 | ceil }}

Нәтиже

5

5

divided_by

Санды басқа санға бөледі.

Код

{{ 10 | divided_by: 2 }}

{{ 10 | divided_by: 3 }}

{{ 10.0 | divided_by: 3 }}

Нәтиже

{{ 10 | divided_by: 2 }}

{{ 10 | divided_by: 3 }}

{{ 10.0 | divided_by: 3 }}

floor

Мәнді ең жақын бүтін санға төмен дөңгелектейді.

Код

{{ 4.6 | floor }}

{{ 4.3 | floor }}

Нәтиже

4

4

minus

Санды басқа санға азайтады.

Код

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

{{ entityview.page | minus: 1 }}

{{ 10 | minus: 1.1 }}

{{ 10.1 | minus: 1 }}

Нәтиже

10

{{ 10 | minus: 1.1 }}

{{ 10.1 | minus: 1 }}

modulo

Санды басқа санға бөледі және еске салғышты қайтарады.

Код

{{ 12 | modulo: 5 }}

Нәтиже

{{ 12 | modulo: 5 }}

plus

Санды басқа санға қосады.

Код

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

{{ entityview.page | plus: 1 }}

{{ 10 | plus: 1.1 }}

{{ 10.1 | plus: 1 }}

Нәтиже

12

{{ 10 | plus: 1.1 }}

{{ 10.1 | plus: 1 }}

round

Мәнді ең жақын бүтін санға немесе көрсетілген ондық бөлшектер санына дөңгелектейді.

Код

{{ 4.6 | round }}

{{ 4.3 | round }}

{{ 4.5612 | round: 2 }}

Нәтиже

5

4

4.56

times

Санды басқа санға көбейтеді.

Код

{{ 10 | times: 2 }}

{{ 10 | times: 2.2 }}

{{ 10.1 | times: 2 }}

Нәтиже

{{ 10 | times: 2 }}

{{ 10 | times: 2.2 }}

{{ 10.1 | times: 2 }}

Жол сүзгілері

Жол сүзгілері Liquid түрлерін басқарады.

append

Жолды басқа жол шетіне қосады.

Код

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

Нәтиже

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

capitalize

Жолдағы бірінші сөзді бас әріпке өзгертеді.

Код

{{ 'capitalize me' | capitalize }}

Нәтиже

{{ 'capitalize me' | capitalize }}

downcase

Жолды кіші әріпке түрлендіреді.

Код

{{ 'MIxed Case TExt' | downcase }}

Нәтиже

{{ 'MIxed Case TExt' | downcase }}

escape

HTML-жолдан шығады.

Код

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

Нәтиже

<p>test</p>

newline_to_br

Жолдағы әрбір жол жол үзілісінде <br /> жол үзілісі HTML тегін кірістіреді.

Код

{% capture text %}

A

B

C

{% endcapture %}

{{ text | newline_to_br }}

Нәтиже

A<br />

B<br />

C<br />

prepend

Жолды басқа жол басына қосады.

Код

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

Нәтиже

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

remove

Жолдан қосымша жолдың барлық қайталануын жою.

Код

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

Нәтиже

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

remove_first

Жолдан қосымша жолдың бірінші қайталануын жояды.

Код

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

Нәтиже

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

replace

Қосымша жолды жолдың барлық қайталануын ауыстырады.

Код

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

Нәтиже

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

replace_first

Жолдың бірінші қайталануын қосымша жолмен ауыстырады.

Код

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

Нәтиже

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

split

split сүзгісі қосымша жолды параметр ретінде қабылдайды. Қосымша жол жолды көрсеткіге бөлетін бөлгіш ретінде пайдаланылады.

Код

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

Нәтиже

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

Барлық HTML тегтерін жолдан қиып алады.

Код

<p>Hello</p>

Нәтиже

Hello

strip_newlines

Жолдан барлық жол үзілістерін қиып алады.

Код

{% capture text %}

A

B

C

{% endcapture %}

{{ text | strip_newlines }}

Нәтиже

ABC

text_to_html

Қарапайым мәтін жолын қарапайым HTML ретінде пішімдейді. Барлық мәтін HTML кодталады, бос жолмен бөлінген мәтін блоктары параграф <p> тегтерімен оралады, жалғыз жол үзілістері <br> тегімен ауыстырылады және URL мекенжайлары еренсілтемелерге түрлендіріледі.

Код

{{ note.notetext | text_to_html }}

Нәтиже

<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

Жолды берілген таңбалар санына қысқартады. Көп нүкте (...) жолға қосылады және таңба санына қосылады.

Код

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

Нәтиже

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

truncate_words

Жолды берілген сөздер санына қысқартады. Көп нүкте (...) қысқартылған жолға қосылады.

Код

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

Нәтиже

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

upcase

Жолды бас әріпке түрлендіреді.

Код

{{ 'MIxed Case TExt' | upcase }}

Нәтиже

{{ 'MIxed Case TExt' | upcase }}

url_escape

URI-жолдан шығу, URL мекенжайына қосуға арналған.

Код

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

Нәтиже

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

xml_escape

XML-жолдан шығу, XML шығысына қосуға арналған.

Код

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

Нәтиже

<p>test</p>

Түр сүзгілері

Түр сүзгілері бір түрлі мәндерді басқа түрлеріне түрлендіруге мүмкіндік береді.

boolean

Жол мәнін логикалық мәнге түрлендіруге әрекет жасайды. Егер мән бұрыннан логикалық болса, ол өзгеріссіз қайтарылады. Егер мәнді логикалық мәнге түрлендіру мүмкін болмаса, null мәні қайтарылады.

Сондай-ақ бұл сүзгі шын болса «on», «enabled» немесе «yes» мәндерін және жалған болса «off», «disabled» және «no» мәндерін қабылдайды.

Код

{{ true | boolean }}

{{ 'false' | boolean }}

{{ 'enabled' | boolean }}

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

Нәтиже

{{ true | boolean }}

{{ 'false' | boolean }}

{{ 'enabled' | boolean }}

false

decimal

Жол мәнін ондық санға түрлендіруге әрекет жасайды. Егер мән бұрыннан ондық сан болса, ол өзгеріссіз қайтарылады. Егер мәнді ондық санға түрлендіру мүмкін болмаса, null мәні қайтарылады.

Код

{{ 10.1 | decimal }}

{{ '3.14' | decimal }}

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

Нәтиже

{{ 10.1 | decimal }}

{{ '3.14' | decimal }}

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

integer

Жол мәнін бүтін санға түрлендіруге әрекет жасайды. Егер мән бұрыннан бүтін сан болса, ол өзгеріссіз қайтарылады. Егер мәнді бүтін санға түрлендіру мүмкін болмаса, null мәні қайтарылады.

Код

{{ 10 | integer }}

{{ '10' | integer }}

{{ '10.1' | integer }}

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

Нәтиже

{{ 10 | integer }}

{{ '10' | integer }}

{{ '10.1' | integer }}

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

string

Мәнді жол көрсетіліміне түрлендіруге әрекет жасалады. Егер мән бұрыннан жол болса, ол өзгеріссіз қайтарылады. Егер мән null болса, null мәні қайтарылады.

URL сүзгілері

URL сүзгілері URL бөліктерін құрастыруға немесе шығаруға мүмкіндік береді.

add_query

Сұрау жолы параметрін URL мекенжайына қосады. Егер URL мекенжайында параметр бұрыннан болса, параметр мәні жаңартылады.

Егер осы сүзгі толық абсолютті URL мекенжайына қолданылса, жаңартылған абсолютті URL мекенжайы орын алады. Егер жолға қолданылса, жаңартылған жол орын алады.

Код

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

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

Нәтиже

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

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

base

Берілген URL негізгі URL алады.

Код

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

Нәтиже

http://example.com

host

URL хост бөлігін алады.

Код

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

Нәтиже

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

path

URL жол бөлігін алады.

Код

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

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

Нәтиже

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

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

path_and_query

URL жол және сұрау бөлігін алады.

Код

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

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

Нәтиже

/path?foo=bar&page=2

/path?foo=bar&page=2

port

URL порт нөмірін алады.

Код

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

Нәтиже

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

URL мекенжайынан сұрау жолы параметрін жояды. Егер URL мекенжайында параметр болмаса, URL өзгеріссіз қайтарылады.

Егер осы сүзгі толық абсолютті URL мекенжайына қолданылса, жаңартылған абсолютті URL мекенжайы орын алады. Егер жолға қолданылса, жаңартылған жол орын алады.

Код

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

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

Нәтиже

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

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

scheme

URL схема бөлігін алады.

Код

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

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

Нәтиже

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

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

Қосымша өрістер

Осы өрістер пайдалы жалпы функция береді.

default

Мән тағайындалмаған кез келген айнымалы үшін әдепкі мәнді қайтарады (яғни null мәнін).

Код

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

Нәтиже

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

My Website

file_size

Байттар санын көрсететін сандық мәнге қолданылады, тиісті шкала бірлігімен пішімделген файл өлшемін қайтарады.

Көбінесе нәтижедегі ондық бөлшек санын басқару үшін дәлдік параметрі өтуі мүмкін. Әдепкі дәлдік — 1.

Код

{{ 10000000 | file_size }}

{{ 2050 | file_size: 0 }}

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

Нәтиже

9.5 MB

2 KB

207.14 KB

has_role

Пайдаланушы төлсипатына қолданылса, пайдаланушы берілген рөлге тиесілі болса, true мәнін қайтарады. Егер болмаса, false мәнін қайтарады.

Код

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

{% if is_admin %}

User is an administrator.

{% endif %}

liquid

Liquid коды ретінде жолды көрсетеді. Бұл кодта ағымдағы Liquid орындау контекстіне қатынас болады (айнымалылар, т.б.).

Ескерім

Бұл өріс сақтықпен пайдаланылуы керек және портал мазмұны авторлары немесе Liquid кодын жаза алатын басқа пайдаланушылар бақылауында мәндерге ғана қолданылуы керек.

Код

{{ page.adx_copy | liquid }}

Сонымен қатар, қараңыз

Динамикалық мазмұн қосу және теңшелетін үлгілер жасау
Веб-үлгілермен бастапқы мазмұнды сақтау
Liquid амалдағыштарын түсіну Liquid түрлері
Liquid нысандары
Liquid тегтері
Liquid сүзгілері