التقاط التركيز وإفلاته

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

تحذير: يمكن أن يؤدي التركيز على عنصر معيّن إلى حدوث مشاكل في تسهيل الاستخدام. قد لا يتمكّن المستخدمون من الانتقال إلى مكوّنات أخرى قابلة للتركيز.

التقاط التركيز

لجذب التركيز، استخدِم captureFocus() في FocusRequester:

val focusRequester = remember { FocusRequester() }

Box(
    modifier = Modifier
        .focusRequester(focusRequester)
        .focusable()
        .onFocusChanged { focusState ->
            if (focusState.isFocused) {
                focusRequester.captureFocus()
            }
        }
)
CaptureFocus.kt

ملاحظة مهمة: يجب أن يكون المكوّن المستهدَف في وضع التركيز النشط (isFocused == true) عند استدعاء captureFocus(). يؤدي استدعاء captureFocus() على عنصر غير مركَّز عليه إلى عرض false ويتعذّر التركيز عليه.

أثناء التقاط التركيز، لا تنقل مفاتيح التنقّل العادية للتركيز (مثل Tab) التركيز إلى المكوّنات المجاورة.

التركيز على الإصدارات

للخروج من حالة الالتقاط واستعادة التنقّل العادي باستخدام التركيز في واجهة المستخدم، يمكنك استدعاء freeFocus():

IconButton(
    onClick = {
        focusRequester.freeFocus()
    }
) {
    Icon(Icons.Default.Close, contentDescription = "Exit focus lock")
}
CaptureFocus.kt