3.5 كيف يستخدم Oracle APEX القوالب

3.5 كيف يستخدم Oracle APEX القوالب #

تعرف على كيفية استخدام Oracle APEX القوالب لإنشاء مظهر صفحات التطبيق.

يُنشئ مُحرك APEX مظهر كل صفحة في التطبيق باستخدام القوالب. تُحدد القوالب كيفية عرض الصفحات وعناصر التحكم ومكوناتها. يصف هذا الموضوع الطرق المختلفة لاستخدام القوالب للتحكم في مظهر صفحات التطبيق وتحسينه.

3.5.1 القوالب الأساسية #

تدعم القوالب في Oracle APEX استخدام سلاسل الاستبدال لتمرير المعلومات واستبدال أي سلسلة أحرف بقيمة أخرى.

3.5.1.1 بناء جملة استبدال القالب #

استخدم سلاسل الاستبدال داخل القوالب للإشارة إلى قيم المكونات.

مرر المعلومات واستبدل أي سلسلة أحرف بقيمة أخرى باستخدام صيغة استبدال القالب. لعرض أحدث قائمة بسلاسل الاستبدال المدعومة لقالب معين، استعرض تعريف القالب وابحث عن تقرير سلاسل الاستبدال.

يوضح الجدول التالي ملخصًا لطريقتين لتركيب قواعد استبدال القالب.

النوع	الوصف	مثال	النتيجة
استبدال العنصر النائب	استخدم صيغة سلسلة الاستبدال النائبة داخل قالب للإشارة إلى قيم المكونات.يتم الإشارة إلى سلاسل الاستبدال النائبة المتاحة داخل القالب بواسطة رمز الرقم (#).	Hello #NAME#	Hello APEX Community
استبدال حالة الجلسة	عناصر صفحة المرجع أو التطبيق باستخدام بناء جملة استبدال حالة الجلسة&ITEM. (يُسمى أيضًا بناء الجملة):أشر إلى الصفحة أو عنصر التطبيق بأحرف كبيرةتسبق اسم العنصر علامة (&)أضف نقطة (.) في النهاية	Hello &NAME.	Hello APEX Community

نصيحة: استخدم علامات الاقتباس المزدوجة للأحرف الخاصة أو لحساسية حالة الأحرف. على سبيل المثال:

#"Name"#

&"Name".

3.5.1.2 مرشحات الهروب #

تعرف على كيفية تجنب الأحرف الخاصة في قيمة الاستبدال.

يمكنك تجنب الأحرف الخاصة في قيمة الاستبدال بإضافة علامة تعجب (!) متبوعة باسم مرشح مُحدد مسبقًا إلى اسم عنصر صفحة أو تطبيق، أو عمود تقرير، أو أي سلسلة نصية بديلة أخرى. يُعدّ تجنب الإخراج تقنية أمان مهمة لتجنب هجمات XSS (برمجة نصية متقاطعة للمواقع) في المتصفح.

مرشح الهروب Escape Filter	الوصف	بناء الجملة الكلاسيكي Classic Syntax	بناء الجملة الحديث Modern Syntax
ATTR	ATTRيتجنب الأحرف المحجوزة في سياق سمة HTML.	#NAME!ATTR#	&NAME!ATTR.
HTML	HTMLيتجنب الأحرف HTML المحجوزة.	#NAME!HTML#	&NAME!HTML.
JS	JSيتجنب الأحرف المحجوزة في سياق JavaScript.	#NAME!JS#	&NAME!JS.
STRIPHTML	STRIPHTMLيزيل علامات HTML من المخرجات ويتخلص من أحرف HTML المحجوزة.	#NAME!STRIPHTML#	&NAME!STRIPHTML.
RAW	RAWيحافظ على قيمة العنصر الأصلية ولا يفلت من الأحرف.	#NAME!RAW#	&NAME!RAW.

3.5.1.3 سلاسل الاستبدال المضمنة #

تعرف على سلاسل الاستبدال المضمنة.

يدعم مُنشئ التطبيقات العديد من سلاسل الاستبدال المُدمجة. يمكنك الرجوع إلى هذه السلاسل لتحقيق أنواع مُحددة من الوظائف.

3.5.1.4 الاستبدالات في الرسائل النصية (الإصدار القديم) #

تعرف على كيفية استخدام البدائل في الرسائل النصية.

ملحوظة: الرسائل النصية المُعرّفة بالتطبيق أو النظام، والموضحة في هذا الموضوع، مُصنّفة كوظائف قديمة. إذا كان وضع التوافق في تطبيقك هو الإصدار 24.2 أو أحدث، توصي Oracle بوضع اسم الرسالة بين أقواس متعرجة ({}) كما هو موضح في قسم الاستبدالات في الرسائل النصية (الإصدار 24.2 أو أحدث).

على الرغم من أن Oracle لا تزال تدعم مكونات التطبيقات القديمة، إلا أن Oracle لا توصي باستخدامها.

للوصول إلى الرسائل النصية المحددة بواسطة التطبيق أو النظام، استخدم الاستبدال المدمج APP_TEXT$Message_Name, APP_TEXT$Message_Name$Lang، على سبيل المثال:

&APP_TEXT$MY_MESSAGE!HTML.

&APP_TEXT$MY_MESSAGE$NL!HTML.

3.5.1.5 جافا سكريبت في القوالب #

تعرف على كيفية استخدام JavaScript في القوالب.

يمكنك أيضًا استخدام JavaScript API apex.util.applyTemplate لتقييم القوالب على جانب العميل.

3.5.2 القوالب الجاهزة Theme Templates #

تعرف على المظهر العام وكيفية التحكم في تخطيط التطبيق باستخدام أنماط القوالب، وأسطوانة المظهر، وخيارات القالب.

السمة هي مجموعة من القوالب تُمكّن المطورين من تحديد تصميم ونمط تطبيق كامل. عند إنشاء تطبيق جديد، يستخدم معالج إنشاء التطبيق السمة العالمية – 42 (السمة العالمية). تتميز السمة العالمية بتصميم متجاوب، ومكونات واجهة مستخدم متعددة الاستخدامات، وسهولة التخصيص .

يمكنك تعديل القالب بشكل أكبر باستخدام:

• أنماط القالب Theme Styles– نمط القالب هو CSS يُضاف إلى CSS الأساسي. باستخدام أداة Theme Roller، يمكنك تغيير مظهر التطبيق. يتضمن أنماط التطبيق العالمي Universal Theme – 42.
• Theme Roller – Theme Roller هو محرر CSS مباشر متوفر في قائمة “تخصيص” بشريط أدوات Runtime Developer. استخدم Theme Roller لتغيير نمط القالب والألوان والزوايا الدائرية وخصائص التطبيق الأخرى بسرعة.
• خيارات القالب Template Options – استخدم خيارات القالب لتطبيق معدِّلات CSS بشكل معلن على القوالب التي اخترتها للصفحات والمناطق والتقارير والقوائم ومسارات التنقل والعناصر والأزرار.

3.5.3 الوصول إلى تطبيق القالب العالمي Universal Theme Reference #

قم بتشغيل تطبيق Universal Theme Reference للتعرف على الميزات وأفضل الممارسات عند استخدام Universal Theme.يقدم تطبيق 

Universal Theme Reference مقدمة عن Universal Theme ويوفر تفاصيل وأمثلة لميزات التصميم ومكونات القالب وأيقونات القالب ومعلومات مرجعية حول مجموعة متنوعة من الموضوعات مثل الانتقال إلى أحدث Universal Theme وبناء الأزرار واستخدام الألوان واستخدام متغيرات CSS واستخدام توجيهات القالب.

للوصول إلى تطبيق Universal Theme Reference :

1. يمكنك الوصول إلى Universal Theme Reference بطريقتين:
   • الوصول إلى الإصدار المُستضاف. انتقل إلى https://apex.oracle.com/ut.
   • قم بتثبيت التطبيق في مساحة العمل الخاصة بك من المعرض.
2. لتثبيت تطبيق Universal Theme Reference في مساحة العمل الخاصة بك من المعرض:
   1. انتقل إلى الصفحة الرئيسية لمساحة العمل.
   2. انقر على أيقونة المعرض Gallery. تفتح صفحة المعرض، وتعرض بطاقات لتطبيقات العينة، وتطبيقات البدء، والتطبيقات المخصصة.
   3. انقر فوق تطبيقات العينة Sample Apps.
   4. ابحث عن Universal Theme Reference ثم انقر فوق تنزيل Install .
   5. انقر فوق “تشغيل” Run لعرض النسخة المقدمة من التطبيق.يظهر مرجع الموضوع العالمي .
3. انقر على قائمة التنقل الرئيسية Main Navigation لاستكشاف السمة العالمية. تتضمن الخيارات:
   • ابدأ Getting Started
   • التصميم Design – يسلط الضوء على الميزات الرئيسية للموضوع العالمي بما في ذلك الألوان والتنقل وتخطيط الشبكة وقوالب الصفحات وأنماط الموضوع وأنماط الهاتف المحمول.
   • المكونات Components  – يصف ويقدم أمثلة للمكونات المتوفرة مثل المناطق والقوائم والأزرار.
   • الأيقونات Icons – تصف وتقدم أمثلة للأيقونات المتاحة.
   • مرجع Reference – يوفر معلومات مرجعية وأفضل الممارسات. تشمل المواضيع المتاحة الانتقال إلى أحدث سمة عالمية، وبناء الأزرار، واستخدام الألوان، واستخدام متغيرات CSS، واستخدام توجيهات القالب للتحكم في كيفية معالجة سلاسل الاستبدال والمحتوى.

3.5.4 مكونات القالب Template Components #

استخدم مكونات القالب Template Components لإنشاء مكونات واجهة مستخدم قابلة لإعادة الاستخدام تعمل في مصمم الصفحة Page Designer مثل أي مكون إضافي آخر.

مكونات القالب هي نوع جديد من الإضافات لإنشاء مكونات واجهة مستخدم قابلة لإعادة الاستخدام، مع دعم للإجراءات والقوائم والسمات المخصصة داخل مصمم الصفحات. يمكن عرض هذه المكونات بشكل مستقل كمناطق تعرض صفًا واحدًا أو عدة صفوف من البيانات، كما يمكن عرضها ضمن التقارير كأجزاء من عمود.

السمات المُعرّفة في المكون الإضافي Attributes قابلة للتعديل في مُصمّم الصفحات لأي عمود أو منطقة باستخدام نوع المكون الإضافي. مع إضافة مواضع الإجراءات وقوالب الإجراءات للمكونات الإضافية، يُمكنك تحديد الإجراءات وأزرار القائمة بشروط على مستوى الصف لمكونات القالب. تُمكّن مكونات القالب المطورين من إضافة أنواع مناطق جديدة إلى APEX لا تعتمد على PL/SQL. المناطق الجديدة المستندة إلى مكونات القالب يُمكنها:

• عرض فوري كصفوف متعددة أو صفوف مفردة
• تذكر الترقيم
• استخدام البحث المتعدد الأوجه والمرشحات الذكية
• دعم الطلب الخارجي حسب الترتيب
• دعم اختيار صف واحد ومتعدد بالإضافة إلى التنقل عبر لوحة المفاتيح للتنقل والاختيار
• دعم تجميع بيانات التقرير

يحتوي نوع مكون إضافي لمكونات القالب على قالب HTML، ويدعم توجيهات القالب. توجيهات القالب Template directives هي رموز خاصة في القالب تتحكم في كيفية معالجة النص المحيط بها.

نصيحة: لمعرفة المزيد عن مكونات نوع مكون القالب الإضافية، راجع حول مكونات نوع مكون القالب الإضافية.

3.5.5 توجيهات القالب Template Directives #

توجيهات القالب Template Directives عبارة عن رموز خاصة في القالب تتحكم في كيفية معالجة النص المحيط بها.

استخدم توجيهات القالب للتحكم في كيفية معالجة السمات التي تدعم سلاسل الاستبدال. تدعم مكونات القالب، وسمات محددة لقوالب البريد الإلكتروني، والبطاقات، والشبكة التفاعلية، والتقرير الكلاسيكي، ومناطق التقارير التفاعلية، توجيهات القالب فقط. تُعالج توجيهات القالب كجزء من عمليات الاستبدال من جانب العميل أو الخادم. إذا كانت السمة تدعم توجيهات القالب، فإن تعليمات مصمم الصفحات تتضمن النص Supports Server-side Template Directives أو Supports Client-side Template Directives.