egutierrez
47fac22230
- .claude/CLAUDE.md - .claude/commands/subagentes.md - .claude/rules/INDEX.md - .mcp.json - bash/functions/cybersecurity/analyze_dns.md - bash/functions/cybersecurity/audit_http_headers.md - bash/functions/cybersecurity/audit_ssh_config.md - bash/functions/cybersecurity/check_firewall.md - bash/functions/cybersecurity/detect_suspicious_users.md - bash/functions/cybersecurity/encrypt_file.md - ... Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
119 lines
3.7 KiB
Markdown
119 lines
3.7 KiB
Markdown
---
|
|
name: dropzone
|
|
kind: component
|
|
lang: ts
|
|
domain: ui
|
|
version: "1.0.0"
|
|
purity: impure
|
|
signature: "Dropzone(props: DropzoneProps): JSX.Element"
|
|
description: "Zona de drag-and-drop para archivos con estados idle/accept/reject, límite de tamaño y tipos MIME. Wrapper sobre Mantine Dropzone."
|
|
tags: [dropzone, upload, drag-drop, file, component, ui, interactive, mantine, pendiente-usar]
|
|
uses_functions: []
|
|
uses_types: []
|
|
returns: []
|
|
returns_optional: false
|
|
error_type: ""
|
|
imports: ["@mantine/dropzone"]
|
|
output: "Componente Dropzone que renderiza área de arrastrar y soltar archivos con feedback visual"
|
|
tested: false
|
|
tests: []
|
|
test_file_path: ""
|
|
file_path: "frontend/functions/ui/dropzone.tsx"
|
|
props:
|
|
- name: onDrop
|
|
type: "(files: File[]) => void"
|
|
required: false
|
|
description: "Callback ejecutado cuando el usuario suelta archivos aceptados"
|
|
- name: onReject
|
|
type: "(files: FileRejection[]) => void"
|
|
required: false
|
|
description: "Callback ejecutado cuando el usuario suelta archivos rechazados (tipo o tamaño inválido)"
|
|
- name: accept
|
|
type: "Record<string, string[]>"
|
|
required: false
|
|
description: "Tipos MIME aceptados. Usar IMAGE_MIME_TYPE o MIME_TYPES para constantes predefinidas"
|
|
- name: maxSize
|
|
type: "number"
|
|
required: false
|
|
description: "Tamaño máximo de archivo en bytes"
|
|
- name: multiple
|
|
type: "boolean"
|
|
required: false
|
|
description: "Permite seleccionar múltiples archivos a la vez"
|
|
- name: loading
|
|
type: "boolean"
|
|
required: false
|
|
description: "Muestra estado de carga y desactiva la interacción"
|
|
- name: disabled
|
|
type: "boolean"
|
|
required: false
|
|
description: "Desactiva el dropzone"
|
|
- name: children
|
|
type: "React.ReactNode"
|
|
required: true
|
|
description: "Contenido interno, generalmente compuesto con DropzoneAccept, DropzoneReject y DropzoneIdle"
|
|
emits: [onDrop, onReject]
|
|
has_state: true
|
|
framework: react
|
|
variant: []
|
|
---
|
|
|
|
## Ejemplo
|
|
|
|
```tsx
|
|
import {
|
|
Dropzone,
|
|
DropzoneAccept,
|
|
DropzoneReject,
|
|
DropzoneIdle,
|
|
IMAGE_MIME_TYPE,
|
|
} from '@fn_library/dropzone'
|
|
import { IconPhoto, IconUpload, IconX } from '@tabler/icons-react'
|
|
import { Group, Text } from '@mantine/core'
|
|
|
|
function ImageUploader() {
|
|
return (
|
|
<Dropzone
|
|
onDrop={(files) => console.log('Archivos aceptados:', files)}
|
|
onReject={(files) => console.log('Archivos rechazados:', files)}
|
|
accept={IMAGE_MIME_TYPE}
|
|
maxSize={5 * 1024 ** 2}
|
|
>
|
|
<Group justify="center" gap="xl" mih={120} style={{ pointerEvents: 'none' }}>
|
|
<DropzoneAccept>
|
|
<IconUpload size={52} stroke={1.5} />
|
|
</DropzoneAccept>
|
|
<DropzoneReject>
|
|
<IconX size={52} stroke={1.5} />
|
|
</DropzoneReject>
|
|
<DropzoneIdle>
|
|
<IconPhoto size={52} stroke={1.5} />
|
|
</DropzoneIdle>
|
|
<div>
|
|
<Text size="xl" inline>
|
|
Arrastra imágenes aquí o haz clic para seleccionar
|
|
</Text>
|
|
<Text size="sm" c="dimmed" inline mt={7}>
|
|
Máximo 5 MB por imagen
|
|
</Text>
|
|
</div>
|
|
</Group>
|
|
</Dropzone>
|
|
)
|
|
}
|
|
```
|
|
|
|
## Notas
|
|
|
|
El prop `onDrop` tiene un default vacío (`() => {}`) para que el componente sea válido sin handler. Siempre sobreescribirlo en uso real.
|
|
|
|
Sub-componentes exportados:
|
|
- `DropzoneAccept` — visible cuando el archivo arrastrado es aceptado (tipo y tamaño válidos)
|
|
- `DropzoneReject` — visible cuando el archivo es rechazado
|
|
- `DropzoneIdle` — visible en estado de reposo
|
|
- `DropzoneFullScreen` — captura drops en cualquier parte de la pantalla
|
|
|
|
Constantes de tipos MIME exportadas:
|
|
- `IMAGE_MIME_TYPE` — imágenes comunes (png, jpg, gif, webp, etc.)
|
|
- `MIME_TYPES` — objeto con claves por tipo (pdf, csv, xlsx, mp4, etc.)
|