Formulários

VOtpInput

Componentev-model10 exemplos15 propsA2UI · OtpInput

Campo de código de verificação com input lógico único, slots visuais, colar código completo e auto-submit.

Importação
<script setup lang="ts">
import { VOtpInput } 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 VOtpInput.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: modelValue="240186".

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

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

<template>
  <VOtpInput v-model="value" />
</template>

Four Digits

Variação Four Digits. Props: length=4, modelValue="1234".

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

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

<template>
  <VOtpInput v-model="value" :length="4" />
</template>

Masked

Variação Masked. Props: masked=true, modelValue="123456".

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

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

<template>
  <VOtpInput v-model="value" masked />
</template>

Error

Variação Erro. Props: modelValue="123", errorMessage="Invalid verification code".

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

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

<template>
  <VOtpInput v-model="value" error-message="Invalid verification code" />
</template>

Success

Variação Sucesso. Props: modelValue="240186", success=true.

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

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

<template>
  <VOtpInput v-model="value" success />
</template>

With Resend

Variação Com Resend. Props: helperText="Didn't receive the code?", resendLabel="Resend code", resendCooldown=23.

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

<template>
  <VOtpInput
    v-model="value"
    helper-text="Didn't receive the code?"
    :resend-cooldown="23" />
</template>

Interactive

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

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

const code = ref('')
const onComplete = (value) => {
        console.log("complete", value);
      }
</script>

<template>
  <VOtpInput
    v-model="code"
    auto-submit
    helper-text="We've sent a 6-digit code to alex@company.com."
    resend-label="Resend code"
    :resend-cooldown="23"
    @complete="onComplete" />
</template>

Auto Submit

Variação Auto Submit. Props: length=6, autoSubmit=true, helperText="Envia ao completar os 6 díg…".

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

<template>
  <VOtpInput
    v-model="value"
    auto-submit
    helper-text="Envia ao completar os 6 dígitos" />
</template>

Separator Index

Variação Separator Index. Props: length=6, separatorIndex=3.

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

<template>
  <VOtpInput v-model="value" :separator-index="3" />
</template>

Disabled

Variação Desabilitado. Props: length=6, disabled=true, modelValue="123".

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

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

<template>
  <VOtpInput v-model="value" disabled />
</template>

Acessibilidade

Input lógico único com inputmode="numeric" e autocomplete="one-time-code", slots aria-hidden, erro com role="alert".

Estados

Empty · Active · Filled · Error · Success · Disabled.

Motion

TriggerPropertyDurationEasing
Focus ringbox-shadow100msease-out
ErrortranslateX shake280msease-out
Successopacity100msease-out

Respeitar prefers-reduced-motion.

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

Props

PropTipoDefaultDescrição
modelValuestring""—
lengthnumber6—
maskedbooleanfalse—
autoSubmitbooleanfalse—
disabledbooleanfalse—
errorMessagestring——
successbooleanfalse—
sizeVOtpInputSize"md"—
separatorIndexnumber——
helperTextstring——
resendLabelstring"Resend code"—
resendCooldownnumber0—
ariaLabelstring"Verification code"—
idstring——
motionVMotionLevelV_MOTION_DEFAULT ("expressive")—

Events

EventoPayloadDescrição
@update:modelValuevalue: string—
@completevalue: string—
@resend——
@focuspayload: FocusEvent—
@blurpayload: FocusEvent—

Slots

Sem slots.

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