Campo de texto
AlpopInputField é o campo de texto base para formulários. O rótulo é uma prop (label), sem acoplamento com i18n.
Padrão
Valor:
Com ícone
Estado de erro
não pode ficar em branco
Props
Este é o campo base. Vários outros campos (
email-field,phone-field,currency-field,date-field,select-field, entre outros) o estendem viaextends, então herdam todas as props abaixo além das suas próprias.
Conteúdo e rótulo
| Prop | Tipo | Padrão | Descrição |
|---|---|---|---|
name | String | — | Nome do campo (obrigatório) |
modelValue | String|Number | — | Valor (v-model) |
label | String | null | Rótulo exibido |
hideLabel | Boolean | false | Renderiza sem o rótulo visível |
placeholder | String | — | Texto de placeholder |
icon | String | null | Ícone opcional à esquerda |
helper | String | — | Texto auxiliar |
error | String | — | Mensagem de erro |
Comportamento do input
| Prop | Tipo | Padrão | Descrição |
|---|---|---|---|
type | String | "text" | Tipo do input HTML (email, number, password, etc.) |
mask | String|Object | — | Máscara de entrada (via maska); string simples ou objeto de opções |
pattern | String | — | Atributo pattern de validação HTML |
min | String | — | Valor/comprimento mínimo (atributo HTML min) |
max | String | — | Valor/comprimento máximo (atributo HTML max) |
autocomplete | Boolean | false | Habilita o autocomplete do navegador |
autofocus | Boolean | false | Foca o campo ao montar |
readonly | Boolean | false | Somente leitura |
disabled | Boolean | false | Desabilita o campo |
required | Boolean | false | Marca como obrigatório |
id | String | — | id explícito do input (por padrão é derivado de name) |
Eventos
| Evento | Payload | Quando |
|---|---|---|
update:modelValue | String|Number | A cada digitação (usado por v-model) |
blur | Event | Ao perder o foco |