الدالتان Navigate وBack

  • 6 دقائق

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

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

Navigate(Screen [, ScreenTransition [, UpdateContextRecord ]])

  • Screen (مطلوب) - الشاشة المراد عرضها (أو الانتقال إليها).

  • ScreenTransition (اختياري) - الانتقال المرئي المطلوب استخدامه بين الشاشة الحالية والشاشة التالية. القيمة الافتراضية هي None.

  • UpdateContextRecord (اختياري): سجل يحتوي على اسم عمود واحد على الأقل وقيمة لكل عمود. يقوم هذا السجل بتحديث متغيرات السياق القابلة للتطبيق فِي الشاشة الجديدة.

بمعنى آخر، يجب عليك تضمين المعلمة الأولى لإعلام Power Apps بالشاشة التي يجب الانتقال إليها. يمكنك استخدام المعلمة الثانية لتحديد كيفية تغير الشاشة القديمة بشكل مرئي إلى الشاشة الجديدة. يمكنك استخدام المعلمة الثالثة لتمرير قيمة السياق إلى الشاشة الجديدة.

الدالة Back

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

Back([ScreenTransition])

  • ScreenTransition (اختياري) - الانتقال المرئي المطلوب استخدامه بين الشاشة الحالية والشاشة التالية. القيمة الافتراضية هي انتقال الشاشة العكسي للدالة Navigate التي تنقل المستخدم إلى الشاشة.

عند إضافة Back إلى تطبيقك، يجب أن يتضمن أقواسًا: Back().

تعمل الدالة Back على إرجاع المستخدم إلى الشاشة التي تم عرضها مؤخراً. أثناء انتقال المستخدم إلى شاشات أخرى، يتتبع التطبيق مسار الشاشات والانتقالات المستخدمة. وبالتالي، عند تشغيل الدالة Back، يتم تشغيل الانتقال العكسي للشاشة. يمكن للمستخدمين استخدام الدالة Back للعودة إلى الشاشة التي ظهرت عند فتح التطبيق.

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

دعونا ننظر عن كثب إلى انتقالات الشاشة، حيث أنها يمكن أن تكون جزءًا من صيغتي Navigate وBack. تتوفر هذه الخيارات فِي Power Apps:

  • 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}) يعرض شاشة Details مع الانتقال Fade. يقوم بتحديث قيمة متغير السياق ID إلى 12. تتلاشى الشاشة الحالية لتظهر الشاشة Details، ويتم تعيين متغير السياق 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() تعرض الشاشة السابقة مع انتقال الرجوع الافتراضي. يعرض التطبيق الشاشة السابقة من خلال الانتقال العكسي للانتقال الذي ظهرت من خلاله الشاشة الحالية.
Back(ScreenTransition.Cover) تعرض الشاشة السابقة مع انتقال Cover. يعرض التطبيق الشاشة السابقة من خلال انتقال Cover بصرف النظر عن للانتقال الذي ظهرت من خلاله الشاشة الحالية.

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

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