SelectTextField
Deprecated
Use the Dropdown component instead for read only usecases.
Replace with
Dropdown(value=value, expanded=expanded, onExpandedChange=onExpandedChange, onDismissRequest=onDismissRequest,
modifier=modifier, enabled=enabled, required=required, label=label, placeholder=placeholder, helper=helper,
leadingContent=leadingContent, state=state, stateMessage=stateMessage,
visualTransformation=visualTransformation, interactionSource=interactionSource, dropdownContent)Outlined text input to get an input value from a list of elements selectable through a dropdown by the user.
Parameters
the input TextFieldValue to be shown in the text field
the callback that is triggered when the input service updates values in TextFieldValue. An updated TextFieldValue comes as a parameter of the callback
Whether Dropdown Menu should be expanded or not
Executes when the user clicks on the ExposedDropdownMenuBox
Called when the user requests to dismiss the menu, such as by tapping outside the menu's bounds
a Modifier for this text field
True controls the enabled state of the TextField. When false, the text field will be neither editable nor focusable, the input of the text field will not be selectable, visually text field will appear in the disabled UI state
controls the editable state of the TextField. When true, the text field can not be modified, however, a user can focus it and copy text from it. Read-only text fields are usually used to display pre-filled forms that user can not edit
add an asterisk to the label to indicate that this field is required and read it as "label mandatory" but doesn't do anything else so it's up to the developer to handle the behavior.
the optional label to be displayed inside the text field container. The default text style for internal Text is SparkTypography.body2 when the text field is in focus and SparkTypography.body1 when the text field is not in focus
the optional placeholder to be displayed when the text field is in focus and the input text is empty. The default text style for internal Text is SparkTypography.body1
The optional helper text to be displayed at the bottom outside the text input container that give some informations about expected text
the optional leading icon to be displayed at the beginning of the text field container
indicates the validation state of the text field. The label, outline, leading & trailing content are tinted by the state color.
the optional state text to be displayed at the helper position that give more information about the state, it's displayed only when state is not null.
transforms the visual representation of the input value For example, you can use PasswordVisualTransformation to create a password text field. By default no visual transformation is applied
software keyboard options that contains configuration such as KeyboardType and ImeAction
when the input service emits an IME action, the corresponding callback is called. Note that this IME action may be different from what you specified in KeyboardOptions.imeAction
PopupProperties for further customization of this popup's behavior.
the MutableInteractionSource representing the stream of Interactions for this TextField. You can create and pass in your own remembered MutableInteractionSource if you want to observe Interactions and customize the appearance / behavior of this TextField in different Interactions.
The content to be displayed inside ExposedDropdownMenuBox.
See also
Deprecated
Use the Dropdown component instead for read only usecases.
Replace with
Dropdown(value=value, expanded=expanded, onExpandedChange=onExpandedChange, onDismissRequest=onDismissRequest,
modifier=modifier, enabled=enabled, required=required, label=label, placeholder=placeholder, helper=helper,
leadingContent=leadingContent, state=state, stateMessage=stateMessage,
visualTransformation=visualTransformation, interactionSource=interactionSource, dropdownContent)Outlined text input to get an input value from a list of elements selectable through a dropdown by the user.
Parameters
the input text to be shown in the text field
the callback that is triggered when the input service updates the text. An updated text comes as a parameter of the callback
Whether Dropdown Menu should be expanded or not
Executes when the user clicks on the ExposedDropdownMenuBox
Called when the user requests to dismiss the menu, such as by tapping outside the menu's bounds
a Modifier for this text field
True controls the enabled state of the TextField. When false, the text field will be neither editable nor focusable, the input of the text field will not be selectable, visually text field will appear in the disabled UI state
controls the editable state of the TextField. When true, the text field can not be modified, however, a user can focus it and copy text from it. Read-only text fields are usually used to display pre-filled forms that user can not edit
add an asterisk to the label to indicate that this field is required and read it as "label mandatory" but doesn't do anything else so it's up to the developer to handle the behavior.
the optional label to be displayed inside the text field container. The default text style for internal Text is SparkTypography.body2 when the text field is in focus and SparkTypography.body1 when the text field is not in focus
the optional placeholder to be displayed when the text field is in focus and the input text is empty. The default text style for internal Text is SparkTypography.body1
The optional helper text to be displayed at the bottom outside the text input container that give some informations about expected text
the optional leading icon to be displayed at the beginning of the text field container
indicates the validation state of the text field. The label, outline, leading & trailing content are tinted by the state color.
the optional state text to be displayed at the helper position that give more information about the state, it's displayed only when state is not null.
transforms the visual representation of the input value For example, you can use PasswordVisualTransformation to create a password text field. By default no visual transformation is applied
software keyboard options that contains configuration such as KeyboardType and ImeAction
when the input service emits an IME action, the corresponding callback is called. Note that this IME action may be different from what you specified in KeyboardOptions.imeAction
commentCountPopupProperties for further customization of this popup's behavior.
the MutableInteractionSource representing the stream of Interactions for this TextField. You can create and pass in your own remembered MutableInteractionSource if you want to observe Interactions and customize the appearance / behavior of this TextField in different Interactions.
The content to be displayed inside ExposedDropdownMenuBox.