الفرق بين المراجعتين لصفحة: «Twig/Topics»
< Twig
جميل-بيلوني (نقاش | مساهمات) |
جميل-بيلوني (نقاش | مساهمات) طلا ملخص تعديل |
||
| سطر 14: | سطر 14: | ||
هذا القسم مفيد لمن يرغب في معرفة كيف يعمل Twig في الحقيقة. | هذا القسم مفيد لمن يرغب في معرفة كيف يعمل Twig في الحقيقة. | ||
== [[Twig/recipes|الوصفات | == [[Twig/recipes|الوصفات]] == | ||
يعرض هذا القسم وصفات سرية تستحق الإطلاع عليها قد تساعدك في عملك مع محرك قوالب Twig ووضبطه وتخصيص استخدامك المتقدم له. | يعرض هذا القسم وصفات سرية تستحق الإطلاع عليها قد تساعدك في عملك مع محرك قوالب Twig ووضبطه وتخصيص استخدامك المتقدم له. | ||
| سطر 20: | سطر 20: | ||
يذكر هذا القسم معايير كتابة الشيفرة المتبعة عند استعمال Twig. | يذكر هذا القسم معايير كتابة الشيفرة المتبعة عند استعمال Twig. | ||
== [[Twig/tags|الوسوم | == [[Twig/tags|الوسوم Tags]] == | ||
الوسوم في Twig هي بنيات تحكم، تتحكم في طريقة عمل القوالب وسيرها، وهي تتكون من شرطيات | الوسوم في Twig هي بنيات تحكم، تتحكم في طريقة عمل القوالب وسيرها، وهي تتكون من شرطيات مثل if/elseif/else وحلقات تكرارية وكُتل. وتظهر الوسوم داخل أزواج من كُتل <code>{% %}</code>، وتكون كتلة الإغلاق <code>{% end %}</code> حيث تتبع <code>end</code> باسم الوسم. وفيما يلي الوسوم الموجودة في محرك القوالب Twig: | ||
*[[ Twig/apply|apply]] | *[[ Twig/apply|apply]] | ||
*[[ Twig/autoescape|autoescape]] | *[[ Twig/autoescape|autoescape]] | ||
| سطر 43: | سطر 43: | ||
*[[ Twig/with|with]] | *[[ Twig/with|with]] | ||
== [[Twig/filters|المرشحات (Filters)]] == | == [[Twig/filters|المرشحات (Filters)]] == | ||
تسمح المرشحات | تسمح المرشحات filters بتعديل بيانات متغير قبل استخدامه، وأشهر استخدام لها هو عند إخراج المحتوى، كما تستطيع استعمالها عند إسناد قيمة المتغير إلى متغير آخر. وفيما يلي المرشحات التي في محرك القوالب Twig: | ||
*[[ Twig/abs|abs]] | *[[ Twig/abs|abs]] | ||
*[[ Twig/batch|batch]] | *[[ Twig/batch|batch]] | ||
| سطر 98: | سطر 98: | ||
*[[ Twig/upper|upper]] | *[[ Twig/upper|upper]] | ||
*[[ Twig/url_encode|url_encode]] | *[[ Twig/url_encode|url_encode]] | ||
== [[Twig/functions|الدوال | == [[Twig/functions|الدوال Functions]] == | ||
تُستخدم الدوال لإجراء عملية ما، وتُستدعى بأسمائها متبوعة بأقواس، وقد تحتوي على وسيط واحد أو أكثر داخل تلك الأقواس. فيما يلي الدوال الموجودة في محرك القوالب Twig: | تُستخدم الدوال لإجراء عملية ما، وتُستدعى بأسمائها متبوعة بأقواس، وقد تحتوي على وسيط واحد أو أكثر داخل تلك الأقواس. فيما يلي الدوال الموجودة في محرك القوالب Twig: | ||
*[[ Twig/attribute|attribute]] | *[[ Twig/attribute|attribute]] | ||
| سطر 115: | سطر 115: | ||
*[[ Twig/country_timezones|country_timezones]] | *[[ Twig/country_timezones|country_timezones]] | ||
*[[ Twig/template_from_string|template_from_string]] | *[[ Twig/template_from_string|template_from_string]] | ||
== [[Twig/tests|الاختبارات | == [[Twig/tests|الاختبارات Tests]] == | ||
تُستخدم الاختبارات مع العامل <code>is</code> لاختبار متغير مقابل تعبير ما، ويكون المعامَل | تُستخدم الاختبارات مع العامل <code>is</code> لاختبار متغير مقابل تعبير ما، ويكون المعامَل operand الأيسر للعامل <code>is</code> هو الشيء المختبَر، والأيمن هو اسم الاختبار. وفيما يلي الاختبارات الموجودة في محرك القوالب Twig: | ||
*[[ Twig/constant_test|constant]] | *[[ Twig/constant_test|constant]] | ||
*[[ Twig/defined|defined]] | *[[ Twig/defined|defined]] | ||
| سطر 125: | سطر 125: | ||
*[[Twig/sameas|same as]] | *[[Twig/sameas|same as]] | ||
== العوامل | == العوامل Operators == | ||
إليك العوامل الموجودة في محرك القوالب Twig: | إليك العوامل الموجودة في محرك القوالب Twig: | ||
* [[Twig/templates#.D8.B9.D8.A7.D9.85.D9.84 .D8.A7.D9.84.D8.A7.D8.AD.D8.AA.D9.88.D8.A7.D8.A1|in]] | * [[Twig/templates#.D8.B9.D8.A7.D9.85.D9.84 .D8.A7.D9.84.D8.A7.D8.AD.D8.AA.D9.88.D8.A7.D8.A1|in]] | ||
* [[Twig/templates#.D8.B9.D8.A7.D9.85.D9.84 .D8.A7.D9.84.D8.A7.D8.AE.D8.AA.D8.A8.D8.A7.D8.B1|is]] | * [[Twig/templates#.D8.B9.D8.A7.D9.85.D9.84 .D8.A7.D9.84.D8.A7.D8.AE.D8.AA.D8.A8.D8.A7.D8.B1|is]] | ||
* [[Twig/templates#.D8.A7.D9.84.D8.B9.D9.85.D9.84.D9.8A.D8.A7.D8.AA .D8.A7.D9.84.D8.B1.D9.8A.D8.A7.D8.B6.D9.8A.D8.A9|رياضية]] | * [[Twig/templates#.D8.A7.D9.84.D8.B9.D9.85.D9.84.D9.8A.D8.A7.D8.AA .D8.A7.D9.84.D8.B1.D9.8A.D8.A7.D8.B6.D9.8A.D8.A9|رياضية]] | ||
* [[Twig/templates#.D8.A7.D9.84.D8.B9.D9.85.D9.84.D9.8A.D8.A7.D8.AA .D8.A7.D9.84.D9.85.D9.86.D8.B7.D9.82.D9.8A.D8.A9|منطقية]] | ** +, -, /, %, //, *, ** | ||
* [[Twig/templates#.D8.A7.D9.84.D8.B9.D9.85.D9.84.D9.8A.D8.A7.D8.AA .D8.A7.D9.84.D9.85.D9.86.D8.B7.D9.82.D9.8A.D8.A9|منطقية]] | |||
** and, or, not, (), b-and, b-xor, b-or | |||
* [[Twig/templates#.D8.A7.D9.84.D9.85.D9.88.D8.A7.D8.B2.D9.86.D8.A7.D8.AA .28Comparisons.29|موازنة]] | * [[Twig/templates#.D8.A7.D9.84.D9.85.D9.88.D8.A7.D8.B2.D9.86.D8.A7.D8.AA .28Comparisons.29|موازنة]] | ||
** | ** ==,!=, <, >, >=, <=, [[Twig/sameas|===]] | ||
** | ** starts with, ends with, matches | ||
* [[Twig/templates#.D8.A7.D9.84.D8.B9.D9.88.D8.A7.D9.85.D9.84 .D8.A7.D9.84.D8.A3.D8.AE.D8.B1.D9.89|عوامل أخرى]] | * [[Twig/templates#.D8.A7.D9.84.D8.B9.D9.88.D8.A7.D9.85.D9.84 .D8.A7.D9.84.D8.A3.D8.AE.D8.B1.D9.89|عوامل أخرى]] | ||
** .., |, ~, ., [], ?:, ?? | |||
مراجعة 13:04، 6 مايو 2021
مقدمة عن 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: