New-UDTextbox

Sinossi

Le caselle di testo consentono agli utenti di inserire e modificare testo.

Sintassi

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

Descrizione

Crea una casella di testo. Le caselle di testo possono essere utilizzate da sole o all'interno di un New-UDForm.

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

-Label

Un'etichetta da mostrare sopra questa casella di testo.

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

-Placeholder

Un segnaposto da inserire all'interno della casella di testo.

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

-Value

Il valore corrente della casella di testo.

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

-Type

Il tipo di casella di testo. Può assumere valori come text, password o email.

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

-Disabled

Indica se questa casella di testo è disabilitata.

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

-Icon

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

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

-Autofocus

Indica se applicare l'autofocus a questa casella di testo.

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

-Multiline

Crea una casella di testo multiriga

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

-Rows

Il numero di righe in una casella di testo multiriga.

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

-RowsMax

Il numero massimo di righe in una casella di testo multiriga.

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

-FullWidth

Indica se questa casella di testo deve occupare l'intera larghezza del controllo padre.

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

-Variant

La variante della casella di testo. I valori validi sono "filled", "outlined", "standard"

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

-ClassName

Una classe CSS da applicare alla casella di testo.

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

-OnBlur

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

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

-Shrink

Indica se ridurre l'etichetta per impostazione predefinita.

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

-OnValidate

Un blocco di script che viene chiamato quando l'utente esce dalla casella di testo. La variabile $EventData conterrà il valore corrente della casella di testo. Se il blocco di script restituisce un risultato di convalida non valido, questo verrà visualizzato sotto la casella di testo.

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

-HelperText

Un testo di aiuto da mostrare sotto la casella di testo.

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

-OnChange

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

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

-Minimum

Il valore minimo per una casella di testo numerica.

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

-Maximum

Il valore massimo per una casella di testo numerica.

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

-MaximumLength

La lunghezza massima del testo nella casella di testo.

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

-Sx

Una hashtable di proprietà basate sul tema da applicare alla casella di testo.

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

-Style

Una hashtable di proprietà CSS da applicare alla casella di testo.

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

-MaskPattern

Un modello di maschera da applicare alla casella di testo. Viene utilizzato per le maschere di input. Consulti iMaskjs per maggiori informazioni.

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

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: casella di testo di base

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

Crea una casella di testo di base.

Esempio 2: casella di testo per password

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

Crea una casella di testo per password.

Esempio 3: casella di testo per email

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

Crea una casella di testo per email.

Esempio 4: casella di testo disabilitata

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

Crea una casella di testo disabilitata.

Esempio 5: casella di testo con icona

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

Crea una casella di testo con un'icona.

Esempio 6: casella di testo con autofocus

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

Crea una casella di testo che riceverà l'autofocus al caricamento della pagina.

Esempio 7: casella di testo multiriga

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

Crea una casella di testo multiriga.

Esempio 8: casella di testo multiriga con 5 righe

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

Crea una casella di testo multiriga con 5 righe.

Esempio 9: variante

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

Crea una casella di testo filled.

Esempio 10: OnEnter

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

Crea una casella di testo con un evento OnEnter.

Esempio 11: OnBlur

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

Crea una casella di testo con un evento OnBlur.

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

Crea una casella di testo con un evento OnValidate.

Esempio 13: testo di aiuto

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

Crea una casella di testo con testo di aiuto.

Esempio 14: OnChange

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

Crea una casella di testo con un evento OnChange.

Esempio 15: minimo e massimo

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

Crea una casella di testo numerica con un valore minimo e massimo.

Esempio 16: modello di maschera

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

Crea una casella di testo con un modello di maschera.