Skip to main content

Input File

scoped

The Input File element extends the Input element with the ability to upload files.

Basic use

When to use

Use wje-input-file when users need to enter values, choose options, or trigger form-related actions.

When not to use

Do not use it as a decorative element without interaction. Prefer presentational components in that case.

Accessibility

Always provide a label (label/aria-label), keep keyboard support, and surface clear validation feedback.

Best Practices

  • Keep validation rules and error behavior consistent across the entire form.
  • Show loading or disabled states during async operations.
  • Split complex forms into smaller sections with immediate feedback.

Attributes and Properties

No properties available for this component.

Events

NameDescription
wje-input-file:changeEvent fired when the file input changes.

Methods

No public methods available for this component.

CSS Shadow Parts

NameDescription
nativeThe native file input wrapper.
inputThe text input.
file-inputThe file input element.

CSS Custom Properties

No CSS custom properties available for this component.

Slots

No slots available for this component.