المرشحات في Twig
تسمح المرشحات filters بتعديل بيانات متغير قبل استخدامه، وأشهر استخدام لها هو عند إخراج المحتوى، كما تستطيع استعمالها عند إسناد قيمة المتغير إلى متغير آخر. وفيما يلي المرشحات التي في محرك القوالب Twig.
abs
يعيد قيمة مطلقة.
batch
يرقع العناصر من خلال إعادة قائمة من قوائم عددها هو عدد العناصر، ويمكن استخدام معامِل ثاني لملء العناصر المفقودة
capitalize
يغير حالة أول حرف من القيمة لتكون من الحالة الكبيرة، أما بقية الأحرف فتظل من الحالة الصغرى.
column
يعيد قيمًا من عمود واحد في مصفوفة الدخل.
convert_encoding
يحول السلاسل النصية من ترميز لآخر.
country_name
يعيد اسم الدولة إذا أعطي الرمز القياسي ISO-3166 المكون من حرفين.
currency_name
يعيد اسم العملة إذا أُعطي رمزها المكون من ثلاثة أحرف.
currency_symbol
يعيد رمز العملة المعطاة إذا أعطي الرمز القياسي لها والمكون من ثلاثة أحرف.
data_uri
يولد رابطًا تشعبيًا URL باستخدام نظام البيانات المعرَّف في RFC 2397.
date
يغير صياغة التاريخ إلى الصيغة المعطاة.
date_modify
يغير التاريخ وفقًا لسلسلة نصية معطاة.
default
يعيد القيمة الافتراضية الممررة إليه إذا كانت غير معرفة أو فارغة، وإلا فإنه يعيد قيمة المتغير.
escape
يهرِّب سلسلة نصية باستخدام خطط تعتمد على السياق.
filter
يرشح العناصر من تسلسل أو ربط mapping باستخدام دالة سهمية تستقبل القيمة من ذلك التسلسل أو الربط.
first
يعيد أول عنصر في تسلسل أو ربط mapping أو سلسلة نصية.
format
يهيئ السلسلة النصية باستبدال العناصر النائبة placeholders التي تتبع ترميز sprintf.
format_currency
يهيئ العدد ليكون على صيغة العملة.
format_date
يهيئ صيغة التاريخ وفق المطلوب.
format_datetime
يغير تنسيق الوقت والتاريخ.
format_number
يغير تنسيق الصيغ العددية.
format_time
يغير تنسيق الوقت، ويتصرف بنفس أسلوب المرشح format_datetime لكن من غير الجزء الخاص بالتاريخ.
html_to_markdown
يحول كتلة مكتوبة بلغة HTML لتكون مكتوبة بترميز مارك داون.
inline_css
inky_to_html
يعالج قالب بريد inky.
join
يعيد سلسلة نصية تكون نتيجة ضم لعدة عناصر في تسلسل واحد.
json_encode
يعيد تمثيل JSON للقيمة.
keys
يعيد مفاتيح المصفوفة، وهو مفيد عند الحاجة إلى التكرار على مفاتيح مصفوفة ما.
language_name
يعيد اسم اللغة إذا أُعطي رمزها المكون من حرفين.
last
يعيد العنصر الأخير في تسلسل أو ربط mapping أو سلسلة نصية.
length
يعيد عدد العناصر التي في تسلسل ما أو ربط mapping، أو يعيد طول سلسلة نصية.
locale_name
يعيد اسم إعدادات المحلية إذا أُعطي رمزها المكون من حرفين.
lower
يحول القيمة التي تكون حروفها الإنجليزية من الحالة الكبرى إلى الحالة الصغرى.
map
يطبق دالة سهمية على كل عنصر من عناصر تسلسل أو ربط mapping، وتستلم الدالة السهمية قيمة ذلك التسلسل أو الربط.
markdown_to_html
يحول كتلة مكتوبة بترميز مارك داون لتكون مكتوبة بلغة HTML.
merge
يدمج مصفوفتين معًا، وتضاف القيم الجديدة في نهاية السرد.
nl2br
يبدل علامات الأسطر الجديدة في سلسلة نصية ما إلى فواصل أسطر HTML.
number_format
يعدل تنسيق الأعداد.
raw
يعلِّم القيمة على أنَّها آمنة "safe".
reduce
يقلل التسلسل أو الربط mapping إلى قيمة واحدة باستخدام دالة سهمية.
replace
يهيئ سلسلة نصية ما من خلال استبدال العناصر النائبة placeholders التي تأتي في أي صورة هنا.
reverse
يعكس تسلسلًا أو ربطًا mapping أو سلسلة نصية.
round
يقرِّب العدد إلى درجة تقريب معطاة.
slice
يستخرج شريحة صغيرة من التسلسل أو الربط mapping أو السلسلة النصية.
slug
يحول السلسلة النصية إلى سلسلة أخرى لا تحتوي إلا على محارف آسكي ASCII آمنة.
sort
يرتب عناصر مصفوفة.
spaceless
يُستخدم لإزالة المسافات الفارغة بين وسوم HTML، ولا يُستخدم لإزالة المسافات داخل الوسوم أو في النصوص العادية.
split
يقسم سلسلة نصية بمحدِّد معطاة ويعيد قائمة من السلاسل النصية.
striptags
يجرد وسوم SGML/XML ويستبدل المسافات المتجاورة واحدة واحدة.
timezone_name
يعيد اسم المنطقة الزمنية إذا أُعطي معرِّف منطقة زمنية.
title
يعيد نسخة من القيمة بالحالة المعنونة للأحرف الإنجليزية، أي ستبدأ الكلمات بأحرف كبيرة، أما بقية كل كلمة فستظل بالحالة الصغرى.
trim
يزيل المسافات الفارغة أو غيرها من المحارف من بداية السلسلة النصية ونهايتها.
u
يغلف نصًا بكائن يونيكود -نسخة من UnicodeString من Symfony- يكشف توابع التعديل على السلسلة النصية.
upper
يحول حالة أحرف القيمة إلى الحالة الكبرى لأحرف الإنجليزية.
url_encode
يرمّز سلسلة نصية كجزء من رابط تشعبي URL أو يرمّز مصفوفة كسلسلة استعلام query string.