Formulários

VPasswordInput

Componentev-model7 exemplos16 propsA2UI · PasswordInput

Campo de senha com toggle de visibilidade, medidor de força e lista de requisitos.

Importação
<script setup lang="ts">
import { VPasswordInput } from 'vueui-nova-kit'
</script>

Uso

Exemplo
<script setup lang="ts">

</script>

<template>
  
</template>

Playground

Os controles abaixo são gerados a partir das props declaradas em VPasswordInput.types.ts; o código acompanha cada mudança.

Exemplos

Variantes, tamanhos e estados, extraídos das stories da biblioteca.

Default

Variação Padrão. Estado padrão do componente; use a aba Controls para experimentar as props ao vivo. Props: label="Password", placeholder="Password".

Ver código
vue
<script setup lang="ts">
import { VPasswordInput } from 'vueui-nova-kit'
</script>

<template>
  <VPasswordInput v-model="value" label="Password" placeholder="Password" />
</template>

With Strength

Variação Com Strength. Interativo: o estado é mantido na própria story (v-model).

Ver código
vue
<script setup lang="ts">
import { ref } from 'vue'
import { VPasswordInput } from 'vueui-nova-kit'

const password = ref('VueNova2024')
</script>

<template>
  <VPasswordInput
    v-model="password"
    label="Password"
    placeholder="Create a strong password"
    :show-strength="true"
    helper-text="Use at least 8 characters." />
</template>

With Requirements

Variação Com Requirements. Interativo: o estado é mantido na própria story (v-model).

Ver código
vue
<script setup lang="ts">
import { ref } from 'vue'
import { VPasswordInput } from 'vueui-nova-kit'

const password = ref('Vue')
</script>

<template>
  <VPasswordInput
    v-model="password"
    label="Password"
    placeholder="Create a strong password"
    :show-strength="true"
    :requirements="true" />
</template>

Error

Variação Erro. Props: label="Password", modelValue="123", errorMessage="Password is too weak".

Ver código
vue
<script setup lang="ts">
import { ref } from 'vue'
import { VPasswordInput } from 'vueui-nova-kit'

const value = ref('123')
</script>

<template>
  <VPasswordInput
    v-model="value"
    label="Password"
    placeholder="Create a strong password"
    error-message="Password is too weak" />
</template>

Disabled

Variação Desabilitado. Props: label="Password", modelValue="••••••••", disabled=true.

Ver código
vue
<script setup lang="ts">
import { ref } from 'vue'
import { VPasswordInput } from 'vueui-nova-kit'

const value = ref('••••••••')
</script>

<template>
  <VPasswordInput
    v-model="value"
    label="Password"
    placeholder="Create a strong password"
    disabled />
</template>

Sizes

Variação Tamanhos.

Ver código
vue
<script setup lang="ts">
import { VPasswordInput } from 'vueui-nova-kit'
</script>

<template>
  <div style="display:flex;flex-direction:column;gap:16px;max-width:420px">
    <VPasswordInput size="sm" label="Small" placeholder="Password" />
    <VPasswordInput size="md" label="Medium" placeholder="Password" />
    <VPasswordInput size="lg" label="Large" placeholder="Password" />
  </div>
</template>

Readonly Required

Variação Somente leitura obrigatório. Props: label="Senha", modelValue="segredo123", readonly=true, required=true.

Ver código
vue
<script setup lang="ts">
import { ref } from 'vue'
import { VPasswordInput } from 'vueui-nova-kit'

const value = ref('segredo123')
</script>

<template>
  <VPasswordInput
    v-model="value"
    label="Senha"
    placeholder="Create a strong password"
    readonly
    required />
</template>

Acessibilidade

  1. Visibility toggle has descriptive label — toggle com aria-label/aria-pressed descritivo (ex.: "Show password" / "Hide password").
  2. Works with password managers — usa type="password" nativo (standard input type="password"), name/autocomplete (current-password/new-password).
  3. Fully keyboard accessible (Tab, Enter, Space) — campo e toggle operáveis por teclado.
  4. Clear error messages announced by screen readers — erro ("Password is too weak") via aria-live/role="alert" + aria-invalid, com aria-describedby para requisitos.
  5. Strength feedback is not color-only — força com texto ("Good", "Great password!") e ícones/checks além da cor.
  6. Meets WCAG 2.1 AA color contrast — texto/ícones/erros dentro do contraste mínimo.
  7. (Implícito: alvo e foco) — toggle com área mínima 44×44px e anel de foco visível via :focus-visible.

Estados

Default · Hover · Focus · Revealed · Invalid · Disabled.

Motion

Toggle reveal 100ms · focus ring 100ms · strength bar fill 200ms.

Todas as transições respeitam prefers-reduced-motion e os tokens --v-duration-*.

Props

PropTipoDefaultDescrição
modelValuestring""—
labelstring——
helperTextstring——
errorMessagestring——
placeholderstring——
disabledbooleanfalse—
readonlybooleanfalse—
requiredbooleanfalse—
sizeVPasswordInputSize"md"—
showStrengthbooleanfalse—
requirementsbooleanfalse—
namestring——
idstring——
autocompletestring——
revealLabelstring——
maskLabelstring——

Events

EventoPayloadDescrição
@update:modelValuevalue: string—
@focuspayload: FocusEvent—
@blurpayload: FocusEvent—
@toggle-visibilityvisible: boolean—

Slots

Sem slots.

Fonte: src/components/form/VPasswordInput/VPasswordInput.vue · tipos: src/components/form/VPasswordInput/VPasswordInput.types.ts