spark/com.adevinta.spark.components.fileupload/FileUpload/ButtonSingleSelect

ButtonSingleSelect

fun ButtonSingleSelect(onResult: (UploadedFile?) -> Unit, label: String, modifier: Modifier = Modifier, size: ButtonSize = ButtonSize.Medium, icon: SparkIcon? = null, iconSide: IconSide = IconSide.START, type: FileUploadType = FileUploadType.File(), title: String? = null, directory: PlatformFile? = null, dialogSettings: FileKitDialogSettings = FileKitDialogSettings.createDefault(), enabled: Boolean = true, onClickLabel: String? = null, buttonContent: @Composable (onClick: () -> Unit) -> Unit = { onClick -> ButtonFilled( modifier = Modifier .fillMaxWidth() .ifNotNull(onClickLabel) { semantics { onClick(label = onClickLabel, action = null) } }, onClick = onClick, text = label, intent = ButtonIntent.Support, enabled = enabled, ) })(source)

High level file upload component for single file selection.

This component provides a button to trigger file selection. To display selected files, manage state yourself and use PreviewFile or FileUploadList.

Parameters

onResult

Callback invoked when a file is selected or cleared (null)

label

Text label for the default button

modifier

Modifier to be applied to the button

size

The size of the button. Only applies when using the default buttonContent.

icon

The optional icon to be displayed at the start or the end of the button container. Only applies when using the default buttonContent.

iconSide

If an icon is added, you can configure the side where is should be displayed, at the start or end of the button. Only applies when using the default buttonContent.

type

Type of files to select (image, video, file, etc.)

title

Optional title for the file picker dialog

Samples

var selectedFile by rememberSaveable { mutableStateOf<UploadedFile?>(null) }

Column(modifier = Modifier.fillMaxWidth()) {
    FileUpload.ButtonSingleSelect(
        onResult = { file -> selectedFile = file },
        label = "Select a file",
        modifier = Modifier.fillMaxWidth(),
    )

    VerticalSpacer(16.dp)

    selectedFile?.let { file ->
        PreviewFile(
            file = file,
            onClear = { selectedFile = null },
            modifier = Modifier.fillMaxWidth(),
            onClick = { FileUploadDefaults.openFile(file) },
        )
    }
}

var selectedFile by rememberSaveable { mutableStateOf<UploadedFile?>(null) }

Column(modifier = Modifier.fillMaxWidth()) {
    FileUpload.ButtonSingleSelect(
        onResult = { file -> selectedFile = file },
        label = "Select file",
        modifier = Modifier.fillMaxWidth(),
        buttonContent = { onClick ->
            ButtonTinted(
                onClick = onClick,
                text = "Upload with Tinted Button",
                icon = LeboncoinIcons.ImageOutline,
                iconSide = IconSide.START,
            )
        },
    )

    VerticalSpacer(16.dp)

    selectedFile?.let { file ->
        PreviewFile(
            file = file,
            onClear = { selectedFile = null },
            modifier = Modifier.fillMaxWidth(),
        )
    }
}