<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>
View API Reference →
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.

FeaturePublicAuthenticatedSensitiveCritical
MIME type validationYesYesYesYes
Magic number verification-YesYesYes
Size enforcementYesYesYesYes
Scan hook integration--YesYes
Audit logging-YesYesYes

Theming

Secure-UI uses CSS custom properties. Override at :root, per-component, or per-instance.

VariableDefaultDescription
--secure-ui-upload-border-styledashedDrop zone border style
--secure-ui-upload-border-width2pxDrop zone border width
--secure-ui-upload-padding2remDrop zone inner padding
--secure-ui-upload-border-radius8pxDrop 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>
}