المرشحات في Twig

من موسوعة حسوب

تسمح المرشحات (filters) بتعديل بيانات المتغير قبل استخدامه، وأشهر استخدام لها هو عند إخراج المحتوى، كما تستطيع استعمالها عند إسناد قيمة المتغير إلى متغير آخر. وفيما يلي المرشحات التي في محرك القوالب Twig:

abs

يعيد المرشح abs قيمة مطلقة.

batch

يرقع المرشح batch العناصر من خلال إعادة قائمة من قوائم عددها هو عدد العناصر، ويمكن استخدام معامِل ثاني لملء العناصر المفقودة

capitalize

المرشح capitalizes يغير حالة أول حرف من القيمة لتكون من الحالة الكبيرة، أما بقية الأحرف فتظل من الحالة الصغرى.

column

المرشح column يعيد قيمًا من عمود واحد في مصفوفة الدخل.

convert_encoding

يحول المرشح convert_encoding السلاسل النصية من ترميز لآخر.

country_name

المرشح country_name يعيد اسم الدولة إذا أعطي الرمز القياسي ISO-3166 المكون من حرفين.

currency_name

المرشح currency_name يعيد اسم العملة إذا أُعطي رمزها المكون من ثلاثة أحرف.

currency_symbol

المرشح currency_symbol يعيد رمز العملة المعطاة إذا أعطي الرمز القياسي لها والمكون من ثلاثة أحرف.

data_uri

يولد المرشح data_uri رابطًا تشعبيًا (URL) باستخدام نظام البيانات المعرَّف في RFC 2397.

date

يغير المرشح date صياغة التاريخ إلى الصيغة المعطاة.

date_modify

المرشح date_modify يغير التاريخ وفقًا لسلسلة نصية معطاة.

default

يعيد المرشح default القيمة الافتراضية الممررة إليه إذا كانت غير معرفة أو فارغة، وإلا فإنه يعيد قيمة المتغير.

escape

يهرِّب المرشح escape سلسلة نصية باستخدام خطط تعتمد على السياق.

filter

المرشح filter يرشح العناصر من تسلسل أو ربط (mapping) باستخدام دالة سهمية تستقبل القيمة من ذلك التسلسل أو الربط.

first

يعيد المرشح first أول عنصر في تسلسل أو ربط (mapping) أو سلسلة نصية.

format

يهيئ المرشح format السلسلة النصية باستبدال العناصر النائبة (placeholders) التي تتبع ترميز sprintf.

format_currency

يهيئ المرشح format_currency العدد ليكون على صيغة العملة.

format_date

المرشح format_date يهيئ صيغة التاريخ وفق المطلوب.

format_datetime

المرشح format_datetime يغير تنسيق الوقت والتاريخ.

format_number

المرشح format_number يغير تنسيق الصيغ العددية.

format_time

المرشح format_time يغير تنسيق الوقت، ويتصرف بنفس أسلوب المرشح format_datetime لكن من غير الجزء الخاص بالتاريخ.

html_to_markdown

يحول المرشح html_to_markdown كتلة مكتوبة بلغة HTML لتكون مكتوبة بترميز مارك داون.

inline_css

المرشح inline_css يضع أنماط CSS في مستندات HTML

inky_to_html

المرشح inky_to_html يعالج قالب بريد inky.

join

المرشح join يعيد سلسلة نصية تكون نتيجة ضم لعدة عناصر في تسلسل واحد.

json_encode

المرشح json_encode يعيد تمثيل JSON للقيمة.

keys

المرشح keys يعيد مفاتيح المصفوفة، وهو مفيد عند الحاجة إلى التكرار على مفاتيح مصفوفة ما.

language_name

المرشح language_name يعيد اسم اللغة إذا أُعطي رمزها المكون من حرفين.

last

length

locale_name

lower

map

markdown_to_html

merge

nl2br

number_format

raw

reduce

replace

reverse

round

slice

slug

sort

spaceless

split

striptags

timezone_name

title

trim

u

upper

url_encode