Перечисление ImeAction

Перечисление ImeAction из пакета androidx.compose.ui.text.input выбирает, что показать на клавише ввода справа внизу программной клавиатуры. Значение передают в KeyboardOptions параметром imeAction. Нажатие обрабатывают в keyboardActions у текстового поля.

Синтаксис

ImeAction.Search

Значения

Значение	Описание
`None`	Отдельная клавиша действия не показывается.
`Default`	Стандартное действие для текущего типа поля.
`Go`	Переход к следующему шагу или экрану.
`Search`	Запуск поиска по введённому тексту.
`Send`	Отправка сообщения или формы.
`Next`	Переход фокуса к следующему полю в форме.
`Done`	Завершение ввода и закрытие клавиатуры.
`Previous`	Переход фокуса к предыдущему полю.

Если imeAction не задан, Compose подбирает Default по контексту поля.

Пример

Давайте поставим на клавиатуре действие Search:

import android.os.Bundle
import androidx.activity.ComponentActivity
import androidx.activity.compose.setContent
import androidx.compose.foundation.text.KeyboardOptions
import androidx.compose.material3.OutlinedTextField
import androidx.compose.runtime.getValue
import androidx.compose.runtime.mutableStateOf
import androidx.compose.runtime.remember
import androidx.compose.runtime.setValue
import androidx.compose.ui.text.input.ImeAction

class MainActivity : ComponentActivity() {
	override fun onCreate(savedInstanceState: Bundle?) {
		super.onCreate(savedInstanceState)
		setContent {
			var text by remember { mutableStateOf("abcde") }
			OutlinedTextField(
				value = text,
				onValueChange = { text = it },
				keyboardOptions = KeyboardOptions(
					imeAction = ImeAction.Search,
				),
			)
		}
	}
}

На экране поле ввода, на клавиатуре справа внизу отображается клавиша поиска.

Смотрите также

класс KeyboardOptions,
который передаёт imeAction в поле
класс KeyboardType,
который выбирает раскладку клавиатуры
перечисление KeyboardCapitalization,
которое задаёт автоматический регистр
класс LocalSoftwareKeyboardController,
который скрывает клавиатуру из кода