يؤدي وضع "الاستخدام على سطح مستوٍ" في الأجهزة القابلة للطي إلى تقسيم شاشة واحدة إلى منطقتَي عرض وظيفيتَين يفصل بينهما الطي الفعلي (أو المفصلة). يتيح لك وضع "السطح المستوي" وضع المحتوى الرئيسي لتطبيقك (مثل مشغّل فيديو أو لوحة ألعاب) في النصف العلوي، مع وضع العناصر التفاعلية (مثل عناصر التحكّم في الوسائط أو لوحات التحكّم) في النصف السفلي.
أفضل الممارسات
لإضافة وضعية سطح المكتب إلى تطبيقك، استخدِم واجهة برمجة التطبيقات Grid لتحديد تنسيق يتضمّن صفَّين وعمودًا واحدًا، وطبِّق الاستعلام عن الوسائط لوضعية نافذة سطح المكتب.
- رصد وضعية سطح الطاولة بشكل تفاعلي: استخدِم الدالة المركّبة
mediaQueryلمراقبة حالة الجهاز. عند طي الجهاز في وضع "التثبيت على سطح مستوٍ" (windowPosture == Posture.Tabletop)، يمكنك تغيير التنسيق ديناميكيًا بدون الحاجة إلى إعادة تشغيل النشاط أو التعامل مع مراحل النشاط المعقّدة. - تنظيم التنسيقات باستخدام
Grid: عند استخدام وضعية سطح المكتب، استخدِم واجهة برمجة التطبيقاتGrid(2 rows،1 column) لفصل المحتوى المرئي الأساسي بشكل واضح في الصف العلوي فوق الجزء المرئي من الصفحة وعناصر التحكّم التفاعلية في الصف السفلي تحت الجزء المرئي من الصفحة. - الاستفادة من الفهرسة الضمنية للمحور Z في العناصر التي تظهر على الشاشة: في الوضعيات العادية (غير وضعية سطح المكتب)، يمكنك تخصيص عدة أرقام تعريف للمناطق في الخلية نفسها لعرض عناصر التحكّم فوق المشغّل. يعرض
Gridالعناصر تلقائيًا من الخلف إلى الأمام حسب ترتيب تعريفها. - توفير انتقالات سلسة: تأكَّد من الحفاظ على الحالة ومواضع الانتقال عند التبديل بين تنسيقات ملء الشاشة العادية ووضع سطح المكتب.
المكوّنات
-
Grid: حاوية تنسيق متجاوبة تتيح لك وضع العناصر في صفوف وأعمدة قابلة للضبط، وهي مثالية لتقسيم المحتوى على مناطق مختلفة من الشاشة. -
mediaQuery: هي واجهة برمجة تطبيقات في Jetpack Compose تُستخدَم للاستعلام عن وضعية النافذة الحالية للتطبيق وفئات الحجم وخصائص الأجهزة مباشرةً داخل الدوال المركّبة.
الخطوات
يمكنك الاستعلام عن حالة الجهاز باستخدام mediaQuery(). عندما يكون الجهاز في وضعية سطح الطاولة، يمكنك ترتيب محتوى تطبيقك في شبكة عمودية تتضمّن صفَّين وعمودًا واحدًا، مع التأكّد من بقاء المحتوى الأساسي في الأعلى وإمكانية الوصول إلى عناصر التحكّم في الأسفل.
1. تحديد إعدادات Grid لوضع "التثبيت على سطح مستوٍ"
داخل دالة مركّبة، حدِّد أرقام تعريف مساحات التنسيق باستخدام تعداد وأعِدّ مجموعات GridConfigurationScope لوضعَي "الوضع التلقائي" و"وضع سطح الطاولة".
في defaultConfig، يتم تخصيص كلتا المساحتَين للخلية نفسها (row = 1, column = 1). يستخدم Grid فهرسة z الضمنية حيث يتم عرض الدوال المركّبة التي تم تعريفها لاحقًا في التنسيق فوق الدوال السابقة، ما يسمح لوحدة التحكّم بتراكب المشغّل بدون تداخل إضافي للحاويات (يُرجى الاطّلاع على تراكبات عناصر واجهة المستخدم مع الشبكة لمزيد من التفاصيل).
enum class VideoPlayerArea { Player, Controller } object PlayerGridConfig { // Default: Single area layout with overlay (controls on top of player) val defaultConfig: GridConfigurationScope.() -> Unit = { row(1f) column(1f) area(areaId = VideoPlayerArea.Player, row = 1, column = 1) area(areaId = VideoPlayerArea.Controller, row = 1, column = 1) } // Tabletop: Two rows splitting content across the fold val tabletopConfig: GridConfigurationScope.() -> Unit = { row(0.5f) row(0.5f) column(1f) area(areaId = VideoPlayerArea.Player, row = 1, column = 1) // Top half above fold area(areaId = VideoPlayerArea.Controller, row = 2, column = 1) // Bottom half below fold } }
2. رصد وضعية الجهاز اللوحي وتطبيق الإعدادات على Grid
استخدِم mediaQuery لاختيار الإعدادات النشطة استنادًا إلى windowPosture، ومرِّر config إلى Grid، واربط المحتوى القابل للإنشاء بمعرّفات المناطق. يضمن تعريف VideoPlayerArea.Player قبل VideoPlayerArea.Controller أنّه عندما يتشاركان خلية في defaultConfig، يتم عرض عناصر التحكّم فوق المشغّل:
val config = mediaQuery { when (windowPosture) { Posture.Tabletop -> PlayerGridConfig.tabletopConfig else -> PlayerGridConfig.defaultConfig } } Grid(config = config) { Box( modifier = Modifier .gridItem(areaId = VideoPlayerArea.Player) ) { // VideoPlayerContent } Box( modifier = Modifier .gridItem(areaId = VideoPlayerArea.Controller) ) { // PlaybackControlsContent } }
النتائج
من خلال الجمع بين mediaQuery وGrid، يرصد تطبيقك ديناميكيًا متى يكون الجهاز القابل للطي مطويًا جزئيًا في وضعية سطح الطاولة ويضبط واجهة المستخدم تلقائيًا على منطقتَي عرض وظيفيتَين يفصل بينهما الجزء المطوي.
مراجع إضافية
- بدء استخدام التطبيقات التكيُّفية
- إتاحة أوضاع العرض على الأجهزة القابلة للطي
- تراكبات عناصر واجهة المستخدم مع الشبكة