New-UDTextbox

Übersicht

Textfelder ermöglichen Benutzern das Eingeben und Bearbeiten von Text.

Syntax

New-UDTextbox [[-Id] <String>] [[-Label] <String>] [[-Placeholder] <String>] [[-Value] <String>] [[-Type] <String>] [-Disabled] [[-Icon] <Object>] [-Autofocus] [-Multiline] [[-Rows] <Int32>] [[-RowsMax] <Int32>] [-FullWidth] [[-Variant] <String>] [[-ClassName] <String>] [[-OnEnter] <Endpoint>] [[-OnBlur] <Endpoint>] [-Shrink] [[-OnValidate] <Endpoint>] [[-HelperText] <String>] [[-OnChange] <Endpoint>] [[-Minimum] <Int32>] [[-Maximum] <Int32>] [[-MaximumLength] <Int32>] [[-Sx] <Hashtable>] [[-Style] <Hashtable>] [[-MaskPattern] <String>] [[-Attributes] <Hashtable>] [<CommonParameters>]

Beschreibung

Erstellt ein Textfeld. Textfelder können eigenständig oder innerhalb eines New-UDForm verwendet werden.

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

-Label

Eine Beschriftung, die über diesem Textfeld angezeigt wird.

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

-Placeholder

Ein Platzhalter, der im Textfeld angezeigt wird.

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

-Value

Der aktuelle Wert des Textfelds.

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

-Type

Der Typ des Textfelds. Dies können Werte wie text, password oder email sein.

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

-Disabled

Ob dieses Textfeld deaktiviert ist.

Required?                    false
Position?                    named
Default value                False
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?                    6
Default value
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

-Autofocus

Ob dieses Textfeld automatisch fokussiert werden soll.

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

-Multiline

Erstellt ein mehrzeiliges Textfeld

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

-Rows

Die Anzahl der Zeilen in einem mehrzeiligen Textfeld.

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

-RowsMax

Die maximale Anzahl der Zeilen in einem mehrzeiligen Textfeld.

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

-FullWidth

Ob dieses Textfeld die gesamte Breite des übergeordneten Steuerelements einnehmen soll.

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

-Variant

Die Variante des Textfelds. Gültige Werte sind "filled", "outlined", "standard"

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

-ClassName

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

Required?                    false
Position?                    10
Default value
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?                    11
Default value
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

-OnBlur

Ein Skriptblock, der aufgerufen wird, wenn der Benutzer das Textfeld verlässt. Die Variable $EventData enthält den aktuellen Wert des Textfelds.

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

-Shrink

Ob die Beschriftung standardmäßig verkleinert werden soll.

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

-OnValidate

Ein Skriptblock, der aufgerufen wird, wenn der Benutzer das Textfeld verlässt. Die Variable $EventData enthält den aktuellen Wert des Textfelds. Wenn der Skriptblock ein Validierungsergebnis zurückgibt, das ungültig ist, wird es unterhalb des Textfelds angezeigt.

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

-HelperText

Ein Hilfetext, der unterhalb des Textfelds angezeigt wird.

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

-OnChange

Ein Skriptblock, der aufgerufen wird, wenn der Benutzer den Wert des Textfelds ändert. Die Variable $EventData enthält den aktuellen Wert des Textfelds.

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

-Minimum

Der Mindestwert für ein Zahlen-Textfeld.

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

-Maximum

Der Höchstwert für ein Zahlen-Textfeld.

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

-MaximumLength

Die maximale Länge des Texts im Textfeld.

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

-Sx

Eine Hashtabelle mit themenbasierten Eigenschaften, die auf das Textfeld angewendet werden.

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

-Style

Eine Hashtabelle mit CSS-Eigenschaften, die auf das Textfeld angewendet werden.

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

-MaskPattern

Ein Maskenmuster, das auf das Textfeld angewendet wird. Dies wird für Eingabemasken verwendet. Weitere Informationen finden Sie unter iMaskjs.

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

-Attributes

Required?                    false
Position?                    22
Default value                @{}
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 Textfeld

New-UDTextbox -Id 'textbox1' -Label 'Name' -Placeholder 'Enter your name' -Value 'John Doe'

Erstellt ein einfaches Textfeld.

Beispiel 2: Passwort-Textfeld

New-UDTextbox -Id 'textbox2' -Label 'Password' -Placeholder 'Enter your password' -Type 'password'

Erstellt ein Passwort-Textfeld.

Beispiel 3: E-Mail-Textfeld

New-UDTextbox -Id 'textbox3' -Label 'Email' -Placeholder 'Enter your email' -Type 'email'

Erstellt ein E-Mail-Textfeld.

Beispiel 4: Deaktiviertes Textfeld

New-UDTextbox -Id 'textbox4' -Disabled -Label 'Disabled' -Placeholder 'Enter your name' -Value 'John Doe'

Erstellt ein deaktiviertes Textfeld.

Beispiel 5: Textfeld mit Symbol

New-UDTextbox -Id 'textbox5' -Label 'Name' -Placeholder 'Enter your name' -Value 'John Doe' -Icon (New-UDIcon -Icon 'User')

Erstellt ein Textfeld mit einem Symbol.

Beispiel 6: Textfeld mit Autofokus

New-UDTextbox -Id 'textbox6' -Label 'Name' -Placeholder 'Enter your name' -Value 'John Doe' -Autofocus

Erstellt ein Textfeld, das beim Laden der Seite automatisch fokussiert wird.

Beispiel 7: Mehrzeiliges Textfeld

New-UDTextbox -Id 'textbox7' -Label 'Name' -Placeholder 'Enter your name' -Value 'John Doe' -Multiline

Erstellt ein mehrzeiliges Textfeld.

Beispiel 8: Mehrzeiliges Textfeld mit 5 Zeilen

New-UDTextbox -Id 'textbox8' -Label 'Name' -Placeholder 'Enter your name' -Value 'John Doe' -Multiline -Rows 5 -RowsMax 10

Erstellt ein mehrzeiliges Textfeld mit 5 Zeilen.

Beispiel 9: Variante

New-UDTextbox -Id 'textbox9' -Variant 'filled' -Label 'Name' -Placeholder 'Enter your name' -Value 'John Doe'

Erstellt ein gefülltes Textfeld.

Beispiel 10: OnEnter

New-UDTextbox -Id 'textbox10' -OnEnter {
   Show-UDToast -Message "You pressed enter!"
} -Label 'Name' -Placeholder 'Enter your name' -Value 'John Doe'

Erstellt ein Textfeld mit einem OnEnter-Ereignis.

Beispiel 11: OnBlur

New-UDTextbox -Id 'textbox11' -OnBlur {
   Show-UDToast -Message "You left the textbox!"
} -Label 'Name' -Placeholder 'Enter your name' -Value 'John Doe'

Erstellt ein Textfeld mit einem OnBlur-Ereignis.

Beispiel 12: OnValidate

New-UDTextbox -Id 'textbox12' -OnValidate {
   if ($EventData -eq 'John Doe') {
       return New-UDValidationResult -Valid
   }
   else {
       return New-UDValidationResult -ValidationError "You must enter John Doe"
   }
} -Label 'Name' -Placeholder 'Enter your name' -Value 'John Doe'

Erstellt ein Textfeld mit einem OnValidate-Ereignis.

Beispiel 13: Hilfetext

New-UDTextbox -Id 'textbox13' -HelperText 'This is a helper text' -Label 'Name' -Placeholder 'Enter your name' -Value 'John Doe'

Erstellt ein Textfeld mit Hilfetext.

Beispiel 14: OnChange

New-UDTextbox -Id 'textbox14' -OnChange {
   Show-UDToast -Message $EventData
} -Label 'Name' -Placeholder 'Enter your name' -Value 'John Doe'

Erstellt ein Textfeld mit einem OnChange-Ereignis.

Beispiel 15: Minimum und Maximum

New-UDTextbox -Id 'textbox15' -Type 'number' -Minimum 1 -Maximum 100

Erstellt ein Zahlen-Textfeld mit einem Mindest- und einem Höchstwert.

Beispiel 16: Maskenmuster

New-UDTextbox -Id 'textbox16' -MaskPattern '[phone]'

Erstellt ein Textfeld mit einem Maskenmuster.