New-UDTextbox

Synopsis

Les zones de texte permettent aux utilisateurs de saisir et de modifier du texte.

Syntaxe

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

Description

Crée une zone de texte. Les zones de texte peuvent être utilisées seules ou à l'intérieur d'un New-UDForm.

Paramètres

-Id

L'ID du composant. Par défaut, il s'agit d'un GUID aléatoire.

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

-Label

Une étiquette à afficher au-dessus de cette zone de texte.

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

-Placeholder

Un texte indicatif à placer dans la zone de texte.

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

-Value

La valeur actuelle de la zone de texte.

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

-Type

Le type de zone de texte. Il peut s'agir de valeurs telles que text, password ou email.

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

-Disabled

Indique si cette zone de texte est désactivée.

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

-Icon

L'icône à afficher à côté de la zone de texte. Utilisez New-UDIcon pour créer une icône.

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

-Autofocus

Indique s'il faut mettre automatiquement le focus sur cette zone de texte.

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

-Multiline

Crée une zone de texte multiligne

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

-Rows

Le nombre de lignes dans une zone de texte multiligne.

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

-RowsMax

Le nombre maximal de lignes dans une zone de texte multiligne.

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

-FullWidth

Indique s'il faut faire en sorte que cette zone de texte occupe toute la largeur du contrôle parent.

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

-Variant

La variante de la zone de texte. Les valeurs valides sont "filled", "outlined", "standard"

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

-ClassName

Une classe CSS à appliquer à la zone de texte.

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

-OnEnter

Un bloc de script qui est appelé lorsque l'utilisateur appuie sur la touche Entrée. La variable $EventData contiendra la valeur actuelle de la zone de texte.

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

-OnBlur

Un bloc de script qui est appelé lorsque l'utilisateur quitte la zone de texte. La variable $EventData contiendra la valeur actuelle de la zone de texte.

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

-Shrink

Indique s'il faut réduire l'étiquette par défaut.

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

-OnValidate

Un bloc de script qui est appelé lorsque l'utilisateur quitte la zone de texte. La variable $EventData contiendra la valeur actuelle de la zone de texte. Si le bloc de script retourne un résultat de validation invalide, celui-ci sera affiché sous la zone de texte.

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

-HelperText

Un texte d'aide à afficher sous la zone de texte.

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

-OnChange

Un bloc de script qui est appelé lorsque l'utilisateur modifie la valeur de la zone de texte. La variable $EventData contiendra la valeur actuelle de la zone de texte.

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

-Minimum

La valeur minimale d'une zone de texte numérique.

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

-Maximum

La valeur maximale d'une zone de texte numérique.

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

-MaximumLength

La longueur maximale du texte dans la zone de texte.

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

-Sx

Une table de hachage de propriétés basées sur le thème à appliquer à la zone de texte.

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

-Style

Une table de hachage de propriétés CSS à appliquer à la zone de texte.

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

-MaskPattern

Un modèle de masque à appliquer à la zone de texte. Il est utilisé pour les masques de saisie. Consultez iMaskjs pour plus d'information.

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

Paramètres communs

Cette applet de commande prend en charge les paramètres communs : Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, PipelineVariable et OutVariable. Pour plus d'information, consultez about_CommonParameters.

Sorties

Exemples

Exemple 1 : Zone de texte de base

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

Crée une zone de texte de base.

Exemple 2 : Zone de texte de mot de passe

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

Crée une zone de texte de mot de passe.

Exemple 3 : Zone de texte de courriel

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

Crée une zone de texte de courriel.

Exemple 4 : Zone de texte désactivée

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

Crée une zone de texte désactivée.

Exemple 5 : Zone de texte avec icône

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

Crée une zone de texte avec une icône.

Exemple 6 : Zone de texte avec focus automatique

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

Crée une zone de texte qui obtiendra automatiquement le focus au chargement de la page.

Exemple 7 : Zone de texte multiligne

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

Crée une zone de texte multiligne.

Exemple 8 : Zone de texte multiligne avec 5 lignes

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

Crée une zone de texte multiligne avec 5 lignes.

Exemple 9 : Variante

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

Crée une zone de texte remplie.

Exemple 10 : OnEnter

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

Crée une zone de texte avec un événement OnEnter.

Exemple 11 : OnBlur

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

Crée une zone de texte avec un événement OnBlur.

Exemple 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'

Crée une zone de texte avec un événement OnValidate.

Exemple 13 : Texte d'aide

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

Crée une zone de texte avec un texte d'aide.

Exemple 14 : OnChange

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

Crée une zone de texte avec un événement OnChange.

Exemple 15 : Minimum et maximum

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

Crée une zone de texte numérique avec une valeur minimale et une valeur maximale.

Exemple 16 : Modèle de masque

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

Crée une zone de texte avec un modèle de masque.