فوکوس را ضبط و رها کنید

در حالت‌های تعاملی تخصصی (مانند بوم نقاشی تعبیه‌شده، سطح کنترل‌کننده بازی یا پنجره ورودی مودال)، ممکن است برنامه شما نیاز داشته باشد که موقتاً فوکوس را روی یک جزء قفل کند و از حرکت Tab یا کلیدهای جهت‌نما جلوگیری کند.

هشدار: ثبت فوکوس می‌تواند باعث ایجاد مشکلات دسترسی شود. کاربران ممکن است نتوانند به سایر اجزای قابل فوکوس هدایت شوند.

فوکوس را ثبت کنید

برای گرفتن فوکوس، تابع captureFocus() روی FocusRequester فراخوانی کنید:

val focusRequester = remember { FocusRequester() }

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

نکته کلیدی: کامپوننت هدف باید هنگام فراخوانی captureFocus() از قبل فوکوس فعال ( isFocused == true ) را حفظ کرده باشد. فراخوانی تابع captureFocus() روی یک عنصر غیرفوکوس، false را برمی‌گرداند و در گرفتن فوکوس ناموفق است.

در حالی که فوکوس ثبت می‌شود، کلیدهای ناوبری استاندارد فوکوس (مانند Tab ) فوکوس را به اجزای مجاور منتقل نمی‌کنند.

تمرکز را رها کنید

برای خروج از حالت ثبت‌شده و بازیابی ناوبری فوکوس عادی در رابط کاربری، تابع freeFocus() را فراخوانی کنید:

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

{% کلمه به کلمه %} {% فعل کمکی %}