New-UDSelect

Übersicht

Erstellt ein neues Auswahlfeld.

Syntax

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>]

Beschreibung

Erstellt ein neues Auswahlfeld. Auswahlfelder können mehrere Optionen und Optionsgruppen enthalten. Auswahlfelder können auch Mehrfachauswahl unterstützen.

Parameter

-Id

Die ID der Komponente. Standardmäßig ist dies eine zufällige GUID.

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

-Option

Optionen, die in dieses Auswahlfeld aufgenommen werden sollen. Dies kann entweder New-UDSelectOption oder New-UDSelectGroup sein.

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

Die Beschriftung, die mit dem Auswahlfeld angezeigt wird.

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

-OnChange

Ein Skriptblock, der ausgeführt wird, wenn sich das Skript ändert. $EventData ist ein Array der ausgewählten Werte.

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

-DefaultValue

Der standardmäßig ausgewählte Wert.

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

-Disabled

Ob dieses Auswahlfeld deaktiviert ist.

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

-Multiple

Ob Sie mehrere Werte auswählen können.

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

-MaxWidth

Die maximale Breite des Auswahlfelds.

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

-ClassName

Eine CSS-Klasse, die auf das Auswahlfeld angewendet wird.

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

-FullWidth

Das Auswahlfeld auf die volle Breite der übergeordneten Komponente strecken.

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

-OnEnter

Ein Skriptblock, der aufgerufen wird, wenn der Benutzer die Eingabetaste drückt. Die Variable $EventData enthält den aktuellen Wert des Textfelds.

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

-Variant

Die Variante des Auswahlfelds. Kann filled, outlined oder standard sein.

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

-Icon

Das Symbol, das neben dem Textfeld angezeigt wird. Verwenden Sie New-UDIcon, um ein Symbol zu erstellen.

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

-Sx

Eine Hashtable mit Stilen, die auf das Auswahlfeld angewendet werden.

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

-Checkbox

Ob bei Mehrfachauswahl Kontrollkästchen angezeigt werden sollen.

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

Allgemeine Parameter

Dieses Cmdlet unterstützt die allgemeinen Parameter: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, PipelineVariable und OutVariable. Weitere Informationen finden Sie unter about_CommonParameters.

Ausgaben

Beispiele

Beispiel 1: Einfaches Auswahlfeld

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

Ein einfaches Auswahlfeld mit drei Optionen

Beispiel 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

Ein Auswahlfeld mit einem OnChange-Skriptblock, der einen Toast anzeigt, wenn sich der Wert ändert.

Beispiel 3: Deaktiviert

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

Ein deaktiviertes Auswahlfeld.

Beispiel 4: Mehrfachauswahl

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

Ein Auswahlfeld, das mehrere Auswahlen zulässt.

Beispiel 5: Mehrfachauswahl mit Kontrollkästchen

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

Ein Auswahlfeld, das mehrere Auswahlen mit Kontrollkästchen zulässt.

Beispiel 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

Ein Auswahlfeld mit der Variante outlined.

Beispiel 7: Symbol

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)

Ein Auswahlfeld mit einem Symbol.

Beispiel 8: Gruppiert

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

Ein Auswahlfeld mit Optionsgruppen.

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