Text field

Os componentes Text fields são usados para colecionar informação provida pelo usuário.

Utilização

Um text-field simples com placeholder e/ou label.

API

v-text-field
Nome
append-icon
Padrão
undefined
Tipos
string

Components.TextFields.

Nome
append-outer-icon New in — v1.1
Padrão
undefined
Tipos
string

Components.TextFields.

Nome
autofocus
Padrão
false
Tipos
boolean

Habilita focagem automática

Nome
background-color
Padrão
undefined
Tipos
string

Components.TextFields.

Nome
box
Padrão
false
Tipos
boolean

Aplica o estilo em caixa alternativo para o campo de entrada

Nome
browser-autocomplete
Padrão
undefined
Tipos
string

Components.TextFields.

Nome
clear-icon
Padrão
'$vuetify.icons.clear'
Tipos
string

Components.TextFields.

Nome
clearable
Padrão
false
Tipos
boolean

Adicionar a funcionalidade de limpar o input, ícone padrão é usa o clear do Material Icons

Nome
color
Padrão
'primary'
Tipos
string

Components.TextFields.

Nome
counter
Padrão
undefined
Tipos
boolean | number | string

Cria um contador para o tamanho da entrada. O padrão é 25 se nenhum número for especificado. Não é aplicada nenhuma validação.

Nome
dark
Padrão
false
Tipos
boolean

Components.TextFields.

Nome
disabled
Padrão
false
Tipos
boolean

Components.TextFields.

Nome
dont-fill-mask-blanks
Padrão
false
Tipos
boolean

Desativa a exibição automática de caracteres ao digitar

Nome
error
Padrão
false
Tipos
boolean

Components.TextFields.

Nome
error-count
Padrão
1
Tipos
number | string

Components.TextFields.

Nome
error-messages
Padrão
[]
Tipos
string | array

Components.TextFields.

Nome
flat
Padrão
false
Tipos
boolean

Components.TextFields.

Nome
full-width
Padrão
false
Tipos
boolean

Designa o tipo da entrada com largura total

Nome
height
Padrão
undefined
Tipos
number | string

Define a altura do componente

Nome
hide-details
Padrão
false
Tipos
boolean

Components.TextFields.

Nome
hint
Padrão
undefined
Tipos
string

Components.TextFields.

Nome
label
Padrão
undefined
Tipos
string

Components.TextFields.

Nome
light
Padrão
false
Tipos
boolean

Components.TextFields.

Nome
loading
Padrão
false
Tipos
boolean | string

Components.TextFields.

Nome
mask
Padrão
undefined
Tipos
object | string

Aplica uma máscara personalizada no input. Para mais informações, veja a tabela de máscaras abaixo

Nome
messages
Padrão
[]
Tipos
string | array

Components.TextFields.

Nome
outline
Padrão
false
Tipos
boolean

Components.TextFields.

Nome
persistent-hint
Padrão
false
Tipos
boolean

Components.TextFields.

Nome
placeholder
Padrão
undefined
Tipos
string

Components.TextFields.

Nome
prefix
Padrão
undefined
Tipos
string

Exibe um texto como prefixo

Nome
prepend-icon
Padrão
undefined
Tipos
string

Components.TextFields.

Nome
prepend-inner-icon New in — v1.1
Padrão
undefined
Tipos
string

Components.TextFields.

Nome
readonly
Padrão
false
Tipos
boolean

Components.TextFields.

Nome
return-masked-value
Padrão
false
Tipos
boolean

Retorna a string mascarada não modificada

Nome
reverse New in — v1.1
Padrão
false
Tipos
boolean

Components.TextFields.

Nome
rules
Padrão
[]
Tipos
array

Components.TextFields.

Nome
single-line
Padrão
false
Tipos
boolean

Label não se move em eventos focus/dirty

Nome
solo
Padrão
false
Tipos
boolean

Components.TextFields.

Nome
solo-inverted
Padrão
false
Tipos
boolean

Components.TextFields.

Nome
success New in — v1.1
Padrão
false
Tipos
boolean

Components.TextFields.

Nome
success-messages New in — v1.1
Padrão
[]
Tipos
string | array

Components.TextFields.

Nome
suffix
Padrão
undefined
Tipos
string

Exibe um texto como sufixo

Nome
type
Padrão
'text'
Tipos
string

Seta o tipo do campo de entrada

Nome
validate-on-blur
Padrão
false
Tipos
boolean

Components.TextFields.

Nome
value
Padrão
undefined
Tipos
any

Controla visibilidade

Suplementar

Mask legend
MaskDescription
Masks
#Any digit
AAny capital letter
aAny small letter
NAny capital alphanumeric character
nAny small alphanumeric character
XAny 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

Edit this page | language on Github
Vuetify 3 is now available!The latest version of Vuetify is now available!
Learn about Vuetify 3's new features and functionality for modern Vue applications
Start exploringExplore