New-UDTextbox

Sinopsis

Los cuadros de texto permiten a los usuarios introducir y editar texto.

Sintaxis

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

Descripción

Crea un cuadro de texto. Los cuadros de texto pueden usarse por sí solos o dentro de un New-UDForm.

Parámetros

-Id

El ID del componente. De forma predeterminada es un GUID aleatorio.

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

-Label

Una etiqueta que se muestra encima de este cuadro de texto.

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

-Placeholder

Un marcador de posición que se coloca dentro del cuadro de texto.

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

-Value

El valor actual del cuadro de texto.

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

-Type

El tipo de cuadro de texto. Puede tomar valores como text, password o email.

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

-Disabled

Si este cuadro de texto está deshabilitado.

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

-Icon

El icono que se muestra junto al cuadro de texto. Use New-UDIcon para crear un icono.

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

-Autofocus

Si se debe enfocar automáticamente este cuadro de texto.

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

-Multiline

Crea un cuadro de texto multilínea

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

-Rows

El número de filas de un cuadro de texto multilínea.

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

-RowsMax

El número máximo de filas de un cuadro de texto multilínea.

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

-FullWidth

Si este cuadro de texto debe ocupar todo el ancho del control principal.

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

-Variant

La variante del cuadro de texto. Los valores válidos son "filled", "outlined", "standard"

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

-ClassName

Una clase CSS que se aplica al cuadro de texto.

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

-OnEnter

Un bloque de script que se llama cuando el usuario pulsa la tecla Intro. La variable $EventData contendrá el valor actual del cuadro de texto.

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

-OnBlur

Un bloque de script que se llama cuando el usuario sale del cuadro de texto. La variable $EventData contendrá el valor actual del cuadro de texto.

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

-Shrink

Si se debe reducir la etiqueta de forma predeterminada.

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

-OnValidate

Un bloque de script que se llama cuando el usuario sale del cuadro de texto. La variable $EventData contendrá el valor actual del cuadro de texto. Si el bloque de script devuelve un resultado de validación no válido, se mostrará debajo del cuadro de texto.

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

-HelperText

Un texto de ayuda que se muestra debajo del cuadro de texto.

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

-OnChange

Un bloque de script que se llama cuando el usuario cambia el valor del cuadro de texto. La variable $EventData contendrá el valor actual del cuadro de texto.

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

-Minimum

El valor mínimo para un cuadro de texto numérico.

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

-Maximum

El valor máximo para un cuadro de texto numérico.

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

-MaximumLength

La longitud máxima del texto en el cuadro de texto.

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

-Sx

Una tabla hash de propiedades basadas en el tema que se aplican al cuadro de texto.

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

-Style

Una tabla hash de propiedades CSS que se aplican al cuadro de texto.

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

-MaskPattern

Un patrón de máscara que se aplica al cuadro de texto. Se utiliza para máscaras de entrada. Consulte iMaskjs para obtener más información.

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

Parámetros comunes

Este cmdlet admite los parámetros comunes: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, PipelineVariable y OutVariable. Para obtener más información, consulte about_CommonParameters.

Salidas

Ejemplos

Ejemplo 1: cuadro de texto básico

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

Crea un cuadro de texto básico.

Ejemplo 2: cuadro de texto de contraseña

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

Crea un cuadro de texto de contraseña.

Ejemplo 3: cuadro de texto de correo electrónico

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

Crea un cuadro de texto de correo electrónico.

Ejemplo 4: cuadro de texto deshabilitado

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

Crea un cuadro de texto deshabilitado.

Ejemplo 5: cuadro de texto con icono

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

Crea un cuadro de texto con un icono.

Ejemplo 6: cuadro de texto con enfoque automático

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

Crea un cuadro de texto que se enfocará automáticamente cuando se cargue la página.

Ejemplo 7: cuadro de texto multilínea

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

Crea un cuadro de texto multilínea.

Ejemplo 8: cuadro de texto multilínea con 5 filas

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

Crea un cuadro de texto multilínea con 5 filas.

Ejemplo 9: variante

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

Crea un cuadro de texto relleno.

Ejemplo 10: OnEnter

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

Crea un cuadro de texto con un evento OnEnter.

Ejemplo 11: OnBlur

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

Crea un cuadro de texto con un evento OnBlur.

Ejemplo 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 un cuadro de texto con un evento OnValidate.

Ejemplo 13: texto de ayuda

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

Crea un cuadro de texto con texto de ayuda.

Ejemplo 14: OnChange

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

Crea un cuadro de texto con un evento OnChange.

Ejemplo 15: mínimo y máximo

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

Crea un cuadro de texto numérico con un valor mínimo y máximo.

Ejemplo 16: patrón de máscara

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

Crea un cuadro de texto con un patrón de máscara.