Formulários
VPasswordInput
Campo de senha com toggle de visibilidade, medidor de força e lista de requisitos.
<script setup lang="ts">
import { VPasswordInput } from 'vueui-nova-kit'
</script>Uso
<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
<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
<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
<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
<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
<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
<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
<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
- Visibility toggle has descriptive label — toggle com
aria-label/aria-presseddescritivo (ex.: "Show password" / "Hide password"). - Works with password managers — usa
type="password"nativo (standard inputtype="password"),name/autocomplete(current-password/new-password). - Fully keyboard accessible (Tab, Enter, Space) — campo e toggle operáveis por teclado.
- Clear error messages announced by screen readers — erro ("Password is too weak") via
aria-live/role="alert"+aria-invalid, comaria-describedbypara requisitos. - Strength feedback is not color-only — força com texto ("Good", "Great password!") e ícones/checks além da cor.
- Meets WCAG 2.1 AA color contrast — texto/ícones/erros dentro do contraste mínimo.
- (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
| Prop | Tipo | Default | Descrição |
|---|---|---|---|
modelValue | string | "" | — |
label | string | — | — |
helperText | string | — | — |
errorMessage | string | — | — |
placeholder | string | — | — |
disabled | boolean | false | — |
readonly | boolean | false | — |
required | boolean | false | — |
size | VPasswordInputSize | "md" | — |
showStrength | boolean | false | — |
requirements | boolean | false | — |
name | string | — | — |
id | string | — | — |
autocomplete | string | — | — |
revealLabel | string | — | — |
maskLabel | string | — | — |
Events
| Evento | Payload | Descrição |
|---|---|---|
@update:modelValue | value: string | — |
@focus | payload: FocusEvent | — |
@blur | payload: FocusEvent | — |
@toggle-visibility | visible: boolean | — |
Slots
Sem slots.
Fonte: src/components/form/VPasswordInput/VPasswordInput.vue · tipos: src/components/form/VPasswordInput/VPasswordInput.types.ts