Text field
Os componentes Text fields são usados para colecionar informação provida pelo usuário.
API
Components.TextFields.
Components.TextFields.
Habilita focagem automática
Components.TextFields.
Aplica o estilo em caixa alternativo para o campo de entrada
Components.TextFields.
Components.TextFields.
Adicionar a funcionalidade de limpar o input, ícone padrão é usa o clear do Material Icons
Components.TextFields.
Cria um contador para o tamanho da entrada. O padrão é 25 se nenhum número for especificado. Não é aplicada nenhuma validação.
Components.TextFields.
Components.TextFields.
Desativa a exibição automática de caracteres ao digitar
Components.TextFields.
Components.TextFields.
Components.TextFields.
Components.TextFields.
Designa o tipo da entrada com largura total
Define a altura do componente
Components.TextFields.
Components.TextFields.
Components.TextFields.
Components.TextFields.
Components.TextFields.
Aplica uma máscara personalizada no input. Para mais informações, veja a tabela de máscaras abaixo
Components.TextFields.
Components.TextFields.
Components.TextFields.
Components.TextFields.
Exibe um texto como prefixo
Components.TextFields.
Components.TextFields.
Components.TextFields.
Retorna a string mascarada não modificada
Components.TextFields.
Components.TextFields.
Label não se move em eventos focus/dirty
Components.TextFields.
Components.TextFields.
Components.TextFields.
Components.TextFields.
Exibe um texto como sufixo
Seta o tipo do campo de entrada
Components.TextFields.
Controla visibilidade
Suplementar
Mask | Description |
---|---|
Masks | |
# | Any digit |
A | Any capital letter |
a | Any small letter |
N | Any capital alphanumeric character |
n | Any small alphanumeric character |
X | Any special symbol (-!$%^&*()_+|~=`{}[]:";'<>?,./\) or space |
Pre-made | |
credit-card | #### - #### - #### - #### |
date-with-time | ##/##/#### ##:## |
phone | (###) ### - #### |
social | ###-##-#### |
time | ##:## |
time-with-seconds | ##:##:## |
Exemplos
Tema claro em linha única
Text-fields em linha única não possuem seu label flutuando quando estiver focado ou com dados.
Disabled and readonly
Text fields can be disabled
or readonly
.
Com Ícone
Ícones podem ser especificados como prepended ou appended.
Clearable
When clearable
, you can customize the clear icon with clear-icon
.
Icon events
click:prepend
, click:append
, click:append-outer
, and click:clear
will be emitted when you click on the respective icon. Note that these events will not be fired if the slot is used instead.
Icon slots
Instead of using prepend / append / append-outer icons you can use slots to extend input's functionality.
Label slot
Text field label can be defined in label
slot - that will allow to use HTML content
Contador de caractere
Use um contador para informar o usuário o limite de caracteres. O contador não realiza nenhuma validação por si só. Você precisará juntá-lo com um sistema de validação interno, ou uma biblioteca de terceiros.
Campo de senha
Um campo de senha pode ser usado com um ícone anexado e uma função de retorno (callback) para de controlar sua visibilidade.
Validação
Vuetify inclui uma validação simples através da propriedade rules
. Esta propriedade aceita um array de funções de retorno (callbacks). Enquanto estiver validando as regras, o valor do v-model atual será passado para a função de retorno. Esta função de retorno deve retornar true
ou String
, com a mensagem de erro.
Text field com largura total e contador de caractere
Text fields com largura total possibilitam a você criar campos de entrada sem limites. Neste exemplo, nós usamos o v-divider
para separar os campos.
Texto de sugestão
A propriedade hint nos text-fields adiciona a string fornecida abaixo do text-field. Usando persistent-hint mantém a sugestão visível quando o text-field não estiver focado.
Prefixos e sufixos
As propriedades prefix e suffix permitem a você adicionar na mesma linha um texto não modificável próximo ao text-field, no começo ou final
Validações customizadas
Enquanto o v-form
ou plugins de terceiros como vuelidate ou vee-validation podem ajudar a simplificar seu processo de validação, você pode simplesmente escolher controlar você mesmo.
Estilo em caixa
Text-fields podem ser usados com um design em caixa alternativo. As props de ícones append e prepend não são suportadas neste modo.
Estilo solo
Text-fields podem ser usados com um design solo alternativo.
Outline style
Text fields can be used with an alternative outline design.
Cores customizadas
Você pode opcionalmente modificar um text-field em qualquer cor que a oalheta de cores do Material design contenha. Abaixo é um exemplo de uma implementação de um formulário customizado com validação.
Máscaras
Text fields podem ser validados com máscaras. Usando regras customizadas ou pré-fabricadas, você pode formatar opcionalmente e validar conjuntos específicos de caracteres.
Barra de progresso
Você pode exibir uma barra de progresso ao invés da linha inferior. Você pode usar o progresso indeterminado padrão que possuirá a mesma cor que o text field ou designar uma cor customizada usando o slot progress