الفرق بين المراجعتين ل"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 يعيد اسم اللغة إذا أُعطي رمزها المكون من حرفين.