Twig/Topics
مقدمة عن Twig
مقدمة حول محرك القوالب Twig تعرض ميزاته وشروط تثبيته وكيفية بدء استخدامه.
تصميم القوالب
يشرح هذا القسم البنيةَ اللغوية لمحرك القوالب ودلالياته وسيكون ذا نفع عظيم كمرجع لأولئك الذين ينشئون قوالب Twig.
واجهة برمجة التطبيقات (API)
يشرح هذا القسم واجهة برمجة التطبيقات لمحرك القوالب Twig، وسيكون مفيدًا كمرجع لأولئك الذين يستخدمون واجهة القالب للتطبيق، فهو لا يشرح لغة القالب نفسه، وليس للذين ينشؤون قوالب Twig.
توسيع Twig
شرح كيفية توسيع عمل محرك Twig مثل إضافة وسوم إضافية ومرشحات واختبارات وعوامل (operators) ومتغيرات عامة ودوال وغيرها.
المكونات الداخلية
هذا القسم مفيد لمن يرغب في معرفة كيف يعمل Twig في الحقيقة.
الوصفات (Recipes)
يعرض هذا القسم وصفات سرية تستحق الإطلاع عليها قد تساعدك في عملك مع محرك قوالب Twig ووضبطه وتخصيص استخدامك المتقدم له.
معايير كتابة الشيفرة
يذكر هذا القسم معايير كتابة الشيفرة المتبعة عند استعمال Twig.
الوسوم (Tags)
الوسوم في Twig هي بنيات تحكم، تتحكم في طريقة عمل القوالب وسيرها، وهي تتكون من شرطيات (مثل if/elseif/else) وحلقات تكرارية وكُتل. وتظهر الوسوم داخل أزواج من كُتل {% %}، وتكون كتلة الإغلاق {% end %} حيث تتبع end باسم الوسم. وفيما يلي الوسوم الموجودة في محرك القوالب Twig:
- apply
- autoescape
- block
- cache
- deprecated
- do
- embed
- extends
- flush
- for
- from
- if
- import
- include
- macro
- sandbox
- set
- use
- verbatim
- with
المرشحات (Filters)
تسمح المرشحات (filters) بتعديل بيانات متغير قبل استخدامه، وأشهر استخدام لها هو عند إخراج المحتوى، كما تستطيع استعمالها عند إسناد قيمة المتغير إلى متغير آخر. وفيما يلي المرشحات التي في محرك القوالب Twig:
- abs
- batch
- capitalize
- column
- convert_encoding
- country_name
- currency_name
- currency_symbol
- data_uri
- date
- date_modify
- default
- escape
- filter
- first
- format
- format_currency
- format_date
- format_datetime
- format_number
- format_time
- html_to_markdown
- inline_css
- inky_to_html
- join
- json_encode
- keys
- language_name
- last
- length
- locale_name
- lower
- map
- markdown_to_html
- merge
- nl2br
- number_format
- raw
- reduce
- replace
- reverse
- round
- slice
- slug
- sort
- spaceless
- split
- striptags
- timezone_name
- title
- trim
- u
- upper
- url_encode
الدوال (Functions)
تُستخدم الدوال لإجراء عملية ما، وتُستدعى بأسمائها متبوعة بأقواس، وقد تحتوي على وسيط واحد أو أكثر داخل تلك الأقواس. فيما يلي الدوال الموجودة في محرك القوالب Twig:
- attribute
- block
- constant
- cycle
- date
- dump
- html_classes
- include
- max
- min
- parent
- random
- range
- country_timezones
- template_from_string
الاختبارات (Tests)
تُستخدم الاختبارات مع العامل is لاختبار متغير مقابل تعبير ما، ويكون المعامَل (operand) الأيسر للعامل is هو الشيء المختبَر، والأيمن هو اسم الاختبار. وفيما يلي الاختبارات الموجودة في محرك القوالب Twig:
العوامل (Operators)
إليك العوامل الموجودة في محرك القوالب Twig: