RustStruct

Files

Description

The files uploaded by a multipart/form-data server action, keyed by form field name. Declare a Files parameter on an #[action] to receive them; it is empty for JSON / URL-encoded requests.

Signature

rust

pub struct Files(HashMap<String, Vec<UploadedFile>>);

Examples

A single required file:

rust

#[action]
async fn upload(files: Files) -> Result<(), ActionError> {
    let file = files.get("avatar").ok_or_else(|| ActionError::message("required"))?;
    save(file.filename(), file.bytes()).await;
    Ok(())
}

Multiple files under one field (<input type="file" multiple>):

rust

for photo in files.get_all("photos") {
    store(photo.filename(), photo.bytes()).await;
}