New-UDButton

Sinossi

I pulsanti consentono agli utenti di eseguire azioni e fare scelte con un solo tocco..

Sintassi

New-UDButton [[-Text] <String>] [[-Icon] <Object>] [[-Variant] <String>] [[-IconAlignment] <String>] [[-FullWidth]] [[-OnClick] <Endpoint>] [[-Size] <String>] [[-Style] <Hashtable>] [[-Href] <String>] [-Target <String>] [-Id <String>] [-Color <String>] [-Disabled] [-ClassName <String>] [-ShowLoading] [-LoadingIndicator <Object>] [-LoadingPosition <String>] [<CommonParameters>]

Descrizione

Crea un nuovo pulsante. I pulsanti consentono agli utenti di eseguire azioni e fare scelte con un solo tocco.

Parametri

-Text

Il testo da mostrare all'interno del pulsante.

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

-Icon

Un'icona da mostrare all'interno del pulsante. Usi New-UDIcon per creare un'icona per questo parametro.

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

-Variant

Il tipo di variante per questo pulsante. I valori validi sono: "text", "outlined", "contained"

Required?                    false
Position?                    3
Default value                contained
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?                    4
Default value                left
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

-FullWidth

Indica se il pulsante occupa l'intera larghezza del suo contenitore.

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

-OnClick

L'azione da eseguire quando si fa clic sul pulsante.

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

-Size

La dimensione del pulsante. I valori validi sono: "small", "medium", "large"

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

-Style

Stili da applicare al pulsante.

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

-Href

Un URL a cui l'utente deve essere reindirizzato quando fa clic sul pulsante.

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

-Target

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

-Id

L'ID del componente. Per impostazione predefinita è un GUID casuale.

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

-Color

Il colore del componente. I valori validi sono: 'default', 'inherit', 'primary', 'secondary', 'info', 'warning', 'error', 'success'

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

-Disabled

Indica se il pulsante è disabilitato.

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

-ClassName

La classe CSS da applicare al pulsante.

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

-ShowLoading

Visualizza un indicatore di caricamento mentre il gestore dell'evento OnClick è in esecuzione.

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

-LoadingIndicator

Un elemento personalizzato da visualizzare al posto dell'indicatore integrato per -ShowLoading

Required?                    false
Position?                    named
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?                    named
Default value                center
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, veda about_CommonParameters.

Output

Esempi

Esempio 1: pulsanti di base

New-UDButton -Variant 'text' -Text 'Text' -Id 'button1'
New-UDButton -Variant 'contained' -Text 'Contained'  -Id 'button2'
New-UDButton -Variant 'outlined' -Text 'Outlined' -Id 'button3'

UDButton è disponibile in tre varianti: text, contained e outlined.

Esempio 2: gestione dei clic

New-UDButton -Text 'Click me' -OnClick {
  Show-UDToast -Message 'Hello, world!'
} -Id 'button4'

PowerShell eseguito quando si fa clic sul pulsante.

Esempio 3: colore

New-UDButton -Text 'Secondary' -Color secondary -Id 'button5'
New-UDButton -Text 'Success' -Color success -Id 'button6'
New-UDButton -Text 'Error' -Color error -Id 'button7'

Regoli il colore del pulsante con -Color

Esempio 4: dimensioni

New-UDButton -Variant 'text' -Text 'small' -Id 'button8' -Size small
New-UDButton -Variant 'text' -Text 'medium'  -Id 'button9' -Size medium
New-UDButton -Variant 'text' -Text 'large' -Id 'button10' -Size large
New-UDButton -Variant 'contained' -Text 'small' -Id 'button11'  -Size small
New-UDButton -Variant 'contained' -Text 'medium'  -Id 'button12'  -Size medium
New-UDButton -Variant 'contained' -Text 'large' -Id 'button13'  -Size large
New-UDButton -Variant 'outlined' -Text 'small' -Id 'button14'  -Size small
New-UDButton -Variant 'outlined' -Text 'medium'  -Id 'button15'  -Size medium
New-UDButton -Variant 'outlined' -Text 'large' -Id 'button16'  -Size large

Per pulsanti più grandi o più piccoli, usi il parametro -Size.

Esempio 5: icona

New-UDButton -Icon (New-UDIcon -Icon 'User') -Text 'View User' -Id 'button17'

Visualizzare un'icona all'interno del pulsante

Esempio 6: caricamento

New-UDButton -OnClick { Start-Sleep 3 } -ShowLoading -Text 'Load Data' -Id 'button18'

Mostra un indicatore di caricamento mentre il gestore dell'evento OnClick è in esecuzione.