New-UDSelect

Sinossi

Crea un nuovo select.

Sintassi

New-UDSelect [[-Id] <String>] [[-Option] <ScriptBlock>] [[-Label] <String>] [[-OnChange] <Endpoint>] [[-DefaultValue] <Object>] [-Disabled] [-Multiple] [[-MaxWidth] <String>] [[-ClassName] <String>] [-FullWidth] [[-OnEnter] <Endpoint>] [[-Variant] <String>] [[-Icon] <Object>] [[-Sx] <Hashtable>] [-Checkbox] [<CommonParameters>]

Descrizione

Crea un nuovo select. I select possono avere più opzioni e gruppi di opzioni. I select possono anche essere a selezione multipla.

Parametri

-Id

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

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

-Option

Opzioni da includere in questo select. Può essere New-UDSelectOption o New-UDSelectGroup.

Required?                    false
Position?                    2
Default value                {
                    New-UDSelectOption -Name 'Option 1' -Value 1
                    New-UDSelectOption -Name 'Option 2' -Value 2
                }
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

-Label

L'etichetta da mostrare con il select.

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

-OnChange

Un blocco di script che viene eseguito quando lo script cambia. $EventData sarà un array dei valori selezionati.

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

-DefaultValue

Il valore selezionato predefinito.

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

-Disabled

Se questo select è disabilitato.

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

-Multiple

Se è possibile selezionare più valori.

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

-MaxWidth

La larghezza massima del select.

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

-ClassName

Una classe CSS da applicare al select.

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

-FullWidth

Estende il select alla larghezza completa del componente padre.

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

-OnEnter

Un blocco di script che viene chiamato quando l'utente preme il tasto Invio. La variabile $EventData conterrà il valore corrente della casella di testo.

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

-Variant

La variante del select. Può essere filled, outlined o standard.

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

-Icon

L'icona da mostrare accanto alla casella di testo. Usi New-UDIcon per creare un'icona.

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

-Sx

Una hashtable di stili da applicare al select.

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

-Checkbox

Se visualizzare le caselle di controllo quando si usa la selezione multipla.

Required?                    false
Position?                    named
Default value                False
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: select di base

New-UDSelect -Label 'Select' -Id 'select1' -Option {
   New-UDSelectOption -Name "One" -Value 1
   New-UDSelectOption -Name "Two" -Value 2
   New-UDSelectOption -Name "Three" -Value 3
} -FullWidth

Un select di base con tre opzioni

Esempio 2: OnChange

New-UDSelect -Label 'Select' -Id 'select2' -Option {
   New-UDSelectOption -Name "One" -Value 1
   New-UDSelectOption -Name "Two" -Value 2
   New-UDSelectOption -Name "Three" -Value 3
} -DefaultValue 2 -OnChange {
   Show-UDToast -Message $EventData
} -FullWidth

Un select con un blocco di script OnChange che mostra un toast quando il valore cambia.

Esempio 3: disabilitato

New-UDSelect -Label 'Select' -Id 'select3' -Option {
   New-UDSelectOption -Name "One" -Value 1
   New-UDSelectOption -Name "Two" -Value 2
   New-UDSelectOption -Name "Three" -Value 3
} -Disabled -FullWidth

Un select disabilitato.

Esempio 4: multiplo

New-UDSelect -Label 'Select' -Id 'select4' -Option {
   New-UDSelectOption -Name "One" -Value 1
   New-UDSelectOption -Name "Two" -Value 2
   New-UDSelectOption -Name "Three" -Value 3
} -Multiple -FullWidth

Un select che consente selezioni multiple.

Esempio 5: multiplo con caselle di controllo

New-UDSelect -Label 'Select' -Id 'select4' -Option {
   New-UDSelectOption -Name "One" -Value 1
   New-UDSelectOption -Name "Two" -Value 2
   New-UDSelectOption -Name "Three" -Value 3
} -Multiple -FullWidth -Checkbox

Un select che consente selezioni multiple con caselle di controllo.

Esempio 6: outlined

New-UDSelect -Label 'Select' -Id 'select5' -Option {
   New-UDSelectOption -Name "One" -Value 1
   New-UDSelectOption -Name "Two" -Value 2
   New-UDSelectOption -Name "Three" -Value 3
} -Variant outlined -FullWidth

Un select con variante outlined.

Esempio 7: icona

New-UDSelect -Label 'Select' -Id 'select6' -Option {
   New-UDSelectOption -Name "One" -Value 1
   New-UDSelectOption -Name "Two" -Value 2
   New-UDSelectOption -Name "Three" -Value 3
} -FullWidth -Icon (New-UDIcon -Icon Home)

Un select con un'icona.

Esempio 8: raggruppato

New-UDSelect -Label 'Select' -Id 'select7' -Option {
   New-UDSelectGroup -Name "Category 1" -Option {
       New-UDSelectOption -Name "One" -Value 1
       New-UDSelectOption -Name "Two" -Value 2
   }
   New-UDSelectGroup -Name "Category 2" -Option {
       New-UDSelectOption -Name "Three" -Value 3
       New-UDSelectOption -Name "Four" -Value 4
   }
} -FullWidth

Un select con gruppi di opzioni.

[Component("Select", "ListDropdown", "Creates a new card.")]