File Upload

Preview

<esa-file-upload label="Upload a document"></esa-file-upload>

import { Component, CUSTOM_ELEMENTS_SCHEMA } from '@angular/core';
import '@esa/ecology/esa-file-upload';

@Component({
  selector: 'app-file-upload-demo',
  standalone: true,
  schemas: [CUSTOM_ELEMENTS_SCHEMA],
  template: `
    <esa-file-upload label="Upload a document"></esa-file-upload>
  `,
})
export class FileUploadDemo {}

States

Allow multiple files with multiple + accept, cap each file with max-size-mb, or disable the zone entirely.

<esa-file-upload label="Upload images" multiple accept="image/*"></esa-file-upload>
<esa-file-upload label="Max 2 MB" max-size-mb="2"></esa-file-upload>
<esa-file-upload label="Upload disabled" disabled></esa-file-upload>

import { Component, CUSTOM_ELEMENTS_SCHEMA } from '@angular/core';
import '@esa/ecology/esa-file-upload';

@Component({
  selector: 'app-file-upload-demo',
  standalone: true,
  schemas: [CUSTOM_ELEMENTS_SCHEMA],
  template: `
    <esa-file-upload label="Upload images" multiple accept="image/*"></esa-file-upload>
    <esa-file-upload label="Max 2 MB" max-size-mb="2"></esa-file-upload>
    <esa-file-upload label="Upload disabled" disabled></esa-file-upload>
  `,
})
export class FileUploadDemo {}

API

Events

Accessibility

• The drop zone is keyboard-focusable; Enter or Space opens the native file picker.
• Drag-over highlights the zone; drop adds the dragged files.
• Oversized files are rejected with an inline error message rather than failing silently.
• Form-associated via ElementInternals — selected files are set as a FormData payload (default name files) so they submit with the enclosing form.

Theming surface

Every public token this component reads, extracted from its source at build time, split by blast radius: the hooks that belong to this component, then the shared and system tokens it consumes alongside everything else. The Resolves to column walks each token's real lineage — component → semantic → primitive → raw value — so you can see exactly where re-pointing it lands. A spoke re-skins by overriding these in its theme-<slug>.css; component internals are never edited. No hook for what you need? File it with /request-lego.

Type roles it names

This component does not set a size, weight, face or tracking of its own — it names a composite, and the composite carries all five. A composite is a class rather than a token, so none of it appears in the tables below; re-theme text by re-pointing the token family, not by editing the component.

Wired to this component

None. This component has no hooks of its own — it themes entirely through the shared tokens below, so every override here also moves its siblings.

Shared tokens it reads

Owned by a family or by the semantic layer. Still overridable — but scope the override (esa-foo { --form-border-color: … }) unless you mean to move everything that reads it. Reach says what else that is.