درخواست تمرکز به صورت برنامه‌نویسی‌شده

در برخی از جریان‌های کاربری، برنامه شما نیاز دارد که به طور صریح تمرکز را به یک جزء خاص منتقل کند. برای مثال، وقتی کاربر روی دکمه "جستجو" کلیک می‌کند، ممکن است بخواهید به طور خودکار تمرکز را روی فیلد ورودی جستجو قرار دهید.

از FocusRequester استفاده کنید

برای درخواست صریح تمرکز:

1. یک نمونه FocusRequester ایجاد کنید و آن را به خاطر بسپارید: val focusRequester = remember { FocusRequester() } .
2. با استفاده از اصلاحگر focusRequester FocusRequester به کامپوننت هدف (target composable) متصل کنید.
3. تابع requestFocus() درون یک رویداد فراخوانی (callback) (مانند onClick ) یا یک محدوده‌ی کوروتین فراخوانی کنید.

val focusRequester = remember { FocusRequester() }
var text by remember { mutableStateOf("") }

TextField(
    value = text,
    onValueChange = { text = it },
    modifier = Modifier.focusRequester(focusRequester)
)
FocusSnippets.kt

val focusRequester = remember { FocusRequester() }
var text by remember { mutableStateOf("") }

TextField(
    value = text,
    onValueChange = { text = it },
    modifier = Modifier.focusRequester(focusRequester)
)

Button(onClick = { focusRequester.requestFocus() }) {
    Text("Request focus on TextField")
}
FocusSnippets.kt

تنظیم فوکوس اولیه صفحه نمایش

برای قرار دادن فوکوس اولیه روی یک کامپوننت خاص هنگام نمایش اولیه صفحه، requestFocus() را درون LaunchedEffect(Unit) فعال کنید:

LaunchedEffect(Unit) {
    focusRequester.requestFocus()
}

هنگام پیمایش بین کانتینرها یا بازگشت از صفحه نمایش دیگر، می‌توانید focusRestorer() به کانتینرهای والد نیز متصل کنید تا به طور خودکار فوکوس به آخرین فرزند فوکوس شده بازگردد. برای اطلاعات بیشتر، به راهنمای Restore focus مراجعه کنید.