الفرق بين المراجعتين لصفحة: «Twig/slug»
< Twig
أسامه-دمراني (نقاش | مساهمات) 1.0: إضافة عنوان الصفحة | 2.0 محتوى الصفحة |
جميل-بيلوني (نقاش | مساهمات) طلا ملخص تعديل |
||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE: المرشح slug في Twig}}</noinclude> | |||
المرشح slug يحول السلسلة النصية إلى سلسلة أخرى لا تحتوي إلا على محارف آسكي (ASCII) آمنة. انظر المثال التالي:<syntaxhighlight lang="twig"> | المرشح <code>slug</code> يحول السلسلة النصية إلى سلسلة أخرى لا تحتوي إلا على محارف آسكي (ASCII) آمنة. انظر المثال التالي:<syntaxhighlight lang="twig"> | ||
{{ 'Wôrķšƥáçè ~~sèťtïñğš~~'|slug }} | {{ 'Wôrķšƥáçè ~~sèťtïñğš~~'|slug }} | ||
Workspace-settings | Workspace-settings | ||
| سطر 8: | سطر 8: | ||
</syntaxhighlight>يحدد الفاصل لغة السلسلة الأصلية تلقائيًا لكن يمكن تحديدها له صراحة باستخدام الوسيط الثاني:<syntaxhighlight lang="twig"> | </syntaxhighlight>يحدد الفاصل لغة السلسلة الأصلية تلقائيًا لكن يمكن تحديدها له صراحة باستخدام الوسيط الثاني:<syntaxhighlight lang="twig"> | ||
{{ '...'|slug('-', 'ko') }} | {{ '...'|slug('-', 'ko') }} | ||
</syntaxhighlight>يستخدم المرشح slug التابع بنفس الاسم المستخدم به في [https://symfony.com/doc/current/components/string.html#slugger AsciiSlugger] الخاص بـ Symfony. | </syntaxhighlight>يستخدم المرشح <code>slug</code> التابع بنفس الاسم المستخدم به في [https://symfony.com/doc/current/components/string.html#slugger <code>AsciiSlugger</code>] الخاص بـ Symfony. | ||
لاحظ أن المرشح <code>slug</code> جزء من <code>StringExtension</code> وهذا لا يكون مثبتًا افتراضيًا، لذا ثبته أولًا:<syntaxhighlight lang="twig"> | لاحظ أن المرشح <code>slug</code> جزء من <code>StringExtension</code> وهذا لا يكون مثبتًا افتراضيًا، لذا ثبته أولًا:<syntaxhighlight lang="twig"> | ||
| سطر 14: | سطر 14: | ||
</syntaxhighlight>في حالة مشاريع Symfony، يمكن تفعيله تلقائيًا بتثبيت <code>twig/extra-bundle</code> :<syntaxhighlight lang="twig"> | </syntaxhighlight>في حالة مشاريع Symfony، يمكن تفعيله تلقائيًا بتثبيت <code>twig/extra-bundle</code> :<syntaxhighlight lang="twig"> | ||
$ composer require twig/extra-bundle | $ composer require twig/extra-bundle | ||
</syntaxhighlight>أو أضف | </syntaxhighlight>أو أضف التوسعة صراحة إلى بيئة Twig:<syntaxhighlight lang="twig"> | ||
use Twig\Extra\String\StringExtension; | use Twig\Extra\String\StringExtension; | ||
| سطر 26: | سطر 26: | ||
* <code>locale</code>: الإعدادات المحلية للسلسلة النصية الأصلية، وسيتم اختيارها تلقائيًا إذا لم تُحدد. | * <code>locale</code>: الإعدادات المحلية للسلسلة النصية الأصلية، وسيتم اختيارها تلقائيًا إذا لم تُحدد. | ||
== انظر أيضًا == | == انظر أيضًا == | ||
* [[Twig/intro|مقدمة عن محرك القوالب Twig | *[[Twig/intro|مقدمة عن محرك القوالب Twig]] | ||
* [[Twig/advanced|توسيع Twig | *[[Twig/advanced|توسيع Twig]] | ||
* [[Twig/internals|المكونات الداخلية لـ Twig | *[[Twig/internals|المكونات الداخلية لـ Twig]] | ||
* [[Twig/tags|الوسوم في Twig]] | *[[Twig/tags|الوسوم في Twig]] | ||
* [[ Twig/filters|المرشحات في Twig]] | *[[ Twig/filters|المرشحات في Twig]] | ||
== المصادر == | == المصادر == | ||
* [https://twig.symfony.com/doc/3.x/filters/slug.html صفحة | * [https://twig.symfony.com/doc/3.x/filters/slug.html صفحة المرشح slug في توثيق Twig الرسمي] | ||
[[تصنيف:Twig]] | [[تصنيف:Twig]] | ||
[[تصنيف:Twig Filters]] | [[تصنيف:Twig Filters]] | ||
مراجعة 08:03، 6 مايو 2021
المرشح slug يحول السلسلة النصية إلى سلسلة أخرى لا تحتوي إلا على محارف آسكي (ASCII) آمنة. انظر المثال التالي:
{{ 'Wôrķšƥáçè ~~sèťtïñğš~~'|slug }}
Workspace-settings
الفاصل الافتراضي بين الكلمات هي الشرطة (-)، لكن يمكن تعريف فاصل من اختيارك بتمريره كوسيط:
{{ 'Wôrķšƥáçè ~~sèťtïñğš~~'|slug('/') }}
Workspace/settings
يحدد الفاصل لغة السلسلة الأصلية تلقائيًا لكن يمكن تحديدها له صراحة باستخدام الوسيط الثاني:
{{ '...'|slug('-', 'ko') }}
يستخدم المرشح slug التابع بنفس الاسم المستخدم به في AsciiSlugger الخاص بـ Symfony.
لاحظ أن المرشح slug جزء من 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());
الوسائط
seperator: الفاصل المستخدم لربط كلمتين معًا، ويكون الشرطة-افتراضيًا.locale: الإعدادات المحلية للسلسلة النصية الأصلية، وسيتم اختيارها تلقائيًا إذا لم تُحدد.