الفرق بين المراجعتين ل"Twig/u"
< Twig
اذهب إلى التنقل
اذهب إلى البحث
أسامه-دمراني (نقاش | مساهمات) (1.0: إضافة عنوان الصفحة | 2.0 محتوى الصفحة) |
جميل-بيلوني (نقاش | مساهمات) ط |
||
(3 مراجعات متوسطة بواسطة نفس المستخدم غير معروضة) | |||
سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE: المرشح u في Twig}}</noinclude> | <noinclude>{{DISPLAYTITLE: المرشح u في Twig}}</noinclude> | ||
− | المرشح <code>u</code> يغلف نصًا بكائن يونيكود -نسخة من UnicodeString من Symfony- يكشف | + | المرشح <code>u</code> يغلف نصًا بكائن يونيكود -[https://symfony.com/doc/current/components/string.html نسخة من UnicodeString من Symfony]- يكشف توابع التعديل على السلسلة النصية. وفيما يلي بعض من الاستخدامات الشائعة لهذا المرشح: |
− | تغليف نص لعدد من المحارف:<syntaxhighlight lang="twig"> | + | * تغليف نص لعدد من المحارف: |
+ | <syntaxhighlight lang="twig"> | ||
{{ 'Symfony String + Twig = <3'|u.wordwrap(5) }} | {{ 'Symfony String + Twig = <3'|u.wordwrap(5) }} | ||
Symfony | Symfony | ||
سطر 9: | سطر 10: | ||
Twig | Twig | ||
= <3 | = <3 | ||
− | </syntaxhighlight>تقليم سلسلة نصية، انظر كيف تحل النقاط الثلاث محل آخر ثمانية محارف، وهو العدد الذي حُدد ليُقص من السلسلة النصية:<syntaxhighlight lang="twig"> | + | </syntaxhighlight> |
+ | * تقليم سلسلة نصية، انظر كيف تحل النقاط الثلاث محل آخر ثمانية محارف، وهو العدد الذي حُدد ليُقص من السلسلة النصية: | ||
+ | <syntaxhighlight lang="twig"> | ||
{{ 'Lorem ipsum'|u.truncate(8) }} | {{ 'Lorem ipsum'|u.truncate(8) }} | ||
Lorem ip | Lorem ip | ||
سطر 15: | سطر 18: | ||
{{ 'Lorem ipsum'|u.truncate(8, '...') }} | {{ 'Lorem ipsum'|u.truncate(8, '...') }} | ||
Lorem... | Lorem... | ||
− | </syntaxhighlight>يقبل التابع <code>truncate</code> وسيطًا ثالثًا للحفاظ على كلمات كاملة:<syntaxhighlight lang="twig"> | + | </syntaxhighlight> |
+ | * يقبل التابع <code>truncate</code> وسيطًا ثالثًا للحفاظ على كلمات كاملة: | ||
+ | <syntaxhighlight lang="twig"> | ||
{{ 'Lorem ipsum dolor'|u.truncate(10, '...', false) }} | {{ 'Lorem ipsum dolor'|u.truncate(10, '...', false) }} | ||
Lorem ipsum... | Lorem ipsum... | ||
− | </syntaxhighlight>تحويل السلسلة النصية إلى حالة الثعبان | + | </syntaxhighlight> |
+ | * تحويل السلسلة النصية إلى حالة الثعبان snake case أو حالة الجمل camel case: | ||
+ | <syntaxhighlight lang="twig"> | ||
{{ 'SymfonyStringWithTwig'|u.snake }} | {{ 'SymfonyStringWithTwig'|u.snake }} | ||
symfony_string_with_twig | symfony_string_with_twig | ||
سطر 24: | سطر 31: | ||
{{ 'symfony_string with twig'|u.camel.title }} | {{ 'symfony_string with twig'|u.camel.title }} | ||
SymfonyStringWithTwig | SymfonyStringWithTwig | ||
− | </syntaxhighlight>كذلك يمكن سَلسَلة التوابع:<syntaxhighlight lang="twig"> | + | </syntaxhighlight> |
+ | * كذلك يمكن سَلسَلة التوابع: | ||
+ | <syntaxhighlight lang="twig"> | ||
{{ 'Symfony String + Twig = <3'|u.wordwrap(5).upper }} | {{ 'Symfony String + Twig = <3'|u.wordwrap(5).upper }} | ||
SYMFONY | SYMFONY | ||
سطر 31: | سطر 40: | ||
TWIG | TWIG | ||
= <3 | = <3 | ||
− | </syntaxhighlight>أما للسلاسل النصية الكبيرة فاستخدم الوسم <code>apply</code>:<syntaxhighlight lang="twig"> | + | </syntaxhighlight> |
+ | |||
+ | * أما للسلاسل النصية الكبيرة فاستخدم الوسم <code>apply</code>: | ||
+ | <syntaxhighlight lang="twig"> | ||
{% apply u.wordwrap(5) %} | {% apply u.wordwrap(5) %} | ||
هذا نص كبير حجمه كثيرة كلماته... | هذا نص كبير حجمه كثيرة كلماته... | ||
سطر 39: | سطر 51: | ||
</syntaxhighlight>في حالة مشاريع Symfony، يمكن تفعيله تلقائيًا بتثبيت <code>twig/extra-bundle</code> :<syntaxhighlight lang="twig"> | </syntaxhighlight>في حالة مشاريع Symfony، يمكن تفعيله تلقائيًا بتثبيت <code>twig/extra-bundle</code> :<syntaxhighlight lang="twig"> | ||
$ composer require twig/extra-bundle | $ composer require twig/extra-bundle | ||
− | </syntaxhighlight>أو أضف | + | </syntaxhighlight>أو أضف التوسعة صراحة إلى بيئة Twig:<syntaxhighlight lang="php"> |
use Twig\Extra\String\StringExtension; | use Twig\Extra\String\StringExtension; | ||
سطر 47: | سطر 59: | ||
== انظر أيضًا == | == انظر أيضًا == | ||
− | * [[Twig/intro|مقدمة عن محرك القوالب Twig | + | *[[Twig/intro|مقدمة عن محرك القوالب Twig]] |
− | * [[Twig/advanced|توسيع Twig | + | *[[Twig/advanced|توسيع Twig]] |
− | * [[Twig/internals|المكونات الداخلية لـ Twig | + | *[[Twig/internals|المكونات الداخلية لـ Twig]] |
− | * [[Twig/tags|الوسوم في Twig]] | + | *[[Twig/tags|الوسوم في Twig]] |
− | * [[ Twig/filters|المرشحات في Twig]] | + | *[[ Twig/filters|المرشحات في Twig]] |
== المصادر == | == المصادر == | ||
− | * [https://twig.symfony.com/doc/3.x/filters/u.html صفحة | + | * [https://twig.symfony.com/doc/3.x/filters/u.html صفحة المرشح u في توثيق Twig الرسمي] |
[[تصنيف:Twig]] | [[تصنيف:Twig]] | ||
[[تصنيف:Twig Filters]] | [[تصنيف:Twig Filters]] |
المراجعة الحالية بتاريخ 06:27، 11 مايو 2021
المرشح u
يغلف نصًا بكائن يونيكود -نسخة من UnicodeString من Symfony- يكشف توابع التعديل على السلسلة النصية. وفيما يلي بعض من الاستخدامات الشائعة لهذا المرشح:
- تغليف نص لعدد من المحارف:
{{ 'Symfony String + Twig = <3'|u.wordwrap(5) }}
Symfony
String
+
Twig
= <3
- تقليم سلسلة نصية، انظر كيف تحل النقاط الثلاث محل آخر ثمانية محارف، وهو العدد الذي حُدد ليُقص من السلسلة النصية:
{{ 'Lorem ipsum'|u.truncate(8) }}
Lorem ip
{{ 'Lorem ipsum'|u.truncate(8, '...') }}
Lorem...
- يقبل التابع
truncate
وسيطًا ثالثًا للحفاظ على كلمات كاملة:
{{ 'Lorem ipsum dolor'|u.truncate(10, '...', false) }}
Lorem ipsum...
- تحويل السلسلة النصية إلى حالة الثعبان snake case أو حالة الجمل camel case:
{{ 'SymfonyStringWithTwig'|u.snake }}
symfony_string_with_twig
{{ 'symfony_string with twig'|u.camel.title }}
SymfonyStringWithTwig
- كذلك يمكن سَلسَلة التوابع:
{{ 'Symfony String + Twig = <3'|u.wordwrap(5).upper }}
SYMFONY
STRING
+
TWIG
= <3
- أما للسلاسل النصية الكبيرة فاستخدم الوسم
apply
:
{% apply u.wordwrap(5) %}
هذا نص كبير حجمه كثيرة كلماته...
{% endapply %}
لاحظ أن المرشح u
جزء من StringExtension
وهذا لا يكون مثبتًا افتراضيًا، لذا ثبته أولًا:
$ composer require twig/string-extra
في حالة مشاريع Symfony، يمكن تفعيله تلقائيًا بتثبيت twig/extra-bundle
:
$ composer require twig/extra-bundle
أو أضف التوسعة صراحة إلى بيئة Twig:
use Twig\Extra\String\StringExtension;
$twig = new \Twig\Environment(...);
$twig->addExtension(new StringExtension());