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