التركيز في Glimmer من Jetpack Compose

أجهزة XR المعنيّة
تساعدك هذه الإرشادات في إنشاء تجارب لهذه الأنواع من أجهزة الواقع الممتد.
مزيد من المعلومات حول أنواع أجهزة XR →
نظارات AI Glasses
مزيد من المعلومات حول أنواع أجهزة XR →

تم تصميم جميع مكوّنات Glimmer في Jetpack Compose للعمل مع طرق الإدخال العادية، مثل النقر أو التمرير السريع على لوحة اللمس في نظارات الذكاء الاصطناعي، مع الاستجابة أيضًا لأوامر الإدخال ذات المستوى الأدنى الخاصة بأجهزة نظارات الذكاء الاصطناعي. تتعامل مكوّنات Glimmer في Jetpack Compose تلقائيًا مع أحداث الإدخال اللازمة. بالنسبة إلى المكوّنات المخصّصة، يمكنك الاستفادة من واجهات برمجة التطبيقات الحالية في Compose، مثل Modifier.draggable أو Modifier.scrollable لتنفيذ سلوكيات تفاعلية معيّنة.

في نظارات الذكاء الاصطناعي المزودة بشاشة، يمكن أن يؤثر إدخال المؤشر في التركيز:

  • النقر: تفاعل مباشر لتفعيل العنصر ينتقل التركيز إلى أحد العناصر عندما يتفاعل معه المستخدم.
  • التمرير سريعًا: يُستخدم للتنقّل والتمرير. تتم ترجمة إيماءات التمرير السريع غير المعالَجة تلقائيًا إلى حركات تركيز، ما يتيح التنقّل السلس في واجهة المستخدم بدون إدخال مباشر باستخدام المؤشر.

تركيز الحركة وتغيير الترتيب أثناء تنقّل المستخدم في تطبيقك

حركة التركيز

في حاوية قابلة للتمرير، ينتقل التركيز باستمرار عند التمرير سريعًا على لوحة اللمس. بالنسبة إلى العناصر المنفصلة، مثل صف من الأزرار، تؤدي كل تمريرة سريعة إلى نقل التركيز إلى عنصر واحد في كل مرة.

ترتيب التركيز

تمامًا كما هو الحال في Jetpack Compose، تستخدم Jetpack Compose Glimmer البحث عن التركيز الأحادي الأبعاد. لمزيد من المعلومات حول ترتيب التمرير بين العناصر القابلة للتركيز، يُرجى الاطّلاع على تغيير ترتيب التمرير بين العناصر القابلة للتركيز.

لتغيير العنصر الذي يتم التركيز عليه في البداية، يمكنك إضافة Modifier.focusGroup() على المستوى الأعلى وتحديد onEnter focusProperty مخصّص:

Modifier.focusProperties {
    onEnter = {
        initialFocus.requestFocus()
        cancelFocusChange()
    }
}
.focusGroup()

حاويات قابلة للتمرير

للحصول على تجربة مستخدم مثالية، يجب أن تكون الحاويات التي تتضمّن محتوًى قابلاً للتمرير، مثل القوائم، هي المكوّن الرئيسي الوحيد على الشاشة. تجنَّب وضع قائمة قابلة للتمرير مباشرةً فوق أو أسفل عناصر تفاعلية أخرى، مثل الأزرار، وذلك لتجنُّب حدوث أي التباس بشأن التنقّل ولتعزيز حركة التركيز السلسة والمتوقّعة.

حالات التركيز التلقائية

تنفِّذ مكتبة Jetpack Compose Glimmer حالات التركيز التلقائية في جميع المكوّنات التفاعلية، بما في ذلك مساحات العرض والبطاقات وعناصر القوائم، ما يعزّز تقديم ملاحظات مرئية واضحة ومتسقة أثناء تفاعل المستخدم.

الشكل 1. ثلاث حالات تركيز في Jetpack Compose Glimmer، يتم التمييز بينها باستخدام ملاحظات مرئية مستندة إلى المخطط التفصيلي.

  • تلقائي: يتم استخلاص لون خلفية الزر من GlimmerTheme.colors.surface، ويتم احتساب لون المحتوى الرئيسي لهذا السطح، وتكون الرموز GlimmerTheme.colors.primary.

  • التركيز: يتم زيادة عرض الحدود للإشارة إلى التركيز.

  • التركيز + الضغط: يتم ضبط الخلفية على GlimmerTheme.colors.surface بدرجة عتامة كاملة للإشارة إلى حالة التحديد.