Formulários

VFileUpload

Componentev-model8 exemplos14 props

Upload de arquivos com dropzone, validação, progresso e lista de arquivos.

Importação
<script setup lang="ts">
import { VFileUpload } 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 VFileUpload.types.ts; o código acompanha cada mudança.

Exemplos

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

Dropzone

Variação Dropzone. Props: variant="dropzone".

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

<template>
  <VFileUpload v-model="value" accept="image/*,.pdf" :max-size="10485760" />
</template>

Button Trigger

Variação Button Trigger. Props: variant="button".

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

<template>
  <VFileUpload
    v-model="value"
    accept="image/*,.pdf"
    :max-size="10485760"
    variant="button" />
</template>

Compact List

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

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

const files = ref([])
</script>

<template>
  <VFileUpload v-model="files" variant="compact" :multiple="false" />
</template>

Image Upload

Variação Imagem Upload. Props: variant="image", accept="image/*", multiple=true.

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

<template>
  <VFileUpload
    v-model="value"
    accept="image/*"
    :max-size="10485760"
    variant="image" />
</template>

Sizes

Variação Tamanhos.

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

<template>
  <div style="display:flex;flex-direction:column;gap:16px;">
    <VFileUpload variant="button" size="sm" />
    <VFileUpload variant="button" size="md" />
    <VFileUpload variant="button" size="lg" />
  </div>
</template>

Disabled

Variação Desabilitado. Props: disabled=true.

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

<template>
  <VFileUpload
    v-model="value"
    accept="image/*,.pdf"
    :max-size="10485760"
    disabled />
</template>

Custom Texts

Variação Personalizado Texts. Props: variant="dropzone", label="Anexos", helperText="PNG ou PDF até 5 MB", dropzoneTitle="Solte seus arquivos aqui", dropzoneHint="ou clique para escolher".

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

<template>
  <VFileUpload
    v-model="value"
    accept="image/*,.pdf"
    :max-size="10485760"
    label="Anexos"
    helper-text="PNG ou PDF até 5 MB"
    dropzone-title="Solte seus arquivos aqui"
    dropzone-hint="ou clique para escolher"
    button-label="Escolher arquivos" />
</template>

Auto Upload Simulated

Variação Auto Upload Simulated. Props: variant="dropzone", autoUpload=true, simulateUpload=true, multiple=true.

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

<template>
  <VFileUpload v-model="value" accept="image/*,.pdf" :max-size="10485760" />
</template>

Acessibilidade

Lista "Accessibility — Built with accessibility in mind" (6 itens):

  • ARIA compliant (aria-labels, aria-describedby).
  • Keyboard navigation (Tab, Enter, Space).
  • Screen reader friendly.
  • Clear error messages.
  • Focus visible.
  • Supports multiple files and status announcements.
  • Erros com ícone + texto explícito ("File type not supported"), nunca só cor; foco visível na dropzone/botão.

Props

PropTipoDefaultDescrição
modelValueFile[][]—
variantVFileUploadVariant"dropzone"—
sizeVFileUploadSize"md"—
acceptstring——
multiplebooleantrue—
disabledbooleanfalse—
maxSizenumber——
helperTextstring——
labelstring——
buttonLabelstring——
dropzoneTitlestring——
dropzoneHintstring——
autoUploadbooleantrue—
simulateUploadbooleantrue—

Events

EventoPayloadDescrição
@update:modelValuevalue: File[]—
@changevalue: File[]—
@uploaditem: import('./VFileUpload.types').VFileUploadFile—
@errorpayload: { file: File; message: string }—
@removefile: File—

Slots

SlotProps do slot
#icon—
#default—

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