المرشحات في لغة القوالب Liquid
تدعم لغة القوالب (Liquid) مفهوم المُرشحات ال (Filters) وهي عبارة عن طرق بسيطة لتعديل وإخراج الأرقام والقيم والسلاسل والمتغيرات والكائنات من صفحات الويب، حيث يتم وضعها داخل علامة( {{}})، والهدف الأساسي من استخدامها هو تعديل بيانات المتغيرات قبل استخدامها، وفيما يلي أهم المرشحات التي تُستخدم في لغة القوالب (Liquid):
| Filter | الاستخدام |
يُستخدم هذا المرشّح لإعادة قيمة العدد المطلقة وفيما يلي مثال عليها: {{ -17 | abs }} // ستكون النتيجة 17 | |
append | يستخدم هذا المرشح لإضافة سلسلة نصية محدَّدة إلى نهاية سلسلة نصية أخرى. |
at_least | يستخدم هذا المرشح في تحديد قيمة عدد معين بالقيمة الدنيا، وفيما يلي مثال عليه: {{ 4 | at_least: 5 }} // ستكون النتيجة 5 |
at_most | يستخدم هذا المرشح في تحديد قيمة عدد معين بالقيمة العليا، وفيما يلي مثال عليه: {{ 4 | at_most: 3 }} ستكون النتيجة 3 |
capitalize | يستخدم هذا المرشح لجعل الحرف الأول من سلسلة نصية باللغة الإنجليزية حرفاً كبيراً ويحول الأحرف المتبقية إلى أحرف صغيرة، وفيما يلي مثال عليه: {{ "title" | capitalize } ستكون النتيجة "Title" |
يُستخدم هذا المرشّح لتقريب العدد إلى أقرب وأكبر عدد صحيح، وفيما يلي مثال عليه: {{ 183.357 | ceil }} ستكون النتيجة 184 | |
compact | يقوم هذا المرشّح بإزالة أي قيم (nil) من المصفوفة. |
concat | يقوم هذا المرشّح بدمج مصفوفات متعددة معاً، بحيث تحتوي المصفوفة الناتجة على جميع العناصر من المصفوفات المختلفة. |
date | يقوم هذا المرشّح بتحويل علامة زمنية معينة إلى تنسيق تاريخ (date) آخر. |
divided_ by | يقوم هذا المرشح بقسمة عدد على عددٍ آخر. |
downcase | يقوم هذا المرشّح بجعل كل حرف في سلسلة نصية بحالة الأحرف الصغيرة، بحيث يكون ليس له تأثير على السلاسل النصية التي تتكون من أحرف صغيرة مسبقًا. |
first | يقوم هذا المرشح بإرجاع العنصر الأول من مصفوفة. |
floor | يقوم هذا المرشّح بتقريب الأعداد إلى أقرب وأصغر عدد صحيح. |
join | يقوم هذا المرشّح بدمج العناصر الموجودة في مصفوفة ضمن سلسلة نصية. |
| last | يستخدم هذا المرشح لإرجاع العنصر الأخير من مصفوفة. |
map | يقوم هذا المرشّح بإنشاء مصفوفة من القيم عن طريق استخراج قيم خاصية مسماة من كائن آخر. |
| minus | يقوم هذا المرشح بطرح عدد من عدد آخر. |
modulo | يستخدم هذا المرشح لإرجاع الباقي من عملية قسمة. |
| prepend | يستخدم هذا المرشّح لإضافة سلسلة نصية محدَّدة إلى بداية سلسلة نصية أخرى. |
reverse | يقوم هذا المرشح بعكس ترتيب العناصر في مصفوفة، ولكن لا يمكنه عكس سلسلة نصية. |
| where | يقوم هذا المرشّح بإنشاء مصفوفة تتضمن فقط الكائنات التي تملك قيمة خاصية معينة. |
upcase | يجعل هذا المرشّح كل حرف في السلسلة النصية حرفاً كبيراً، وليس له أي تأثير على السلاسل النصية التي تتكوّن كلها من أحرف كبيرة. |
| uniq | يقوم هذا المرشح بإزالة العناصر المكرَّرة في المصفوفة. |
strip_ html | يقوم هذا المرشح بإزالة وسوم لغة (HTML) من سلسلة نصية. |
split | يقوم هذا المرشّح بفصل سلسلة نصية إلى مصفوفة باستخدام وسيطه كفاصل بين العناصر، حيث يُستخدَم المرشّح (split) لتحويل العناصر المفصول بينها بفواصل من سلسلة نصية إلى مصفوفة. |
| sort_ natural | يقوم هذا المرشح بترتيب العناصر في مصفوفة بترتيب غير حساس لحالة الأحرف. |
sort | يقوم هذا المرشّح بترتيب عناصر المصفوفة بترتيب حسّاس لحالة الأحرف. |
size | يقوم هذا المرشّح بإرجاع عدد الحروف في سلسلة نصية أو عدد العناصر في مصفوفة. |
strip | يقوم هذا المرشّح بإزالة كل المسافات سواء كانت مسافات (tabs) والمسافات الفارغة والأسطر الجديدة من جانبي السلسلة النصية الأيسر والأيمن، بحيث لا يؤثر على المسافات بين الكلمات. |
| strip_ newlines | يقوم هذا المرشح بإزالة حروف الأسطر الجديدة أي فواصل الأسطر من سلسلة نصية. |
truncatewords | يقوم هذا المرشّح بتقصير طول السلسلة النصية وصولاً إلى عدد الكلمات الممرَّرة كوسيط أو (Parameter). |
| times | يقوم هذا المرشح بضرب عدد بعدد آخر. |
slice | يستخدم هذا المرشّح لإعادة سلسلة نصية فرعية مؤلفة من حرف واحد، أو يعيد سلسلة من عناصر المصفوفة التي تبدأ بالفهرس المحدَّد باستخدام ال (Parameter) الأول. |
rstrip | يستخدم هذا المرشح لإزالة كل المسافات سواء كانت مسافات (tab) والمسافات الفارغة والأسطر الجديدة من جانب السلسلة الأيمن، ولا يؤثر على المسافات بين الكلمات. |
lstrip | يستخدم هذا المرشّح لإزالة كل المسافات سواء كانت مسافات (tab) والمسافات الفارغة والأسطر الجديدة من جانب السلسلة النصية الأيسر، ولا يؤثر على المسافات بين الكلمات. |
