FileUpload

The form field name the files post under. On static pages, name the page property the same (or use [SupplyParameterFromForm(Name = "...")]).

The visible label.

Hides the label but keeps it for screen readers.

Help text under the zone.

Whether a file must be chosen before the form posts.

Disables the picker.

The file types to offer, as the accept attribute: "image/*", ".pdf,.docx". A hint for the picker only; check types on the server too.

Allows choosing several files.

The largest file allowed, in bytes. With JavaScript, larger files are flagged before the form posts. Always check on the server too, and set the server's request size limit to match.

On interactive pages, the most files OnChange receives; extra ones are left out. Defaults to 10.

The message for a file over MaxFileSize: {0} is its name, {1} the limit.

The message for a chosen or dropped file that doesn't match Accept: {0} is its name. (The picker's "All files" option and drops both get past the type filter.)

The link that opens the picker. Defaults to "Choose a file" ("Choose files" with Multiple).

The text after the link. Defaults to "or drag it here" ("or drag them here" with Multiple). Not shown on touch screens, where dragging isn't an option.

Small text under the prompt. Defaults to the types and size allowed, from Accept and MaxFileSize: "PNG or JPG · up to 2 MB". An empty string shows none. With JavaScript, the chosen file's name and size take its place.

The zone's icon. Defaults to an arrow out of a tray.

Validation messages to show under the zone, such as from server checks.

Margin on all sides, in spacing steps (-16 to 16; one step = 4px).

Horizontal margin. When set, replaces Margin on this axis.

Vertical margin. When set, replaces Margin on this axis.

Top margin. When set, replaces MarginY and Margin on this side.

Bottom margin. When set, replaces MarginY and Margin on this side.

Margin at the start (left in left-to-right text, right in right-to-left). Replaces MarginX and Margin on this side.

Margin at the end (right in left-to-right text, left in right-to-left). Replaces MarginX and Margin on this side.

Width.

Minimum width.

Maximum width.

Whether to grow into free space inside a Stack, Row or Column: <Box Grow>.

Whether to shrink when space is short inside a Stack, Row or Column. Defaults to true; Shrink="false" keeps the size.

Starting size inside a Stack, before growing or shrinking.

Alignment across the parent's direction, overriding the parent's Align for this component only, such as a button lined up with the bottom of labeled fields in a Row.

How many columns it spans in a Form or Fieldset with Columns, or a Grid; GridSpan.Full for the whole row. Never more than the columns shown, so a form that narrows to one column needs no breakpoints.

Starts a new row in a Form or Fieldset with Columns, or a Grid, leaving the rest of the row before it empty.

Extra CSS classes, merged after the component's own classes.

Inline style, appended after the component's generated custom properties.

Hides the component from this breakpoint up, such as a menu button only phones need.

Shows the component only from this breakpoint up, such as header links for wide screens.

On interactive pages, runs with the chosen files, leaving out any over MaxFileSize (the zone flags those). Read one with OpenReadStream(MaxFileSize): its default limit is 500 KB.