New-UDButton

Übersicht

Schaltflächen ermöglichen es Benutzern, mit einem einzigen Tippen Aktionen auszuführen und Auswahlen zu treffen..

Syntax

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

Beschreibung

Erstellt eine neue Schaltfläche. Schaltflächen ermöglichen es Benutzern, mit einem einzigen Tippen Aktionen auszuführen und Auswahlen zu treffen.

Parameter

-Text

Der Text, der innerhalb der Schaltfläche angezeigt werden soll.

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

-Icon

Ein Symbol, das innerhalb der Schaltfläche angezeigt werden soll. Verwenden Sie New-UDIcon, um ein Symbol für diesen Parameter zu erstellen.

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

-Variant

Der Variantentyp für diese Schaltfläche. Gültige Werte sind: "text", "outlined", "contained"

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

-IconAlignment

Wie das Symbol innerhalb der Schaltfläche ausgerichtet wird. Gültige Werte sind: "left", "right"

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

-FullWidth

Ob die Schaltfläche die gesamte Breite ihres Containers einnimmt.

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

-OnClick

Die Aktion, die beim Klicken auf die Schaltfläche ausgeführt wird.

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

-Size

Die Größe der Schaltfläche. Gültige Werte sind: "small", "medium", "large"

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

-Style

Stile, die auf die Schaltfläche angewendet werden.

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

-Href

Eine URL, zu der der Benutzer beim Klicken auf die Schaltfläche weitergeleitet werden soll.

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

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

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

-Color

Die Farbe der Komponente. Gültige Werte sind: '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

Ob die Schaltfläche deaktiviert ist.

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

-ClassName

Die CSS-Klasse, die auf die Schaltfläche angewendet wird.

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

-ShowLoading

Zeigt einen Lade-Spinner an, während der OnClick-Ereignishandler ausgeführt wird.

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

-LoadingIndicator

Ein benutzerdefiniertes Element, das anstelle des integrierten Spinners für -ShowLoading angezeigt wird

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

-LoadingPosition

Die Position der Ladeanzeige. Gültige Werte sind: 'start', 'end', 'center'

Required?                    false
Position?                    named
Default value                center
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: Einfache Schaltflächen

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 bietet drei Varianten: text, contained und outlined.

Beispiel 2: Klicks verarbeiten

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

PowerShell, das beim Klicken auf die Schaltfläche ausgeführt wird.

Beispiel 3: Farbe

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

Passen Sie die Schaltflächenfarbe mit -Color an

Beispiel 4: Größen

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

Für größere oder kleinere Schaltflächen verwenden Sie den Parameter -Size.

Beispiel 5: Symbol

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

Ein Symbol innerhalb der Schaltfläche anzeigen

Beispiel 6: Laden

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

Zeigt eine Ladeanzeige an, während der OnClick-Ereignishandler ausgeführt wird.