المرشح u في Twig

المرشح 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());

انظر أيضًا

• مقدمة عن محرك القوالب Twig.
• توسيع Twig.
• المكونات الداخلية لـ Twig.
• الوسوم في Twig.
• المرشحات في Twig.

المصادر

• صفحة توثيق المرشح u في توثيق Twig الرسمي.