Liquid/filters
المرشّحات Filters
abs
يعيد هذا المرشّح قيمة عدد المطلقة.
| الدخل |
|---|
{{ -17 | abs }}
{{ 4 | abs }}
|
| الخرج |
|---|
17
|
يعمل المرشّح 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
|
at_most (خاص بالإصدار 4.0.1)
يَحُدّ من عددٍ ما إلى حد القيمة الأعلى.
| الدخل | الخرج |
|---|---|
{{ 4 | at_most: 5 }}
{{ 4 | at_most: 3 }}
|
4
|
capitalize
يجعل هذا المرشّح الحرف الأول من سلسلة نصية حرفًا كبيرًا ويحوّل الأحرف المتبقية إلى أحرف صغيرة.
| الدخل | الخرج |
|---|---|
{{ "title" | capitalize }}
|
Title
|
يُكتَب الحرف الأول فقط من السلسلة النصية كحرف كبير، لذلك لا تُكتَب الأحرف الأولى من الكلمات اللاحقة بأحرف كبيرة:
| الدخل | الخرج |
|---|---|
{{ "my GREAT title" | capitalize }}
|
My great title
|
ceil
يقرّب هذا المرشّح الدخل إلى أقرب عدد صحيح. تحاول لغة Liquid تحويل الدخل إلى عدد قبل تطبيق المرشّح.
| الدخل | الخرج |
|---|---|
{{ 1.2 | ceil }}
{{ 2.0 | ceil }}
{{ 183.357 | ceil }}
|
2
|
سنستخدم في المثال التالي قيمة الدخل كسلسلة نصية:
| الدخل | الخرج |
|---|---|
{{ "3.5" | ceil }}
|
4
|
compact (خاص بالإصدار 4.0.0)
يزيل هذا المرشّح أي قيم nil من المصفوفة.
افترض في المثال التالي أن site.pages عبارة عن مجموعة من صفحات محتوى موقع ويب، وبعض هذه الصفحات لها سِمة تسمى 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
|