New-UDUpload

Sinossi

Caricare file

Sintassi

New-UDUpload [[-Id] <String>] [[-Accept] <String>] [[-OnUpload] <Endpoint>] [[-Text] <String>] [[-Variant] <String>] [[-Color] <String>] [[-ClassName] <String>] [-HideUploadedFileName] [-ShowLoading] [[-LoadingIndicator] <Object>] [[-LoadingPosition] <String>] [[-Icon] <Object>] [[-IconAlignment] <String>] [<CommonParameters>]

Descrizione

Caricare file. Questo componente funziona con UDForm e UDStepper.

Parametri

-Id

L'ID dell'uploader.

Required?                    false
Position?                    1
Default value                [Guid]::NewGuid()
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

-Accept

Il tipo di file da accettare. Per impostazione predefinita, questo componente accetta tutti i file.

Required?                    false
Position?                    2
Default value                *
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

-OnUpload

Uno script block da eseguire quando viene caricato un file. Questo parametro $body conterrà JSON nel formato seguente:

{ data: 'base64 encoded string of file data', name: 'filename', type: 'type of file, if known' }

$EventData conterrà una classe con le seguenti proprietà:

public string Name { get; set; } public string FileName { get; set; } public DateTime TimeStamp { get; set; } public string ContentType { get; set; } public string Type => ContentType;

Required?                    false
Position?                    3
Default value
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

-Text

Il testo da visualizzare sul pulsante di caricamento.

Required?                    false
Position?                    4
Default value                Upload
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

-Variant

La variante del pulsante. Il valore predefinito è contained. Valori validi: "text", "outlined", "contained"

Required?                    false
Position?                    5
Default value                contained
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

-Color

Il colore del pulsante. Il valore predefinito è 'default'. Valori validi: "default", "primary", "secondary", "inherit"

Required?                    false
Position?                    6
Default value                primary
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

-ClassName

Una classe CSS da applicare al pulsante.

Required?                    false
Position?                    7
Default value
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

-HideUploadedFileName

Nasconde il testo del nome file mostrato dopo il caricamento

Required?                    false
Position?                    named
Default value                False
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

-ShowLoading

Visualizza uno spinner di caricamento mentre è in esecuzione il gestore dell'evento OnClick.

Required?                    false
Position?                    named
Default value                False
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

-LoadingIndicator

Un elemento personalizzato da visualizzare al posto dello spinner integrato per -ShowLoading

Required?                    false
Position?                    8
Default value
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

-LoadingPosition

La posizione dell'indicatore di caricamento. I valori validi sono: 'start', 'end', 'center'

Required?                    false
Position?                    9
Default value                center
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

-Icon

L'icona da mostrare al posto dell'icona predefinita. Usi New-UDIcon per creare un'icona.

Required?                    false
Position?                    10
Default value
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

-IconAlignment

Come allineare l'icona all'interno del pulsante. I valori validi sono: "left", "right"

Required?                    false
Position?                    11
Default value                left
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

Parametri comuni

Questo cmdlet supporta i parametri comuni: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, PipelineVariable e OutVariable. Per maggiori informazioni, consulti about_CommonParameters.

Output

Esempi

Esempio 1: caricamento di base

New-UDUpload -Text "Upload" -OnUpload {
    Show-UDToast $Body
} -Id 'upload1'

Un componente di caricamento di base che mostra un toast quando un file viene caricato.

Esempio 2: nascondere il nome del file

New-UDUpload -Text "Upload" -OnUpload {
    Show-UDToast $Body
} -Id 'upload2' -HideUploadedFileName

Nasconde il testo del nome file mostrato dopo il caricamento.

Esempio 3: icona

New-UDUpload -Text "Upload" -OnUpload {
    Show-UDToast $Body
} -Id 'upload3' -Icon (New-UDIcon -Icon 'Upload')

Componente di caricamento con un'icona al posto dell'icona predefinita.

Esempio 4: allineamento dell'icona

New-UDUpload -Text "Upload" -OnUpload {
    Show-UDToast $Body
} -Id 'upload4' -IconAlignment 'right' -Icon (New-UDIcon -Icon 'Upload')

Componente di caricamento con un'icona sul lato destro del pulsante.

Esempio 5: variante

New-UDUpload -Text "Upload" -OnUpload {
    Show-UDToast $Body
} -Id 'upload5' -Variant 'text'

Componente di caricamento con una variante di testo.

Esempio 6: accept

New-UDUpload -Text "Upload" -OnUpload {
    Show-UDToast $Body
} -Id 'upload6' -Accept ".jpg"

Componente di caricamento che accetta solo file .jpg.