Twig/u

المرشح 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 الرسمي