الفرق بين المراجعتين لصفحة: «Twig/filters»
جميل-بيلوني (نقاش | مساهمات) لا ملخص تعديل |
جميل-بيلوني (نقاش | مساهمات) طلا ملخص تعديل |
||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE: المرشحات في Twig}}</noinclude> | <noinclude>{{DISPLAYTITLE: المرشحات في Twig}}</noinclude> | ||
تسمح المرشحات | تسمح المرشحات filters بتعديل بيانات متغير قبل استخدامه، وأشهر استخدام لها هو عند إخراج المحتوى، كما تستطيع استعمالها عند إسناد قيمة المتغير إلى متغير آخر. وفيما يلي المرشحات التي في محرك القوالب Twig. | ||
== [[ Twig/abs|abs]] == | == [[ Twig/abs|abs]] == | ||
| سطر 27: | سطر 27: | ||
== [[ Twig/data_uri|data_uri]] == | == [[ Twig/data_uri|data_uri]] == | ||
يولد المرشح <code>data_uri</code> رابطًا تشعبيًا | يولد المرشح <code>data_uri</code> رابطًا تشعبيًا URL باستخدام نظام البيانات المعرَّف في RFC 2397. | ||
== [[ Twig/date|date]] == | == [[ Twig/date|date]] == | ||
| سطر 42: | سطر 42: | ||
== [[ Twig/filter|filter]] == | == [[ Twig/filter|filter]] == | ||
المرشح <code>filter</code> يرشح العناصر من تسلسل أو ربط | المرشح <code>filter</code> يرشح العناصر من تسلسل أو ربط mapping باستخدام دالة سهمية تستقبل القيمة من ذلك التسلسل أو الربط. | ||
== [[ Twig/first|first]] == | == [[ Twig/first|first]] == | ||
يعيد المرشح <code>first</code> أول عنصر في تسلسل أو ربط | يعيد المرشح <code>first</code> أول عنصر في تسلسل أو ربط mapping أو سلسلة نصية. | ||
== [[ Twig/format|format]] == | == [[ Twig/format|format]] == | ||
يهيئ المرشح <code>format</code> السلسلة النصية باستبدال العناصر النائبة | يهيئ المرشح <code>format</code> السلسلة النصية باستبدال العناصر النائبة placeholders التي تتبع ترميز [https://secure.php.net/sprintf sprintf]. | ||
== [[ Twig/format_currency|format_currency]] == | == [[ Twig/format_currency|format_currency]] == | ||
| سطر 87: | سطر 87: | ||
== [[ Twig/last|last]] == | == [[ Twig/last|last]] == | ||
المرشح <code>last</code> يعيد العنصر الأخير في تسلسل أو ربط | المرشح <code>last</code> يعيد العنصر الأخير في تسلسل أو ربط mapping أو سلسلة نصية. | ||
== [[ Twig/length|length]] == | == [[ Twig/length|length]] == | ||
المرشح <code>length</code> يعيد عدد العناصر التي في تسلسل ما أو ربط | المرشح <code>length</code> يعيد عدد العناصر التي في تسلسل ما أو ربط mapping، أو يعيد طول سلسلة نصية. | ||
== [[ Twig/locale_name|locale_name]] == | == [[ Twig/locale_name|locale_name]] == | ||
| سطر 99: | سطر 99: | ||
== [[ Twig/map|map]] == | == [[ Twig/map|map]] == | ||
المرشح <code>map</code> يطبق دالة سهمية على كل عنصر من عناصر تسلسل أو ربط | المرشح <code>map</code> يطبق دالة سهمية على كل عنصر من عناصر تسلسل أو ربط mapping، وتستلم الدالة السهمية قيمة ذلك التسلسل أو الربط. | ||
== [[ Twig/markdown_to_html|markdown_to_html]] == | == [[ Twig/markdown_to_html|markdown_to_html]] == | ||
| سطر 117: | سطر 117: | ||
== [[ Twig/reduce|reduce]] == | == [[ Twig/reduce|reduce]] == | ||
المرشح <code>reduce</code> يقلل التسلسل أو الربط | المرشح <code>reduce</code> يقلل التسلسل أو الربط mapping إلى قيمة واحدة باستخدام دالة سهمية. | ||
== [[ Twig/replace|replace]] == | == [[ Twig/replace|replace]] == | ||
المرشح <code>replace</code> يهيئ سلسلة نصية ما من خلال استبدال العناصر النائبة | المرشح <code>replace</code> يهيئ سلسلة نصية ما من خلال استبدال العناصر النائبة placeholders التي تأتي في أي صورة هنا. | ||
== [[ Twig/reverse|reverse]] == | == [[ Twig/reverse|reverse]] == | ||
المرشح <code>reverse</code> يعكس تسلسلًا أو ربطًا | المرشح <code>reverse</code> يعكس تسلسلًا أو ربطًا mapping أو سلسلة نصية. | ||
== [[ Twig/round|round]] == | == [[ Twig/round|round]] == | ||
| سطر 129: | سطر 129: | ||
== [[ Twig/slice|slice]] == | == [[ Twig/slice|slice]] == | ||
المرشح <code>slice</code> يستخرج شريحة صغيرة من التسلسل أو الربط | المرشح <code>slice</code> يستخرج شريحة صغيرة من التسلسل أو الربط mapping أو السلسلة النصية. | ||
== [[ Twig/slug|slug]] == | == [[ Twig/slug|slug]] == | ||
المرشح <code>slug</code> يحول السلسلة النصية إلى سلسلة أخرى لا تحتوي إلا على محارف آسكي | المرشح <code>slug</code> يحول السلسلة النصية إلى سلسلة أخرى لا تحتوي إلا على محارف آسكي ASCII آمنة. | ||
== [[ Twig/sort|sort]] == | == [[ Twig/sort|sort]] == | ||
| سطر 162: | سطر 162: | ||
== [[ Twig/url_encode|url_encode]] == | == [[ Twig/url_encode|url_encode]] == | ||
المرشح <code>url_encode</code> يرمّز سلسلة نصية كجزء من رابط تشعبي | المرشح <code>url_encode</code> يرمّز سلسلة نصية كجزء من رابط تشعبي URL أو يرمّز مصفوفة كسلسلة استعلام query string. | ||
[[تصنيف:Twig]] | [[تصنيف:Twig]] | ||
[[تصنيف:Twig Filters]] | [[تصنيف:Twig Filters]] | ||
مراجعة 06:20، 11 مايو 2021
تسمح المرشحات 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
المرشح last يعيد العنصر الأخير في تسلسل أو ربط mapping أو سلسلة نصية.
length
المرشح length يعيد عدد العناصر التي في تسلسل ما أو ربط mapping، أو يعيد طول سلسلة نصية.
locale_name
المرشح locale_name يعيد اسم إعدادات المحلية إذا أُعطي رمزها المكون من حرفين.
lower
المرشح lower يحول القيمة التي تكون حروفها الإنجليزية من الحالة الكبرى إلى الحالة الصغرى.
map
المرشح map يطبق دالة سهمية على كل عنصر من عناصر تسلسل أو ربط mapping، وتستلم الدالة السهمية قيمة ذلك التسلسل أو الربط.
markdown_to_html
يحول المرشح markdown_to_html كتلة مكتوبة بترميز مارك داون لتكون مكتوبة بلغة HTML.
merge
المرشح merge يدمج مصفوفتين معًا، وتضاف القيم الجديدة في نهاية السرد.
nl2br
المرشح nl2br يبدل علامات الأسطر الجديدة في سلسلة نصية ما إلى فواصل أسطر HTML.
number_format
المرشح number_format يعدل تنسيق الأعداد.
raw
المرشح raw يعلِّم القيمة على أنَّها آمنة "safe".
reduce
المرشح reduce يقلل التسلسل أو الربط mapping إلى قيمة واحدة باستخدام دالة سهمية.
replace
المرشح replace يهيئ سلسلة نصية ما من خلال استبدال العناصر النائبة placeholders التي تأتي في أي صورة هنا.
reverse
المرشح reverse يعكس تسلسلًا أو ربطًا mapping أو سلسلة نصية.
round
المرشح round يقرِّب العدد إلى درجة تقريب معطاة.
slice
المرشح slice يستخرج شريحة صغيرة من التسلسل أو الربط mapping أو السلسلة النصية.
slug
المرشح slug يحول السلسلة النصية إلى سلسلة أخرى لا تحتوي إلا على محارف آسكي ASCII آمنة.
sort
المرشح sort يرتب عناصر مصفوفة.
spaceless
يُستخدم المرشح spaceless لإزالة المسافات الفارغة بين وسوم HTML، ولا يُستخدم لإزالة المسافات داخل الوسوم أو في النصوص العادية.
split
المرشح split يقسم سلسلة نصية بمحدِّد معطاة ويعيد قائمة من السلاسل النصية.
striptags
المرشح striptags يجرد وسوم SGML/XML ويستبدل المسافات المتجاورة واحدة واحدة.
timezone_name
المرشح timezone_name يعيد اسم المنطقة الزمنية إذا أُعطي معرِّف منطقة زمنية.
title
المرشح title يعيد نسخة من القيمة بالحالة المعنونة للأحرف الإنجليزية، أي ستبدأ الكلمات بأحرف كبيرة، أما بقية كل كلمة فستظل بالحالة الصغرى.
trim
المرشح trim يزيل المسافات الفارغة أو غيرها من المحارف من بداية السلسلة النصية ونهايتها.
u
المرشح u يغلف نصًا بكائن يونيكود -نسخة من UnicodeString من Symfony- يكشف توابع التعديل على السلسلة النصية.
upper
المرشح upper يحول حالة أحرف القيمة إلى الحالة الكبرى لأحرف الإنجليزية.
url_encode
المرشح url_encode يرمّز سلسلة نصية كجزء من رابط تشعبي URL أو يرمّز مصفوفة كسلسلة استعلام query string.