عرض مصدر Twig/slug

<noinclude>{{DISPLAYTITLE: المرشح slug في Twig}}</noinclude>
المرشح <code>slug</code> يحول السلسلة النصية إلى سلسلة أخرى لا تحتوي إلا على محارف آسكي ASCII آمنة. انظر المثال التالي:<syntaxhighlight lang="twig">
{{ 'Wôrķšƥáçè ~~sèťtïñğš~~'|slug }}
Workspace-settings
</syntaxhighlight>الفاصل الافتراضي بين الكلمات هي الشرطة <code>-</code>، لكن يمكن تعريف فاصل من اختيارك بتمريره كوسيط:<syntaxhighlight lang="twig">
{{ 'Wôrķšƥáçè ~~sèťtïñğš~~'|slug('/') }}
Workspace/settings
</syntaxhighlight>يحدد الفاصل لغة السلسلة الأصلية تلقائيًا لكن يمكن تحديدها له صراحة باستخدام الوسيط الثاني:<syntaxhighlight lang="twig">
{{ '...'|slug('-', 'ko') }}
</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">
$ composer require twig/string-extra
</syntaxhighlight>في حالة مشاريع Symfony، يمكن تفعيله تلقائيًا بتثبيت <code>twig/extra-bundle</code> :<syntaxhighlight lang="twig">
$ composer require twig/extra-bundle
</syntaxhighlight>أو أضف التوسعة صراحة إلى بيئة Twig:<syntaxhighlight lang="twig">
use Twig\Extra\String\StringExtension;

$twig = new \Twig\Environment(...);
$twig->addExtension(new StringExtension());
</syntaxhighlight>

== الوسائط ==

* <code>seperator</code>: الفاصل المستخدم لربط كلمتين معًا، ويكون الشرطة <code>-</code> افتراضيًا.
* <code>locale</code>: الإعدادات المحلية للسلسلة النصية الأصلية، وسيتم اختيارها تلقائيًا إذا لم تُحدد.
== انظر أيضًا ==
*[[Twig/intro|مقدمة عن محرك القوالب Twig]]
*[[Twig/advanced|توسيع Twig]]
*[[Twig/internals|المكونات الداخلية لـ Twig]]
*[[Twig/tags|الوسوم في Twig]]
*[[ Twig/filters|المرشحات في Twig]]
== المصادر ==
* [https://twig.symfony.com/doc/3.x/filters/slug.html صفحة المرشح slug في توثيق Twig الرسمي]

[[تصنيف:Twig]]
[[تصنيف:Twig Filters]]