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

انظر أيضًا

المصادر