الدَالتَان Navigate وBack

  • 6 دقائق

لنلق نظرة عَلى كيفية إضَافة وسَائط إلى الدَالتين Navigate وBack لتحسين واجهة المستخدم فِي تطبيق Power Apps. فِي بنَاء الجملة، تشير الأقواس المربعة إلى المعلمَات الاختيَارية.

فيمَا يلي تفاصيل بنَاء الجملة Navigate:

Navigate(ScreenName, ScreenTransition.TransitionType, {ContextRecord: NewValue})

  • ScreenName (مطلوب) - الشَاشة المرَاد عرضهَا.

  • ScreenTransition (اختيَاري) - الانتقَال المرئي المطلوب استخدَامه بين الشَاشة الحَالية والشَاشة التَالية. إذا تمَّ حَذفُه، يكونُ ScreenTransition.None هو الإعدَاد الافتِرَاضي.

  • ContextRecord (اختيَاري): سجلٌ يحتوي عَلى اسمٍ واحدٍ أو أكثرَ من أسمَاءِ متغيرَاتِ السيَاقِ وقيمِهَا. يقوم هذا السجل بتعيين أو تحديث متغيرَات السيَاق عَلى الشَاشة الجديدة.

يجب تحديدُ المعلمةِ الأولى للإشَارةِ إلى الشَاشةِ التي يجب الانتقَالُ إليهَا. تتحكمُ المعلمةُ الثَانيةُ اختيَارًا فِي تأثيرِ الانتقَالِ. يتيح لك المعلمة الثَالثة تمرير قيم السيَاق إلى الشَاشة الجديدة.

الدَالة Back

فيمَا يلِي بنَاء جُملة الدَالة Back:

Back([ScreenTransition])

  • ScreenTransition (اختيَاري) - الانتقَالُ المرئيُّ المطلوبُ استخدَامُه عند العودةِ إلى الشَاشةِ السَابقةِ. بشكلٍ افترَاضيٍ، هذا هو عكسُ الانتقَالِ المستخدمِ للوصولِ إلى الشَاشةِ الحَاليةِ.

يجبُ أن تتضمنَ الدَالةُ Back الأقوَاس: Back().

تقُومُ الدَالة Back بإعَادةِ المُستخدم إلى الشَاشةِ التي تمَّ عرضُهَا مسبقًا. تحتفظُ Power Apps بسِجلِ التَنقُّل، بمَا فِي ذلك انتقَالات الشَاشَة. عِندَ استِخدَام Back، يعيدُ Power Apps النَقل (مَا لم يتم تحديد انتقَالٍ معينٍ).

انتقَالات الشَاشة

يمكن استخدَامُ انتقَالاتِ الشَاشةِ مع كلِّ من الدَالتينِ Navigate وBack. تتضمن الخيَارَات المُتَاحة الآتي:

  • ScreenTransition.Cover: تنزلق الشَاشة الجديدة من اليمين إلى اليسَار، وتغطي الشَاشة الحَالية.

  • ScreenTransition.CoverRight: شَاشةٌ جديدةٌ تنزلقُ من اليسَارِ إلى اليمينِ.

  • ScreenTransition.Fade: تتلاشى الشَاشة الحَالية، لتظهر الشَاشة الجديدة.

  • ScreenTransition.None (افترَاضي) التبديلُ فورًا إلى الشَاشةِ الجديدةِ.

  • ScreenTransition.UnCover: تتحرك الشَاشة الحَالية من اليمين إلى اليسَار.

  • ScreenTransition.UnCoverRight: تتحرك الشَاشة الحَالية من اليسَار إلى اليمين.

أمثلة

يقدم الجدول التَالي بعض الأمثلة عَلى المعَادلات التي تستخدم التحولات لكل من الدَالتين Navigate وBack. يتضمن الجدول أيضًا بعض المعلمَات UpdateContextRecord الموجودة فِي أمثلة Navigate، حتى تتمكن من تصور الشكل الذي ستبدو عليه فِي تطبيقك.

المعَادلة ‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫‏‫الوَصف‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎‏‎ النتيجة
Navigate(Details) الانتِقَال إلى شَاشَة Details دُون الانتِقَال أو تَغيِير السِيَاق. تظهر شَاشة Details التفَاصيل بشَكلٍ فَوري.
Navigate(Details, ScreenTransition.Fade) الانتِقَال إلى شَاشَة Details باستِخدَام انتِقَال Fade تتلاشى الشَاشة الحَالية إلى الشَاشة Details.
Navigate(Details, ScreenTransition.Fade, {ID: 12}) يضيف انتقَالَ تلاشيٍ ويضبطُ متغيرَ السيَاقِ ID. تظهرُ شَاشَة التَفاصِيل مَع ID ضَبطِهَا عَلى 12.
Navigate(Details, ScreenTransition.Fade, {ID: 12 , Shade: Color.Red}) يعرض شَاشة Details مع الانتقَال Fade. يقوم بتحديث قيمة متغير السيَاق ID إلى 12. يقوم بتحديث قيمة متغير السيَاق Shade إلى Color.Red. تتلاشى الشَاشة الحَالية لعرض الشَاشة Details. يتم تعيين متغير السيَاق ID عَلى الشَاشة Details إلى 12، ويتم تعيين متغير السيَاق Shade إلى Color.Red. إذا قمت بتعيين الخَاصية Fill لعنصر تحكم عَلى الشَاشة Details إلى Shade، فسيظهر عنصر التحكم هذا بلون أحمر.
Back() يعودُ إلى الشَاشةِ السَابقةِ باستخدَامِ الانتقَالِ العَكسِي. يعكِسُ Power Apps الانتقَال الأخِير لعَرضِ الشَاشَة السَابقَة.
Back(ScreenTransition.Cover) يعودُ إلى الشَاشةِ السَابقةِ باستخدَامِ الانتقَالِ Cover. يستخدمُ انتقَالَ Cover بغضِّ النظرِ عن كيفيةِ إدخَالِ الشَاشةِ الحَاليةِ.

باختصَارٍ، تدعمُ مُعلمَات دَعم Navigate وBack للتحكُّم المُحسَّن. باستِخدَام Navigate، يمكنك توجيهُ المستخدمينَ إلى شَاشةٍ أخرى، وتطبيقُ الانتقَالاتِ، وتعيينُ متغيرَاتِ السيَاقِ. تتيحُ الدَالةُ Back التنقل العَكسي مَع انتقَالاتٍ افترَاضيةٍ أو محددةٍ.

لقَد استخدَمتَ حتَّى الآن خَاصية OnSelect لتَمكِين التَنقُّل عَلى الشَاشَة. فِي الوحدة التَالية، سوف تستكشف طرقًا إضَافية لتنفيذ التنقل عبر التطبيق.