Textinput

Descrição do componente InputText e seus atributos

O que é?

O Text Input é um componente responsável por exibir uma área de texto editável para o usuário. Esses campos de textos são usados para coletar dados que um usuário insere utilizando um teclado.

A sua estrutura é representada como mostrado abaixo:

Atributos	Tipo	Obrigatório	Descrição
value	String ou Binding	✓	Atributo que guarda o valor inserido em um campo de texto
placeholder	String ou Binding		Atributo que define um texto que é mostrado quando não existe informação adicionada ao campo de texto.
enabled	Boolean		Habilita ou desabilita um campo de texto
readOnly	Boolean		Define um campo de texto como `readOnly` quando definido como `true`.
type	TextInputType ou Binding		Este atributo define qual tipo de texto será inserido no campo de texto. Em dispositivos moveis, ele também define qual tipo de teclado aparece quando o campo ganha focus.
styleId	String		Define uma chave do tipo String para mapear esse componente em um Design System no front end da aplicação. Essa chave identifica qual estilo será aplicado a esse componente.
error	String ou Binding		Define uma mensagem de erro para esse campo de texto.
showError	Boolean or Binding		Define se a mensagem de erro ficará visível quando definido como `true`
onFocus	List<Action>		Define uma lista de Ações que é executada quando o campo de texto ganha foco
onChange	List<Action>		Define uma lista de Ações que é executada quando o campo de texto tem o valor (value) modificado
onBlur	List<Action>		Define uma lista de Ações que é executada quando o campo de texto perde o foco

TextInputType

É um ENUM responsável por definir qual o tipo de entrada de texto.

Tipo	Definição
DATE	Entrada de dados é uma data.
EMAIL	Entrada de dados é um email.
PASSWORD	Entrada de dados é uma senha.
NUMBER	Entrada de dados somente com números.
TEXT	Entrada de dados é um texto.

Como usar?

Segue abaixo um exemplo de entrada de texto do tipo senha:

JSON
Kotlin DSL

TextInput(
    value = "my value", 
    placeholder = "password", 
    type = TextInputType.PASSWORD, 
    styleId = "test.input.style",
    onChange = listOf(
        Alert(
            message = "Text value changed."
        )
    )
)

Feedback

Was this page helpful?

Glad to hear it! Please tell us how we can improve.

Sorry to hear that. Please tell us how we can improve.

Última modificação 01/07/2021: refactor: updates the text input info, attribute details and table structure main (#692) (a836be1f)