Formulários
VFileUpload
Upload de arquivos com dropzone, validação, progresso e lista de arquivos.
<script setup lang="ts">
import { VFileUpload } 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 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
<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
<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
<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
<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
<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
<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
<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
<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
| Prop | Tipo | Default | Descrição |
|---|---|---|---|
modelValue | File[] | [] | — |
variant | VFileUploadVariant | "dropzone" | — |
size | VFileUploadSize | "md" | — |
accept | string | — | — |
multiple | boolean | true | — |
disabled | boolean | false | — |
maxSize | number | — | — |
helperText | string | — | — |
label | string | — | — |
buttonLabel | string | — | — |
dropzoneTitle | string | — | — |
dropzoneHint | string | — | — |
autoUpload | boolean | true | — |
simulateUpload | boolean | true | — |
Events
| Evento | Payload | Descrição |
|---|---|---|
@update:modelValue | value: File[] | — |
@change | value: File[] | — |
@upload | item: import('./VFileUpload.types').VFileUploadFile | — |
@error | payload: { file: File; message: string } | — |
@remove | file: File | — |
Slots
| Slot | Props do slot |
|---|---|
#icon | — |
#default | — |
Fonte: src/components/form/VFileUpload/VFileUpload.vue · tipos: src/components/form/VFileUpload/VFileUpload.types.ts