المرشحات Filters في Liquid
تعرض هذه الصفحة كل المرشحات الموجودة في Liquid مع أمثلة على كل واحدة منها وذكر كل التفاصيل المتعلقة بها، يمكنك استعمال الفهرس للانتقال للمرشح المطلوب مباشرةً.
abs
يعيد هذا المرشّح قيمة العدد المطلقة.
{{ -17 | abs }}
{{ 4 | abs }}
الخرج:
17
4
يعمل المرشّح abs
أيضًا مع سلسلة نصية تحتوي على عدد فقط.
{{ "-19.86" | abs }}
الخرج:
19.86
append
يضيف هذا المرشّح سلسلة نصية محدَّدة إلى نهاية سلسلة نصية أخرى.
{{ "/my/fancy/url" | append: ".html" }}
الخرج:
/my/fancy/url.html
يمكن للمرشّح append
أيضًا قبول متغير كوسيطٍ له.
{% assign filename = "/index.html" %}
{{ "website.com" | append: filename }}
الخرج:
website.com/index.html
at_least
(خاص بالإصدار 4.0.1)
يحدّد قيمة عددٍ ما بالقيمة الدنيا.
{{ 4 | at_least: 5 }}
{{ 4 | at_least: 3 }}
الخرج:
5
4
at_most
(خاص بالإصدار 4.0.1)
يحدّد قيمة عددٍ ما بالقيمة العليا.
{{ 4 | at_most: 5 }}
{{ 4 | at_most: 3 }}
الخرج:
4
3
capitalize
يجعل هذا المرشّح الحرف الأول من سلسلة نصية باللغة الإنجليزية حرفًا كبيرًا ويحوّل الأحرف المتبقية إلى أحرف صغيرة.
{{ "title" | capitalize }}
الخرج:
Title
يُكتَب الحرف الأول فقط من سلسلة نصية إنجليزية كحرف كبير، لذلك لا تُكتَب الأحرف الأولى من الكلمات اللاحقة بأحرف كبيرة:
{{ "my GREAT title" | capitalize }}
الخرج:
My great title
ceil
يقرّب هذا المرشّح الدخل إلى أقرب وأكبر عدد صحيح، إذ تحاول لغة Liquid تحويل الدخل إلى عدد قبل تطبيق المرشّح.
{{ 1.2 | ceil }}
{{ 2.0 | ceil }}
{{ 183.357 | ceil }}
الخرج:
2
2
184
سنستخدم في المثال التالي قيمة الدخل على أنها سلسلة نصية:
{{ "3.5" | ceil }}
الخرج:
4
compact
(خاص بالإصدار 4.0.0)
يزيل هذا المرشّح أي قيم nil
من المصفوفة.
افترض في المثال التالي أن site.pages
عبارة عن مجموعة من صفحات محتوى موقع ويب، وبعض هذه الصفحات لها سِمة attribute تسمى category
تحدّد فئة محتوى الصفحة. إذا ربطنا هذه الفئات مع مصفوفة عبر map
، فقد تكون بعض قيم عناصر المصفوفة nil
إن لم تتضمن صفحةٌ ما السمة category
.
{% assign site_categories = site.pages | map: "category" %}
{% for category in site_categories %}
- {{ category }}
{% endfor %}
الخرج:
- business
- celebrities
-
- lifestyle
- sports
-
- technology
لكن يمكننا إزالة جميع قيم nil
في المصفوفة باستخدام المرشّح compact
عند إنشاء المصفوفة site_categories
.
{% assign site_categories = site.pages | map: "category" | compact %}
{% for category in site_categories %}
- {{ category }}
{% endfor %}
الخرج:
- business
- celebrities
- lifestyle
- sports
- technology
concat
(خاص بالإصدار 4.0.0)
يربط هذا المرشّح (أو يضم معًا) مصفوفات متعددة، إذ تحتوي المصفوفة الناتجة على جميع العناصر من مصفوفات الدخل.
{% assign fruits = "apples, oranges, peaches" | split: ", " %}
{% assign vegetables = "carrots, turnips, potatoes" | split: ", " %}
{% assign everything = fruits | concat: vegetables %}
{% for item in everything %}
- {{ item }}
{% endfor %}
الخرج:
- apples
- oranges
- peaches
- carrots
- turnips
- potatoes
يمكنك تجميع مرشّحات concat
متعددة معًا لضم أكثر من مصفوفتين.
{% assign furniture = "chairs, tables, shelves" | split: ", " %}
{% assign everything = fruits | concat: vegetables | concat: furniture %}
{% for item in everything %}
- {{ item }}
{% endfor %}
الخرج:
- apples
- oranges
- peaches
- carrots
- turnips
- potatoes
- chairs
- tables
- shelves
date
يحوّل هذا المرشّح علامة زمنية timestamp إلى تنسيق تاريخ date آخر، فتنسيق هذه الصيغة هو strftime
نفسه، بينما يستخدم الدخل تنسيق Time.parse
الخاص بلغة روبي Ruby نفسه.
{{ article.published_at | date: "%a, %b %d, %y" }}
الخرج:
Fri, Jul 17, 15
إليك مثال آخر:
{{ article.published_at | date: "%Y" }}
الخرج:
2015
يعمل المرشّح date
مع السلاسل النصية إذا احتوت على تواريخ جيدة التنسيق.
{{ "March 14, 2016" | date: "%b %d, %y" }}
الخرج:
Mar 14, 16
يمكنك الحصول على الوقت الحالي من خلال تمرير الكلمة الخاصة "now"
(أو "today"
) إلى المرشّح date
.
This page was last updated at {{ "now" | date: "%Y-%m-%d %H:%M" }}.
الخرج:
This page was last updated at 2021-04-28 17:52.
لاحظ أن القيمة ستكون هي الوقت الحالي لآخر إنشاء للصفحة من القالب، وليس وقت تقديم الصفحة إلى المستخدم في حالة التخزين المؤقت أو إنشاء موقع ساكن.
default
يضبط قيمة افتراضية للمتغير الذي لا يملك قيمة مُسنَدة. سيظهِر المرشّح default
قيمته إذا كان الدخل قيمة nil
أو false
أو قيمة فارغة.
لم تُحدَّد قيمة المتغير product_price
، لذلك اُستخدِمت القيمة الافتراضية في المثال التالي:
{{ product_price | default: 2.99 }}
الخرج:
2.99
حُدِّدت قيمة المتغير product_price
، لذلك لم تُستخدَم القيمة الافتراضية في المثال التالي:
{% assign product_price = 4.99 %}
{{ product_price | default: 2.99 }}
الخرج:
4.99
قيمة المتغير product_price
فارغة، لذلك اُستخدِمت القيمة الافتراضية في المثال التالي:
{% assign product_price = "" %}
{{ product_price | default: 2.99 }}
الخرج:
2.99
السماح بالقيمة false
(خاص بالإصدار 5.0.0)
يمكن السماح للمتغيرات بأن تعيد القيمة false
بدلًا من القيمة الافتراضية من خلال استخدام العامل allow_false
.
{% assign display_price = false %}
{{ display_price | default: true, allow_false: true }}
الخرج:
false
divided_by
يقسم هذا المرشّح عددًا على عددٍ آخر.
تُقرَّب النتيجة إلى أقرب وأصغر عدد صحيح (كالمرشّح floor
) إذا كان المقسوم عليه عددًا صحيحًا.
{{ 16 | divided_by: 4 }}
{{ 5 | divided_by: 3 }}
الخرج:
4
1
التحكم بعملية التقريب
ينتج عن المرشّح divided_by
نتيجة من نوع المقسوم عليه، أي إذا قسمت على عدد صحيح، فستكون النتيجة عددًا صحيحًا. إذا قسمت على عدد عشري float، فستكون النتيجة عددًا عشريًا.
المقسوم عليه في المثال التالي هو عدد صحيح:
{{ 20 | divided_by: 7 }}
الخرج:
2
المقسوم عليه في المثال التالي هو عدد عشري:
{{ 20 | divided_by: 7.0 }}
الخرج:
2.857142857142857
تغيير أنواع المتغيرات
قد ترغب في استخدام متغير كمقسوم عليه، حيث لا يمكنك في هذه الحالة إضافة .0
لتحويله إلى عدد عشري ببساطة، ولكن يمكنك إسناد assign
نسخة من المتغير محوَّلة إلى عدد عشري باستخدام المرشّح times
.
سنقسم في المثال التالي على متغير يحتوي على عدد صحيح، لذلك سنحصل على عدد صحيح:
{% assign my_integer = 7 %}
{{ 20 | divided_by: my_integer }}
الخرج:
2
نضرب المتغير بالعدد 1.0
باستخدام المرشّح times
لنحصل على عدد عشري، ثم نقسم على عدد عشري في المثال التالي:
{% assign my_integer = 7 %}
{% assign my_float = my_integer | times: 1.0 %}
{{ 20 | divided_by: my_float }}
الخرج:
2.857142857142857
downcase
يجعل هذا المرشّح كل حرف في سلسلة نصية بحالة الأحرف الصغيرة، وليس له تأثير على السلاسل النصية التي تتكون من أحرف صغيرة مسبقًا.
{{ "Parker Moore" | downcase }}
الخرج:
parker moore
إليك مثال آخر:
{{ "apple" | downcase }}
الخرج:
apple
escape
يطبّق هذا المرشّح عملية الهروب على سلسلة نصية عن طريق استبدال المحارف بتسلسلات الهروب escape sequences (بحيث يمكن استخدام هذه السلسلة في عنوان URL مثلًا)، ولا يغيّر السلاسل النصية التي ليس لديها أي شيء لتطبيق عملية الهروب عليه.
{{ "Have you read 'James & the Giant Peach'?" | escape }}
الخرج:
Have you read 'James & the Giant Peach'?
إليك مثال آخر:
{{ "Tetsuro Takara" | escape }}
الخرج:
Tetsuro Takara
escape_once
يطبّق عملية الهروب على سلسلة نصية بدون تغيير الكيانات المُطبَّق عليها الهروب مسبقًا، ولا يغيّر السلاسل النصية التي ليس لديها أي شيء لتطبيق عملية الهروب عليه.
{{ "1 < 2 & 3" | escape_once }}
الخرج:
1 < 2 & 3
إليك مثال آخر:
{{ "1 < 2 & 3" | escape_once }}
الخرج:
1 < 2 & 3
first
يعيد هذا المرشّح العنصر الأول من مصفوفة.
{{ "Ground control to Major Tom." | split: " " | first }}
الخرج:
Ground
إليك مثال آخر:
{% assign my_array = "zebra, octopus, giraffe, tiger" | split: ", " %}
{{ my_array.first }}
الخرج:
zebra
يمكنك استخدام المرشّح first
مع الصيغة النقطية dot notation عندما تحتاج إلى استخدام المرشّح ضمن وسم كما يلي:
{% if my_array.first == "zebra" %}
Here comes a zebra!
{% endif %}
floor
يقرّب هذا المرشّح الدخل إلى أقرب وأصغر عدد صحيح، حيث تحاول لغة Liquid تحويل الدخل إلى عدد قبل تطبيق المرشح.
{{ 1.2 | floor }}
{{ 2.0 | floor }}
{{ 183.357 | floor }}
الخرج:
1
2
183
قيمة الدخل في المثال التالي عبارة عن سلسلة نصية:
{{ "3.5" | floor }}
الخرج:
3
join
يدمج هذا المرشّح العناصر الموجودة في مصفوفة ضمن سلسلة نصية واحدة باستخدام وسيطه كفاصل بينها.
{% assign beatles = "John, Paul, George, Ringo" | split: ", " %}
{{ beatles | join: " and " }}
الخرج:
John and Paul and George and Ringo
last
يعيد هذا المرشّح العنصر الأخير من مصفوفة.
{{ "Ground control to Major Tom." | split: " " | last }}
الخرج:
Tom.
إليك مثال آخر:
{% assign my_array = "zebra, octopus, giraffe, tiger" | split: ", " %}
{{ my_array.last }}
الخرج:
tiger
يمكنك استخدام المرشّح last
مع الصيغة النقطية عندما تحتاج إلى استخدام هذا المرشّح ضمن وسم كما يلي:
{% if my_array.last == "tiger" %}
There goes a tiger!
{% endif %}
lstrip
يزيل هذا المرشّح كل المسافات (مسافات tab والمسافات الفارغة والأسطر الجديدة) من جانب السلسلة النصية الأيسر، ولا يؤثر على المسافات بين الكلمات.
{{ " So much room for activities " | lstrip }}!
الخرج:
So much room for activities !
map
يُنشئ هذا المرشّح مصفوفة من القيم عن طريق استخراج قيم خاصيةٍ مسمَّاة من كائن آخر.
افترض في المثال التالي أن الكائن site.pages
يحتوي على جميع البيانات الوصفية metadata لموقع ويب. يؤدي استخدام الوسم assign
مع المرشّح map
إلى إنشاء متغير يحتوي فقط على قيم خصائص الفئة category
لكل شيء في الكائن site.pages
.
{% assign all_categories = site.pages | map: "category" %}
{% for item in all_categories %}
- {{ item }}
{% endfor %}
الخرج:
- business
- celebrities
- lifestyle
- sports
- technology
minus
يطرح عددًا من عدد آخر.
{{ 4 | minus: 2 }}
{{ 16 | minus: 4 }}
{{ 183.357 | minus: 12 }}
الخرج:
2
12
171.357
modulo
يعيد هذا المرشّح الباقي من عملية قسمة.
{{ 3 | modulo: 2 }}
{{ 24 | modulo: 7 }}
{{ 183.357 | modulo: 12 }}
الخرج:
1
3
3.357
newline_to_br
يدخل هذا المرشّح الفاصل السطري (<br />
) الخاص بلغة HTML أمام كل سطر جديد (\n
) في سلسلة نصية.
{% capture string_with_newlines %}
Hello
there
{% endcapture %}
{{ string_with_newlines | newline_to_br }}
الخرج:
<br />
Hello<br />
there<br />
plus
يجمع هذا المرشّح عددين.
{{ 4 | plus: 2 }}
{{ 16 | plus: 4 }}
{{ 183.357 | plus: 12 }}
الخرج:
6
20
195.357
prepend
يضيف هذا المرشّح سلسلة نصية محدَّدة إلى بداية سلسلة نصية أخرى.
{{ "apples, oranges, and bananas" | prepend: "Some fruit: " }}
الخرج:
Some fruit: apples, oranges, and bananas
يمكن أن يقبل المرشّح prepend
أيضًا متغيرًا كوسيطٍ له.
{% assign url = "example.com" %}
{{ "/index.html" | prepend: url }}
الخرج:
example.com/index.html
remove
يزيل كل ظهور لسلسلة نصية فرعية محدَّدة من سلسلة نصية.
{{ "I strained to see the train through the rain" | remove: "rain" }}
الخرج:
I sted to see the t through the
remove_first
يزيل الظهور الأول فقط لسلسلة نصية فرعية محدَّدة من سلسلة نصية.
{{ "I strained to see the train through the rain" | remove_first: "rain" }}
الخرج:
I sted to see the train through the rain
replace
يستبدل هذا المرشّح كلَّ ظهور لوسيطه الأول في سلسلة نصية بوسيطه الثاني.
{{ "Take my protein pills and put my helmet on" | replace: "my", "your" }}
الخرج:
Take your protein pills and put your helmet on
replace_first
يستبدل الظهور الأول فقط لوسيطه الأول في سلسلة نصية بوسيطه الثاني.
{{ "Take my protein pills and put my helmet on" | replace_first: "my", "your" }}
الخرج:
Take your protein pills and put my helmet on
reverse
يعكس هذا المرشّح ترتيب العناصر في مصفوفة، ولكن لا يمكنه عكس سلسلة نصية.
{% assign my_array = "apples, oranges, peaches, plums" | split: ", " %}
{{ my_array | reverse | join: ", " }}
الخرج:
plums, peaches, oranges, apples
لا يمكن استخدام المرشّح reverse
مع سلسلة نصية مباشرةً، ولكن يمكنك تقسيم split السلسلة إلى مصفوفة، ثم عكس المصفوفة، وإعادة ضمها عن طريق ربط المرشّحات معًا كما يلي:
{{ "Ground control to Major Tom." | split: "" | reverse | join: "" }}
الخرج:
.moT rojaM ot lortnoc dnuorG
round
يُستخدَم لتقريب عدد إلى أقرب عدد صحيح أو إلى العدد المُمرَّر كوسيط الذي يمثل عدد المنازل العشرية.
{{ 1.2 | round }}
{{ 2.7 | round }}
{{ 183.357 | round: 2 }}
الخرج:
1
3
183.36
rstrip
يزيل كل المسافات (مسافات tab والمسافات الفارغة والأسطر الجديدة) من جانب السلسلة الأيمن، ولا يؤثر على المسافات بين الكلمات.
{{ " So much room for activities " | rstrip }}!
الخرج:
So much room for activities!
size
يعيد هذا المرشّح عدد المحارف في سلسلة نصية أو عدد العناصر في مصفوفة.
{{ "Ground control to Major Tom." | size }}
الخرج:
28
إليك مثال آخر:
{% assign my_array = "apples, oranges, peaches, plums" | split: ", " %}
{{ my_array.size }}
الخرج:
4
يمكنك استخدام المرشّح size
مع الصيغة النقطية عندما تحتاج إلى استخدام هذا المرشَح ضمن وسم كما يلي:
{% if site.pages.size > 10 %}
This is a big website!
{% endif %}
slice
يعيد هذا المرشّح سلسلة نصية فرعية مؤلفة من محرف واحد أو يعيد سلسلة من عناصر المصفوفة التي تبدأ بالفهرس المحدَّد باستخدام الوسيط الأول. يحدّد الوسيط الثاني الاختياري طول السلسلة الفرعية أو عدد عناصر المصفوفة المُعادة.
تٌرقَّم فهارس السلسلة النصية أو المصفوفة بدءًا من الصفر 0.
{{ "Liquid" | slice: 0 }}
الخرج:
L
إليك مثال آخر:
{{ "Liquid" | slice: 2 }}
الخرج:
q
ومثال آخر:
{{ "Liquid" | slice: 2, 5 }}
الخرج:
quid
قيمة الدخل عبارة عن مصفوفة في المثال التالي:
{% assign beatles = "John, Paul, George, Ringo" | split: ", " %}
{{ beatles | slice: 1, 2 }}
الخرج:
PaulGeorge
إذا كان الوسيط الأول عبارة عن عدد سالب، تُحسَب الفهارس من نهاية السلسلة النصية.
{{ "Liquid" | slice: -3, 2 }}
الخرج:
ui
sort
يرتب هذا المرشّح عناصر المصفوفة بترتيب حسّاس لحالة الأحرف.
{% assign my_array = "zebra, octopus, giraffe, Sally Snake" | split: ", " %}
{{ my_array | sort | join: ", " }}
الخرج:
Sally Snake, giraffe, octopus, zebra
يحدّد الوسيط الاختياري خاصيةً من عناصر المصفوفة لاستخدامها في عملية الترتيب.
{% assign products_by_price = collection.products | sort: "price" %}
{% for product in products_by_price %}
<h4>{{ product.title }}</h4>
{% endfor %}
sort_natural
(خاص بالإصدار 4.0.0)
يرتب العناصر في مصفوفة بترتيب غير حساس لحالة الأحرف.
{% assign my_array = "zebra, octopus, giraffe, Sally Snake" | split: ", " %}
{{ my_array | sort_natural | join: ", " }}
الخرج:
giraffe, octopus, Sally Snake, zebra
يحدّد الوسيط الاختياري خاصيةً من عناصر المصفوفة لاستخدامها في عملية الترتيب.
{% assign products_by_company = collection.products | sort_natural: "company" %}
{% for product in products_by_company %}
<h4>{{ product.title }}</h4>
{% endfor %}
split
يقسم هذا المرشّح سلسلة نصية إلى مصفوفة باستخدام وسيطه كفاصل بين العناصر، حيث يُستخدَم المرشّح split
لتحويل العناصر المفصول بينها بفواصل من سلسلة نصية إلى مصفوفة.
{% assign beatles = "John, Paul, George, Ringo" | split: ", " %}
{% for member in beatles %}
{{ member }}
{% endfor %}
الخرج:
John
Paul
George
Ringo
strip
يزيل هذا المرشّح كل المسافات (مسافات tabs والمسافات الفارغة والأسطر الجديدة) من جانبي السلسلة النصية الأيسر والأيمن، ولا يؤثر على المسافات بين الكلمات.
{{ " So much room for activities " | strip }}!
الخرج:
So much room for activities!
strip_html
يزيل وسوم لغة HTML من سلسلة نصية.
{{ "Have <em>you</em> read <strong>Ulysses</strong>?" | strip_html }}
الخرج:
Have you read Ulysses?
strip_newlines
يزيل محارف الأسطر الجديدة (فواصل الأسطر) من سلسلة نصية.
{% capture string_with_newlines %}
Hello
there
{% endcapture %}
{{ string_with_newlines | strip_newlines }}
الخرج:
Hellothere
times
يضرب عددًا بعدد آخر.
{{ 3 | times: 2 }}
{{ 24 | times: 7 }}
{{ 183.357 | times: 12 }}
الخرج:
6
168
2200.284
truncate
يقتطع سلسلة نصية وصولًا إلى عدد المحارف الذي مُرِّر كوسيط. إذا كان عدد المحارف المحدَّد أقل من طول السلسلة، فستُلحَق علامة القطع ellipsis (...) بالسلسلة النصية وتُضمَّن في عدد المحارف.
{{ "Ground control to Major Tom." | truncate: 20 }}
الخرج:
Ground control to...
علامات القطع المخصصة
يأخذ المرشّح truncate
وسيطًا ثانيًا اختياريًا يحدّد سلسلة المحارف المراد إلحاقها بالسلسلة المقتطَعة. علامة القطع هي (...) افتراضيًا، ولكن يمكنك تحديد سلسلة مختلفة.
يُحسَب طول الوسيط الثاني مع عدد المحارف المحدَّد بواسطة الوسيط الأول، فإذا أردت اقتطاع سلسلة نصية إلى 10 محارف بالضبط مع استخدام علامة القطع المكونة من 3 محارف مثلًا، فاستخدم القيمة 13 لوسيط المرشّح truncate
الأول، لأن علامة القطع تُعَد 3 محارف.
{{ "Ground control to Major Tom." | truncate: 25, ", and so on" }}
الخرج:
Ground control, and so on
استخدام المرشح truncate بدون علامات القطع
يمكنك اقتطاع سلسلة نصية إلى عدد المحارف المحدَّد بواسطة الوسيط الأول، مع تجنّب إظهار المحارف اللاحقة من خلال تمرير سلسلة نصية فارغة كوسيط ثانٍ.
{{ "Ground control to Major Tom." | truncate: 20, "" }}
الخرج:
Ground control to Ma
truncatewords
يقصّر هذا المرشّح من طول السلسلة النصية وصولًا إلى عدد الكلمات الممرَّرة كوسيط. إذا كان عدد الكلمات المحدَّد أقل من عدد الكلمات في السلسلة النصية، فستُلحَق علامة القطع (...) بالسلسلة النصية.
{{ "Ground control to Major Tom." | truncatewords: 3 }}
الخرج:
Ground control to...
علامات القطع المخصصة
يأخذ المرشّح truncatewords
وسيطًا ثانيًا اختياريًا يحدّد سلسلة المحارف المراد إلحاقها بالسلسلة المقتطَعة. علامة القطع هي (...) افتراضيًا، ولكن يمكنك تحديد سلسلة مختلفة.
{{ "Ground control to Major Tom." | truncatewords: 3, "--" }}
الخرج:
Ground control to--
استخدام المرشح truncatewords بدون علامات القطع
يمكنك تجنّب إظهار المحارف اللاحقة من خلال تمرير سلسلة نصية فارغة كوسيط ثانٍ.
{{ "Ground control to Major Tom." | truncatewords: 3, "" }}
الخرج:
Ground control to
uniq
يزيل العناصر المكرَّرة في المصفوفة.
{% assign my_array = "ants, bugs, bees, bugs, ants" | split: ", " %}
{{ my_array | uniq | join: ", " }}
الخرج:
ants, bugs, bees
upcase
يجعل هذا المرشّح كل حرف في السلسلة النصية باللغة الإنجليزية حرفًا كبيرًا، وليس له أي تأثير على السلاسل النصية التي تتكوّن كلها من أحرف كبيرة مسبقًا.
{{ "Parker Moore" | upcase }}
الخرج:
PARKER MOORE
إليك مثال آخر:
{{ "APPLE" | upcase }}
الخرج:
APPLE
url_decode
(خاص بالإصدار 4.0.0)
يفك هذا المرشّح تشفير سلسلة نصية مُشفَّرة كعنوان URL أو مُشفَّرة باستخدام المرشّح url_encode
.
{{ "%27Stop%21%27+said+Fred" | url_decode }}
الخرج:
'Stop!' said Fred
url_encode
يحوّل محارف عنوان URL غير آمن في سلسلة نصية إلى محارف مُشفَّرة كنسبة مئوية.
{{ "john@liquid.com" | url_encode }}
الخرج:
john%40liquid.com
لاحظ أن المرشّح url_encode
سيحول المسافة إلى إشارة +
بدلًا من استخدام محرف النسبة المئوية المُشفَّر.
{{ "Tetsuro Takara" | url_encode }}
الخرج:
Tetsuro+Takara
where
(خاص بالإصدار 4.0.2)
ينشئ هذا المرشّح مصفوفة تتضمن فقط الكائنات التي تملك قيمة خاصية معينة، أو أي قيمة صحيحة truthy افتراضيًا.
افترض في المثال التالي أن لديك قائمة بالمنتجات وتريد عرض منتجات مطبخك منفصلة عن بعضها البعض. يمكنك باستخدام المرشّح where
إنشاء مصفوفة تحتوي فقط على المنتجات التي لها النوع "type"
مطبخ "kitchen"
.
All products:
{% for product in products %}
- {{ product.title }}
{% endfor %}
{% assign kitchen_products = products | where: "type", "kitchen" %}
Kitchen products:
{% for product in kitchen_products %}
- {{ product.title }}
{% endfor %}
الخرج:
All products:
- Vacuum
- Spatula
- Television
- Garlic press
Kitchen products:
- Spatula
- Garlic press
افترض أن لديك قائمة بالمنتجات وتريد فقط إظهار المنتجات المتاحة للشراء. يمكنك استخدام المرشّح where
مع اسم خاصية ولكن بدون قيمة مستهدفة لتضمين جميع المنتجات ذات القيمة الصحيحة truthy وهي "available"
.
All products:
{% for product in products %}
- {{ product.title }}
{% endfor %}
{% assign available_products = products | where: "available" %}
Available products:
{% for product in available_products %}
- {{ product.title }}
{% endfor %}
الخرج:
All products:
- Coffee mug
- Limited edition sneakers
- Boring sneakers
Available products:
- Coffee mug
- Boring sneakers
يمكن أيضًا استخدام المرشّح where
للعثور على كائن في مصفوفة عند دمجه مع المرشّح first
. لنفترض مثلًا أنك تريد عرض القميص shirt في مجموعتك الجديدة لفصل الخريف.
{% assign new_shirt = products | where: "type", "shirt" | first %}
Featured product: {{ new_shirt.title }}
الخرج:
Featured product: Hawaiian print sweater vest