Twig/Topics
مقدمة عن Twig
مقدمة حول محرك القوالب Twig تعرض ميزاته وشروط تثبيته وكيفية بدء استخدامه.
تصميم القوالب
يشرح هذا القسم البنيةَ اللغوية لمحرك القوالب ودلالياته وسيكون ذا نفع عظيم كمرجع لأولئك الذين ينشئون قوالب Twig.
واجهة برمجة التطبيقات (API)
يشرح هذا القسم واجهة برمجة التطبيقات لمحرك القوالب Twig، وسيكون مفيدًا كمرجع لأولئك الذين يستخدمون واجهة القالب للتطبيق، فهو لا يشرح لغة القالب نفسه، وليس للذين ينشؤون قوالب Twig.
توسيع Twig
شرح كيفية توسيع عمل محرك Twig مثل إضافة وسوم إضافية ومرشحات واختبارات وعوامل (operators) ومتغيرات عامة ودوال وغيرها.
المكونات الداخلية
هذا القسم مفيد لمن يرغب في معرفة كيف يعمل Twig في الحقيقة.
الوصفات
يعرض هذا القسم وصفات سرية تستحق الإطلاع عليها قد تساعدك في عملك مع محرك قوالب 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: