الفرق بين المراجعتين لصفحة: «Twig/u»
< Twig
جميل-بيلوني (نقاش | مساهمات) طلا ملخص تعديل |
جميل-بيلوني (نقاش | مساهمات) طلا ملخص تعديل |
||
| سطر 41: | سطر 41: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
* أما للسلاسل النصية الكبيرة فاستخدم الوسم <code>apply</code>:<syntaxhighlight lang="twig"> | * أما للسلاسل النصية الكبيرة فاستخدم الوسم <code>apply</code>: | ||
<syntaxhighlight lang="twig"> | |||
{% apply u.wordwrap(5) %} | {% apply u.wordwrap(5) %} | ||
هذا نص كبير حجمه كثيرة كلماته... | هذا نص كبير حجمه كثيرة كلماته... | ||
مراجعة 08:49، 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());