الفرق بين المراجعتين ل"Twig/u"

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
ط
ط
سطر 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());

انظر أيضًا

المصادر