Skip to main content

Input File

scoped

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

Basic use

This example shows the file input in its default state as the simplest possible file selection control.

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.