Ir para o conteúdo
uiify

File upload

Área para soltar arquivos + lista de arquivos.

Navegadores
Chrome 123+Firefox 121+Safari 17.5+
Nível
1
Tamanho compactado
2.27 kB
Limite de layout forçado
0 ms
Limite do axe
0
Compatível com SSR
Sim
Contrato publicado
Ambiente de teste

Experimentar

File upload

Attachments

Drop files here, or choose files above.

    Up to 3 files · 5 MB each

    API

    FileUpload.Root

    PropTipoPadrãoDescrição
    childrenReactNode—Partes de upload de arquivos: input oculto, acionador, área para soltar e lista.
    valuereadonly File[]—Arquivos atuais, tornando o componente controlado.
    defaultValuereadonly File[][]Arquivos iniciais do componente não controlado.
    onValueChange(files: File[]) => void—Chamado com os arquivos aceitos sempre que a seleção muda.
    onReject(rejections: FileRejection[]) => void—Chamado com os arquivos que não passaram na validação e o motivo.
    acceptstring[][]Tipos de arquivo aceitos, como extensões ou tipos MIME.
    maxFilesnumber—Número máximo de arquivos mantidos ao mesmo tempo.
    maxSizenumber—Maior tamanho de arquivo aceito, em bytes.
    minSizenumber—Menor tamanho de arquivo aceito, em bytes.
    multiplebooleanfalsePermite selecionar mais de um arquivo no seletor.
    disabledbooleanfalseDesabilita o seletor, a área para soltar e os botões de remoção.

    FileUpload.HiddenInput

    PropTipoPadrãoDescrição
    classNamestring—Classe aplicada ao input de arquivo nativo.

    FileUpload.Trigger

    PropTipoPadrãoDescrição
    childrenReactNode—Conteúdo do controle que abre o seletor de arquivos.
    classNamestring—Classe aplicada ao elemento acionador.
    renderReactElement | ((props, state) => ReactElement)—Substitua o elemento renderizado preservando comportamento e conexões de acessibilidade.

    FileUpload.Dropzone

    PropTipoPadrãoDescrição
    childrenReactNode—Conteúdo da área de destino para soltar arquivos.
    classNamestring—Classe aplicada ao elemento da área para soltar arquivos.
    renderReactElement | ((props, state) => ReactElement)—Substitua o elemento renderizado preservando comportamento e conexões de acessibilidade.

    FileUpload.List

    PropTipoPadrãoDescrição
    childrenReactNode | ((files: readonly File[]) => ReactNode)—Renderize os arquivos aceitos a partir da lista atual. Alterações de valor controlado e redefinições externas são refletidas imediatamente.
    classNamestring—Classe aplicada ao elemento de lista.

    FileUpload.Item

    PropTipoPadrãoDescrição
    childrenReactNode—Conteúdo que descreve o arquivo, como nome e tamanho.
    classNamestring—Classe aplicada ao elemento de item.
    index*number—Posição do arquivo representado por este item.
    renderReactElement | ((props, state) => ReactElement)—Substitua o elemento renderizado preservando comportamento e conexões de acessibilidade.

    FileUpload.ItemRemove

    PropTipoPadrãoDescrição
    classNamestring—Classe aplicada ao botão de remoção.
    index*number—Posição do arquivo removido por este botão.

    FileRejection

    PropTipoPadrãoDescrição
    file*File—O arquivo que não foi aceito.
    reason*"accept" | "max-size" | "max-files"—A regra que o arquivo não atendeu.

    Teclado

    TeclaAção
    Enter / SpaceAbra o seletor de arquivos por Trigger ou remova um arquivo em foco
    TabMova o foco entre o acionador do seletor e os controles de remoção de arquivos

    Acessibilidade

    Dê um rótulo acessível a HiddenInput. List recebe os arquivos aceitos e renderiza nomes, tamanhos e botões de remoção com rótulos. Root permite valor controlado por value, maxFiles cumulativo e validação de maxSize e accept; onReject informa arquivos rejeitados. Raízes desabilitadas bloqueiam o seletor, a soltura e a remoção. O tratamento de arquivos exige hidratação.

    Pontos de integração de estilos

    data-uiify-file-uploaddata-partdata-disableddata-state
    Esta página foi traduzida automaticamente e ainda não foi revisada.