<secure-file-upload>
A file upload component that validates MIME types against declared accept lists, verifies magic numbers in the file header, enforces size limits, and provides hooks for server-side scanning integration. All validation runs before the file is transmitted.
<script type="module"
src="/components/secure-file-upload/secure-file-upload.js">
</script>Live Demo
Configurations
security-tier="public"
<secure-file-upload
label="Public upload"
name="file"
security-tier="public">
</secure-file-upload>security-tier="authenticated"
<secure-file-upload
security-tier="authenticated"
label="Authenticated upload"
name="file">
</secure-file-upload>security-tier="sensitive"
<secure-file-upload
security-tier="sensitive"
label="Sensitive upload"
name="file">
</secure-file-upload>security-tier="critical"
<secure-file-upload
security-tier="critical"
label="Critical upload"
name="file">
</secure-file-upload>accept images
<secure-file-upload
label="Images only"
name="image"
accept="image/*"
security-tier="public">
</secure-file-upload>accept documents
<secure-file-upload
label="Documents"
name="document"
accept=".pdf,.doc,.docx"
security-tier="sensitive">
</secure-file-upload>multiple
<secure-file-upload
label="Multiple files"
name="files"
multiple
security-tier="public">
</secure-file-upload>max-size
<!-- max-size in bytes (2MB = 2097152) -->
<secure-file-upload
label="Max 2MB"
name="file"
max-size="2097152"
security-tier="public">
</secure-file-upload>required
<secure-file-upload
label="Required upload"
name="file"
required
security-tier="public">
</secure-file-upload>Security Features
Security is enforced server-side. These features are client-side complements.
| Feature | Public | Authenticated | Sensitive | Critical |
|---|---|---|---|---|
| MIME type validation | Yes | Yes | Yes | Yes |
| Magic number verification | - | Yes | Yes | Yes |
| Size enforcement | Yes | Yes | Yes | Yes |
| Scan hook integration | - | - | Yes | Yes |
| Audit logging | - | Yes | Yes | Yes |
Theming
Secure-UI uses CSS custom properties. Override at :root, per-component, or per-instance.
| Variable | Default | Description |
|---|---|---|
| --secure-ui-upload-border-style | dashed | Drop zone border style |
| --secure-ui-upload-border-width | 2px | Drop zone border width |
| --secure-ui-upload-padding | 2rem | Drop zone inner padding |
| --secure-ui-upload-border-radius | 8px | Drop zone corner radius |
Themed Example
secure-file-upload {
--secure-ui-upload-border-style: solid;
--secure-ui-upload-border-width: 1px;
--secure-ui-upload-border-radius: 16px;
--secure-ui-upload-padding: 3rem;
}Framework Examples
Web Components work natively in all frameworks. No wrappers, no adapters.
Plain HTML html
<script type="module"
src="/components/secure-file-upload/secure-file-upload.js">
</script>
<secure-file-upload
label="Upload Document"
name="document"
accept=".pdf,.doc,.docx"
max-size="10485760"
security-tier="sensitive"
required>
</secure-file-upload>React (JSX) tsx
import { useEffect } from 'react';
export function DocumentUpload() {
useEffect(() => {
import('/components/secure-file-upload/secure-file-upload.js');
}, []);
return (
<secure-file-upload
label="Upload Document"
name="document"
accept=".pdf,.doc,.docx"
max-size="10485760"
security-tier="sensitive"
required
/>
);
}Vue 3 vue
<template>
<secure-file-upload
label="Upload Document"
name="document"
accept=".pdf,.doc,.docx"
max-size="10485760"
security-tier="sensitive"
required>
</secure-file-upload>
</template>
<script setup>
import { onMounted } from 'vue';
onMounted(() =>
import('/components/secure-file-upload/secure-file-upload.js')
);
</script>Angular typescript
import { Component, CUSTOM_ELEMENTS_SCHEMA, OnInit } from '@angular/core';
@Component({
selector: 'app-document-upload',
template: `
<secure-file-upload
label="Upload Document"
name="document"
accept=".pdf,.doc,.docx"
max-size="10485760"
security-tier="sensitive"
required>
</secure-file-upload>
`,
schemas: [CUSTOM_ELEMENTS_SCHEMA],
})
export class DocumentUploadComponent implements OnInit {
ngOnInit() {
import('/components/secure-file-upload/secure-file-upload.js');
}
}Svelte svelte
<script>
import { onMount } from 'svelte';
onMount(() =>
import('/components/secure-file-upload/secure-file-upload.js')
);
</script>
<secure-file-upload
label="Upload Document"
name="document"
accept=".pdf,.doc,.docx"
max-size="10485760"
security-tier="sensitive"
required>
</secure-file-upload>Go / Templ templ
templ DocumentUpload(maxSize string) {
<secure-file-upload
label="Upload Document"
name="document"
accept=".pdf,.doc,.docx"
max-size={ maxSize }
security-tier="sensitive"
required>
</secure-file-upload>
}