الفرق بين المراجعتين ل"Twig/filters"

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
ط
ط
 
(مراجعتان متوسطتان بواسطة نفس المستخدم غير معروضتين)
سطر 1: سطر 1:
 
  <noinclude>{{DISPLAYTITLE: المرشحات في Twig}}</noinclude>
 
  <noinclude>{{DISPLAYTITLE: المرشحات في Twig}}</noinclude>
تسمح المرشحات (filters) بتعديل بيانات المتغير قبل استخدامه، وأشهر استخدام لها هو عند إخراج المحتوى، كما تستطيع استعمالها عند إسناد قيمة المتغير إلى متغير آخر. وفيما يلي المرشحات التي في محرك القوالب Twig:
+
تسمح المرشحات filters بتعديل بيانات متغير قبل استخدامه، وأشهر استخدام لها هو عند إخراج المحتوى، كما تستطيع استعمالها عند إسناد قيمة المتغير إلى متغير آخر. وفيما يلي المرشحات التي في محرك القوالب Twig.
  
 
== [[ Twig/abs|abs]] ==
 
== [[ Twig/abs|abs]] ==
يعيد المرشح <code>abs</code> قيمة مطلقة.
+
يعيد قيمة مطلقة.
  
 
== [[ Twig/batch|batch]] ==
 
== [[ Twig/batch|batch]] ==
يرقع المرشح <code>batch</code> العناصر من خلال إعادة قائمة من قوائم عددها هو عدد العناصر، ويمكن استخدام معامِل ثاني لملء العناصر المفقودة
+
يرقع العناصر من خلال إعادة قائمة من قوائم عددها هو عدد العناصر، ويمكن استخدام معامِل ثاني لملء العناصر المفقودة
  
 
== [[ Twig/capitalize|capitalize]] ==
 
== [[ Twig/capitalize|capitalize]] ==
المرشح <code>capitalizes</code> يغير حالة أول حرف من القيمة لتكون من الحالة الكبيرة، أما بقية الأحرف فتظل من الحالة الصغرى.
+
يغير حالة أول حرف من القيمة لتكون من الحالة الكبيرة، أما بقية الأحرف فتظل من الحالة الصغرى.
  
 
== [[ Twig/column|column]] ==
 
== [[ Twig/column|column]] ==
المرشح <code>column</code> يعيد قيمًا من عمود واحد في مصفوفة الدخل.
+
يعيد قيمًا من عمود واحد في مصفوفة الدخل.
  
 
== [[ Twig/convert_encoding|convert_encoding]] ==
 
== [[ Twig/convert_encoding|convert_encoding]] ==
يحول المرشح <code>convert_encoding</code> السلاسل النصية من ترميز لآخر.
+
يحول السلاسل النصية من ترميز لآخر.
  
 
== [[ Twig/country_name|country_name]] ==
 
== [[ Twig/country_name|country_name]] ==
المرشح <code>country_name</code> يعيد اسم الدولة إذا أعطي الرمز القياسي ISO-3166 المكون من حرفين.
+
يعيد اسم الدولة إذا أعطي الرمز القياسي ISO-3166 المكون من حرفين.
  
 
== [[ Twig/currency_name|currency_name]] ==
 
== [[ Twig/currency_name|currency_name]] ==
المرشح <code>currency_name</code> يعيد اسم العملة إذا أُعطي رمزها المكون من ثلاثة أحرف.
+
يعيد اسم العملة إذا أُعطي رمزها المكون من ثلاثة أحرف.
  
 
== [[ Twig/currency_symbol|currency_symbol]] ==
 
== [[ Twig/currency_symbol|currency_symbol]] ==
المرشح <code>currency_symbol</code> يعيد رمز العملة المعطاة إذا أعطي الرمز القياسي لها والمكون من ثلاثة أحرف.
+
يعيد رمز العملة المعطاة إذا أعطي الرمز القياسي لها والمكون من ثلاثة أحرف.
  
 
== [[ Twig/data_uri|data_uri]] ==
 
== [[ Twig/data_uri|data_uri]] ==
يولد المرشح <code>data_uri</code> رابطًا تشعبيًا (URL) باستخدام نظام البيانات المعرَّف في RFC 2397.
+
يولد رابطًا تشعبيًا URL باستخدام نظام البيانات المعرَّف في RFC 2397.
  
 
== [[ Twig/date|date]] ==
 
== [[ Twig/date|date]] ==
يغير المرشح <code>date</code> صياغة التاريخ إلى الصيغة المعطاة.
+
يغير صياغة التاريخ إلى الصيغة المعطاة.
  
 
== [[ Twig/date_modify|date_modify]] ==
 
== [[ Twig/date_modify|date_modify]] ==
المرشح <code>date_modify</code> يغير التاريخ وفقًا لسلسلة نصية معطاة.
+
يغير التاريخ وفقًا لسلسلة نصية معطاة.
  
 
== [[ Twig/default|default]] ==
 
== [[ Twig/default|default]] ==
يعيد المرشح <code>default</code> القيمة الافتراضية الممررة إليه إذا كانت غير معرفة أو فارغة، وإلا فإنه يعيد قيمة المتغير.
+
يعيد القيمة الافتراضية الممررة إليه إذا كانت غير معرفة أو فارغة، وإلا فإنه يعيد قيمة المتغير.
  
 
== [[ Twig/escape|escape]] ==
 
== [[ Twig/escape|escape]] ==
يهرِّب المرشح <code>escape</code> سلسلة نصية باستخدام خطط تعتمد على السياق.
+
يهرِّب سلسلة نصية باستخدام خطط تعتمد على السياق.
  
 
== [[ Twig/filter|filter]] ==
 
== [[ Twig/filter|filter]] ==
المرشح <code>filter</code> يرشح العناصر من تسلسل أو ربط (mapping) باستخدام دالة سهمية تستقبل القيمة من ذلك التسلسل أو الربط.
+
يرشح العناصر من تسلسل أو ربط mapping باستخدام دالة سهمية تستقبل القيمة من ذلك التسلسل أو الربط.
  
 
== [[ Twig/first|first]] ==
 
== [[ Twig/first|first]] ==
يعيد المرشح <code>first</code> أول عنصر في تسلسل أو ربط (mapping) أو سلسلة نصية.
+
يعيد أول عنصر في تسلسل أو ربط mapping أو سلسلة نصية.
  
 
== [[ Twig/format|format]] ==
 
== [[ Twig/format|format]] ==
يهيئ المرشح <code>format</code> السلسلة النصية باستبدال العناصر النائبة (placeholders) التي تتبع ترميز [https://secure.php.net/sprintf sprintf].
+
يهيئ السلسلة النصية باستبدال العناصر النائبة placeholders التي تتبع ترميز [[PHP/sprintf|sprintf]].
  
 
== [[ Twig/format_currency|format_currency]] ==
 
== [[ Twig/format_currency|format_currency]] ==
يهيئ المرشح <code>format_currency</code> العدد ليكون على صيغة العملة.
+
يهيئ العدد ليكون على صيغة العملة.
  
 
== [[ Twig/format_date|format_date]] ==
 
== [[ Twig/format_date|format_date]] ==
المرشح <code>format_date</code> يهيئ صيغة التاريخ وفق المطلوب.
+
يهيئ صيغة التاريخ وفق المطلوب.
  
 
== [[ Twig/format_datetime|format_datetime]] ==
 
== [[ Twig/format_datetime|format_datetime]] ==
المرشح <code>format_datetime</code> يغير تنسيق الوقت والتاريخ.
+
يغير تنسيق الوقت والتاريخ.
  
 
== [[ Twig/format_number|format_number]] ==
 
== [[ Twig/format_number|format_number]] ==
المرشح <code>format_number</code> يغير تنسيق الصيغ العددية.
+
يغير تنسيق الصيغ العددية.
  
 
== [[ Twig/format_time|format_time]] ==
 
== [[ Twig/format_time|format_time]] ==
المرشح <code>format_time</code> يغير تنسيق الوقت، ويتصرف بنفس أسلوب المرشح [[Twig/format datetime|<code>format_datetime</code>]] لكن من غير الجزء الخاص بالتاريخ.
+
يغير تنسيق الوقت، ويتصرف بنفس أسلوب المرشح [[Twig/format datetime|<code>format_datetime</code>]] لكن من غير الجزء الخاص بالتاريخ.
  
 
== [[ Twig/html_to_markdown|html_to_markdown]] ==
 
== [[ Twig/html_to_markdown|html_to_markdown]] ==
يحول المرشح <code>html_to_markdown</code> كتلة مكتوبة بلغة HTML لتكون مكتوبة بترميز مارك داون.
+
يحول كتلة مكتوبة بلغة HTML لتكون مكتوبة بترميز مارك داون.
  
 
== [[ Twig/inline_css|inline_css]] ==
 
== [[ Twig/inline_css|inline_css]] ==
المرشح <code>inline_css</code> يضع أنماط [[CSS]] في مستندات [[HTML]]
+
يضع أنماط [[CSS]] في مستندات [[HTML]]
  
 
== [[ Twig/inky_to_html|inky_to_html]] ==
 
== [[ Twig/inky_to_html|inky_to_html]] ==
المرشح <code>inky_to_html</code> يعالج [https://github.com/zurb/inky قالب بريد inky].
+
يعالج [https://github.com/zurb/inky قالب بريد inky].
  
 
== [[ Twig/join|join]] ==
 
== [[ Twig/join|join]] ==
المرشح <code>join</code> يعيد سلسلة نصية تكون نتيجة ضم لعدة عناصر في تسلسل واحد.
+
يعيد سلسلة نصية تكون نتيجة ضم لعدة عناصر في تسلسل واحد.
  
 
== [[ Twig/json_encode|json_encode]] ==
 
== [[ Twig/json_encode|json_encode]] ==
المرشح <code>json_encode</code> يعيد تمثيل JSON للقيمة.
+
يعيد تمثيل JSON للقيمة.
  
 
== [[ Twig/keys|keys]] ==
 
== [[ Twig/keys|keys]] ==
المرشح <code>keys</code> يعيد مفاتيح المصفوفة، وهو مفيد عند الحاجة إلى التكرار على مفاتيح مصفوفة ما.
+
يعيد مفاتيح المصفوفة، وهو مفيد عند الحاجة إلى التكرار على مفاتيح مصفوفة ما.
  
 
== [[ Twig/language_name|language_name]] ==
 
== [[ Twig/language_name|language_name]] ==
المرشح <code>language_name</code> يعيد اسم اللغة إذا أُعطي رمزها المكون من حرفين.
+
يعيد اسم اللغة إذا أُعطي رمزها المكون من حرفين.
  
 
== [[ 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

يضع أنماط CSS في مستندات HTML

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.