الفرق بين المراجعتين لصفحة: «Twig/u»
< Twig
جميل-بيلوني (نقاش | مساهمات) طلا ملخص تعديل |
جميل-بيلوني (نقاش | مساهمات) طلا ملخص تعديل |
||
| سطر 2: | سطر 2: | ||
المرشح <code>u</code> يغلف نصًا بكائن يونيكود -[https://symfony.com/doc/current/components/string.html نسخة من 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 | ||
| سطر 10: | سطر 11: | ||
= <3 | = <3 | ||
</syntaxhighlight> | </syntaxhighlight> | ||
* تقليم سلسلة نصية، انظر كيف تحل النقاط الثلاث محل آخر ثمانية محارف، وهو العدد الذي حُدد ليُقص من السلسلة النصية: | |||
* تقليم سلسلة نصية، انظر كيف تحل النقاط الثلاث محل آخر ثمانية محارف، وهو العدد الذي حُدد ليُقص من السلسلة النصية:<syntaxhighlight lang="twig"> | <syntaxhighlight lang="twig"> | ||
{{ 'Lorem ipsum'|u.truncate(8) }} | {{ 'Lorem ipsum'|u.truncate(8) }} | ||
Lorem ip | Lorem ip | ||
| سطر 18: | سطر 19: | ||
Lorem... | Lorem... | ||
</syntaxhighlight> | </syntaxhighlight> | ||
* يقبل التابع <code>truncate</code> وسيطًا ثالثًا للحفاظ على كلمات كاملة: | |||
* يقبل التابع <code>truncate</code> وسيطًا ثالثًا للحفاظ على كلمات كاملة:<syntaxhighlight lang="twig"> | <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): | |||
* تحويل السلسلة النصية إلى حالة الثعبان (snake case) أو حالة الجمل (camel case):<syntaxhighlight lang="twig"> | <syntaxhighlight lang="twig"> | ||
{{ 'SymfonyStringWithTwig'|u.snake }} | {{ 'SymfonyStringWithTwig'|u.snake }} | ||
symfony_string_with_twig | symfony_string_with_twig | ||
| سطر 31: | سطر 32: | ||
SymfonyStringWithTwig | SymfonyStringWithTwig | ||
</syntaxhighlight> | </syntaxhighlight> | ||
* كذلك يمكن سَلسَلة التوابع: | |||
* كذلك يمكن سَلسَلة التوابع:<syntaxhighlight lang="twig"> | <syntaxhighlight lang="twig"> | ||
{{ 'Symfony String + Twig = <3'|u.wordwrap(5).upper }} | {{ 'Symfony String + Twig = <3'|u.wordwrap(5).upper }} | ||
SYMFONY | SYMFONY | ||
مراجعة 08:50، 6 مايو 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());