الفرق بين المراجعتين لصفحة: «Twig/filters»
جميل-بيلوني (نقاش | مساهمات) لا ملخص تعديل |
جميل-بيلوني (نقاش | مساهمات) طلا ملخص تعديل |
||
| (1 مراجعات متوسطة بواسطة نفس المستخدم غير معروضة) | |||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE: المرشحات في Twig}}</noinclude> | <noinclude>{{DISPLAYTITLE: المرشحات في Twig}}</noinclude> | ||
تسمح المرشحات | تسمح المرشحات filters بتعديل بيانات متغير قبل استخدامه، وأشهر استخدام لها هو عند إخراج المحتوى، كما تستطيع استعمالها عند إسناد قيمة المتغير إلى متغير آخر. وفيما يلي المرشحات التي في محرك القوالب Twig. | ||
== [[ Twig/abs|abs]] == | == [[ Twig/abs|abs]] == | ||
يعيد | يعيد قيمة مطلقة. | ||
== [[ Twig/batch|batch]] == | == [[ Twig/batch|batch]] == | ||
يرقع | يرقع العناصر من خلال إعادة قائمة من قوائم عددها هو عدد العناصر، ويمكن استخدام معامِل ثاني لملء العناصر المفقودة | ||
== [[ Twig/capitalize|capitalize]] == | == [[ Twig/capitalize|capitalize]] == | ||
يغير حالة أول حرف من القيمة لتكون من الحالة الكبيرة، أما بقية الأحرف فتظل من الحالة الصغرى. | |||
== [[ Twig/column|column]] == | == [[ Twig/column|column]] == | ||
يعيد قيمًا من عمود واحد في مصفوفة الدخل. | |||
== [[ Twig/convert_encoding|convert_encoding]] == | == [[ Twig/convert_encoding|convert_encoding]] == | ||
يحول | يحول السلاسل النصية من ترميز لآخر. | ||
== [[ Twig/country_name|country_name]] == | == [[ Twig/country_name|country_name]] == | ||
يعيد اسم الدولة إذا أعطي الرمز القياسي ISO-3166 المكون من حرفين. | |||
== [[ Twig/currency_name|currency_name]] == | == [[ Twig/currency_name|currency_name]] == | ||
يعيد اسم العملة إذا أُعطي رمزها المكون من ثلاثة أحرف. | |||
== [[ Twig/currency_symbol|currency_symbol]] == | == [[ Twig/currency_symbol|currency_symbol]] == | ||
يعيد رمز العملة المعطاة إذا أعطي الرمز القياسي لها والمكون من ثلاثة أحرف. | |||
== [[ Twig/data_uri|data_uri]] == | == [[ Twig/data_uri|data_uri]] == | ||
يولد | يولد رابطًا تشعبيًا URL باستخدام نظام البيانات المعرَّف في RFC 2397. | ||
== [[ Twig/date|date]] == | == [[ Twig/date|date]] == | ||
يغير | يغير صياغة التاريخ إلى الصيغة المعطاة. | ||
== [[ Twig/date_modify|date_modify]] == | == [[ Twig/date_modify|date_modify]] == | ||
يغير التاريخ وفقًا لسلسلة نصية معطاة. | |||
== [[ Twig/default|default]] == | == [[ Twig/default|default]] == | ||
يعيد | يعيد القيمة الافتراضية الممررة إليه إذا كانت غير معرفة أو فارغة، وإلا فإنه يعيد قيمة المتغير. | ||
== [[ Twig/escape|escape]] == | == [[ Twig/escape|escape]] == | ||
يهرِّب | يهرِّب سلسلة نصية باستخدام خطط تعتمد على السياق. | ||
== [[ Twig/filter|filter]] == | == [[ Twig/filter|filter]] == | ||
يرشح العناصر من تسلسل أو ربط mapping باستخدام دالة سهمية تستقبل القيمة من ذلك التسلسل أو الربط. | |||
== [[ Twig/first|first]] == | == [[ Twig/first|first]] == | ||
يعيد | يعيد أول عنصر في تسلسل أو ربط mapping أو سلسلة نصية. | ||
== [[ Twig/format|format]] == | == [[ Twig/format|format]] == | ||
يهيئ | يهيئ السلسلة النصية باستبدال العناصر النائبة placeholders التي تتبع ترميز [[PHP/sprintf|sprintf]]. | ||
== [[ Twig/format_currency|format_currency]] == | == [[ Twig/format_currency|format_currency]] == | ||
يهيئ | يهيئ العدد ليكون على صيغة العملة. | ||
== [[ Twig/format_date|format_date]] == | == [[ Twig/format_date|format_date]] == | ||
يهيئ صيغة التاريخ وفق المطلوب. | |||
== [[ Twig/format_datetime|format_datetime]] == | == [[ Twig/format_datetime|format_datetime]] == | ||
يغير تنسيق الوقت والتاريخ. | |||
== [[ Twig/format_number|format_number]] == | == [[ Twig/format_number|format_number]] == | ||
يغير تنسيق الصيغ العددية. | |||
== [[ Twig/format_time|format_time]] == | == [[ Twig/format_time|format_time]] == | ||
يغير تنسيق الوقت، ويتصرف بنفس أسلوب المرشح [[Twig/format datetime|<code>format_datetime</code>]] لكن من غير الجزء الخاص بالتاريخ. | |||
== [[ Twig/html_to_markdown|html_to_markdown]] == | == [[ Twig/html_to_markdown|html_to_markdown]] == | ||
يحول | يحول كتلة مكتوبة بلغة HTML لتكون مكتوبة بترميز مارك داون. | ||
== [[ Twig/inline_css|inline_css]] == | == [[ Twig/inline_css|inline_css]] == | ||
يضع أنماط [[CSS]] في مستندات [[HTML]] | |||
== [[ Twig/inky_to_html|inky_to_html]] == | == [[ Twig/inky_to_html|inky_to_html]] == | ||
يعالج [https://github.com/zurb/inky قالب بريد inky]. | |||
== [[ Twig/join|join]] == | == [[ Twig/join|join]] == | ||
يعيد سلسلة نصية تكون نتيجة ضم لعدة عناصر في تسلسل واحد. | |||
== [[ Twig/json_encode|json_encode]] == | == [[ Twig/json_encode|json_encode]] == | ||
يعيد تمثيل JSON للقيمة. | |||
== [[ Twig/keys|keys]] == | == [[ Twig/keys|keys]] == | ||
يعيد مفاتيح المصفوفة، وهو مفيد عند الحاجة إلى التكرار على مفاتيح مصفوفة ما. | |||
== [[ Twig/language_name|language_name]] == | == [[ Twig/language_name|language_name]] == | ||
يعيد اسم اللغة إذا أُعطي رمزها المكون من حرفين. | |||
== [[ Twig/last|last]] == | == [[ Twig/last|last]] == | ||
يعيد العنصر الأخير في تسلسل أو ربط mapping أو سلسلة نصية. | |||
== [[ Twig/length|length]] == | == [[ Twig/length|length]] == | ||
يعيد عدد العناصر التي في تسلسل ما أو ربط mapping، أو يعيد طول سلسلة نصية. | |||
== [[ Twig/locale_name|locale_name]] == | == [[ Twig/locale_name|locale_name]] == | ||
يعيد اسم إعدادات المحلية إذا أُعطي رمزها المكون من حرفين. | |||
== [[ Twig/lower|lower]] == | == [[ Twig/lower|lower]] == | ||
يحول القيمة التي تكون حروفها الإنجليزية من الحالة الكبرى إلى الحالة الصغرى. | |||
== [[ Twig/map|map]] == | == [[ Twig/map|map]] == | ||
يطبق دالة سهمية على كل عنصر من عناصر تسلسل أو ربط mapping، وتستلم الدالة السهمية قيمة ذلك التسلسل أو الربط. | |||
== [[ Twig/markdown_to_html|markdown_to_html]] == | == [[ Twig/markdown_to_html|markdown_to_html]] == | ||
يحول | يحول كتلة مكتوبة بترميز مارك داون لتكون مكتوبة بلغة HTML. | ||
== [[ Twig/merge|merge]] == | == [[ Twig/merge|merge]] == | ||
يدمج مصفوفتين معًا، وتضاف القيم الجديدة في نهاية السرد. | |||
== [[ Twig/nl2br|nl2br]] == | == [[ Twig/nl2br|nl2br]] == | ||
يبدل علامات الأسطر الجديدة في سلسلة نصية ما إلى فواصل أسطر HTML. | |||
== [[ Twig/number_format|number_format]] == | == [[ Twig/number_format|number_format]] == | ||
يعدل تنسيق الأعداد. | |||
== [[ Twig/raw|raw]] == | == [[ Twig/raw|raw]] == | ||
يعلِّم القيمة على أنَّها آمنة "safe". | |||
== [[ Twig/reduce|reduce]] == | == [[ Twig/reduce|reduce]] == | ||
يقلل التسلسل أو الربط mapping إلى قيمة واحدة باستخدام دالة سهمية. | |||
== [[ Twig/replace|replace]] == | == [[ Twig/replace|replace]] == | ||
يهيئ سلسلة نصية ما من خلال استبدال العناصر النائبة placeholders التي تأتي في أي صورة هنا. | |||
== [[ Twig/reverse|reverse]] == | == [[ Twig/reverse|reverse]] == | ||
يعكس تسلسلًا أو ربطًا mapping أو سلسلة نصية. | |||
== [[ Twig/round|round]] == | == [[ Twig/round|round]] == | ||
يقرِّب العدد إلى درجة تقريب معطاة. | |||
== [[ Twig/slice|slice]] == | == [[ Twig/slice|slice]] == | ||
يستخرج شريحة صغيرة من التسلسل أو الربط mapping أو السلسلة النصية. | |||
== [[ Twig/slug|slug]] == | == [[ Twig/slug|slug]] == | ||
يحول السلسلة النصية إلى سلسلة أخرى لا تحتوي إلا على محارف آسكي ASCII آمنة. | |||
== [[ Twig/sort|sort]] == | == [[ Twig/sort|sort]] == | ||
يرتب عناصر مصفوفة. | |||
== [[ Twig/spaceless|spaceless]] == | == [[ Twig/spaceless|spaceless]] == | ||
يُستخدم | يُستخدم لإزالة المسافات الفارغة بين وسوم HTML، ولا يُستخدم لإزالة المسافات داخل الوسوم أو في النصوص العادية. | ||
== [[ Twig/split|split]] == | == [[ Twig/split|split]] == | ||
يقسم سلسلة نصية بمحدِّد معطاة ويعيد قائمة من السلاسل النصية. | |||
== [[ Twig/striptags|striptags]] == | == [[ Twig/striptags|striptags]] == | ||
يجرد وسوم SGML/XML ويستبدل المسافات المتجاورة واحدة واحدة. | |||
== [[ Twig/timezone_name|timezone_name]] == | == [[ Twig/timezone_name|timezone_name]] == | ||
يعيد اسم المنطقة الزمنية إذا أُعطي معرِّف منطقة زمنية. | |||
== [[ Twig/title|title]] == | == [[ Twig/title|title]] == | ||
يعيد نسخة من القيمة بالحالة المعنونة للأحرف الإنجليزية، أي ستبدأ الكلمات بأحرف كبيرة، أما بقية كل كلمة فستظل بالحالة الصغرى. | |||
== [[ Twig/trim|trim]] == | == [[ Twig/trim|trim]] == | ||
يزيل المسافات الفارغة أو غيرها من المحارف من بداية السلسلة النصية ونهايتها. | |||
== [[ Twig/u|u]] == | == [[ Twig/u|u]] == | ||
يغلف نصًا بكائن يونيكود -[https://symfony.com/doc/current/components/string.html نسخة من UnicodeString من Symfony]- يكشف توابع التعديل على السلسلة النصية. | |||
== [[ Twig/upper|upper]] == | == [[ Twig/upper|upper]] == | ||
يحول حالة أحرف القيمة إلى الحالة الكبرى لأحرف الإنجليزية. | |||
== [[ Twig/url_encode|url_encode]] == | == [[ Twig/url_encode|url_encode]] == | ||
يرمّز سلسلة نصية كجزء من رابط تشعبي URL أو يرمّز مصفوفة كسلسلة استعلام query string. | |||
[[تصنيف:Twig]] | [[تصنيف:Twig]] | ||
[[تصنيف:Twig Filters]] | [[تصنيف:Twig Filters]] | ||
المراجعة الحالية بتاريخ 15:15، 11 مايو 2021
تسمح المرشحات 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.