New-UDSelect

Sinopsis

Crea una nueva selección.

Sintaxis

New-UDSelect [[-Id] <String>] [[-Option] <ScriptBlock>] [[-Label] <String>] [[-OnChange] <Endpoint>] [[-DefaultValue] <Object>] [-Disabled] [-Multiple] [[-MaxWidth] <String>] [[-ClassName] <String>] [-FullWidth] [[-OnEnter] <Endpoint>] [[-Variant] <String>] [[-Icon] <Object>] [[-Sx] <Hashtable>] [-Checkbox] [<CommonParameters>]

Descripción

Crea una nueva selección. Las selecciones pueden tener varias opciones y grupos de opciones. Las selecciones también pueden ser de selección múltiple.

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

-Option

Opciones que se incluirán en esta selección. Puede ser New-UDSelectOption o New-UDSelectGroup.

Required?                    false
Position?                    2
Default value                {
                    New-UDSelectOption -Name 'Option 1' -Value 1
                    New-UDSelectOption -Name 'Option 2' -Value 2
                }
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

-Label

La etiqueta que se muestra con la selección.

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

-OnChange

Un bloque de script que se ejecuta cuando el script cambia. $EventData será una matriz de los valores seleccionados.

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

-DefaultValue

El valor seleccionado de forma predeterminada.

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

-Disabled

Si esta selección está deshabilitada.

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

-Multiple

Si se pueden seleccionar varios valores.

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

-MaxWidth

El ancho máximo de la selección.

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

-ClassName

Una clase CSS que aplicar a la selección.

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

-FullWidth

Extiende la selección hasta el ancho completo del componente principal.

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

-Variant

La variante de la selección. Puede ser filled, outlined o standard.

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

-Sx

Una tabla hash de estilos que aplicar a la selección.

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

-Checkbox

Si se muestran casillas de verificación al usar la selección múltiple.

Required?                    false
Position?                    named
Default value                False
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: selección básica

New-UDSelect -Label 'Select' -Id 'select1' -Option {
   New-UDSelectOption -Name "One" -Value 1
   New-UDSelectOption -Name "Two" -Value 2
   New-UDSelectOption -Name "Three" -Value 3
} -FullWidth

Una selección básica con tres opciones

Ejemplo 2: OnChange

New-UDSelect -Label 'Select' -Id 'select2' -Option {
   New-UDSelectOption -Name "One" -Value 1
   New-UDSelectOption -Name "Two" -Value 2
   New-UDSelectOption -Name "Three" -Value 3
} -DefaultValue 2 -OnChange {
   Show-UDToast -Message $EventData
} -FullWidth

Una selección con un bloque de script OnChange que muestra un aviso cuando el valor cambia.

Ejemplo 3: deshabilitada

New-UDSelect -Label 'Select' -Id 'select3' -Option {
   New-UDSelectOption -Name "One" -Value 1
   New-UDSelectOption -Name "Two" -Value 2
   New-UDSelectOption -Name "Three" -Value 3
} -Disabled -FullWidth

Una selección deshabilitada.

Ejemplo 4: múltiple

New-UDSelect -Label 'Select' -Id 'select4' -Option {
   New-UDSelectOption -Name "One" -Value 1
   New-UDSelectOption -Name "Two" -Value 2
   New-UDSelectOption -Name "Three" -Value 3
} -Multiple -FullWidth

Una selección que permite varias selecciones.

Ejemplo 5: múltiple con casillas de verificación

New-UDSelect -Label 'Select' -Id 'select4' -Option {
   New-UDSelectOption -Name "One" -Value 1
   New-UDSelectOption -Name "Two" -Value 2
   New-UDSelectOption -Name "Three" -Value 3
} -Multiple -FullWidth -Checkbox

Una selección que permite varias selecciones con casillas de verificación.

Ejemplo 6: outlined

New-UDSelect -Label 'Select' -Id 'select5' -Option {
   New-UDSelectOption -Name "One" -Value 1
   New-UDSelectOption -Name "Two" -Value 2
   New-UDSelectOption -Name "Three" -Value 3
} -Variant outlined -FullWidth

Una selección con la variante outlined.

Ejemplo 7: icono

New-UDSelect -Label 'Select' -Id 'select6' -Option {
   New-UDSelectOption -Name "One" -Value 1
   New-UDSelectOption -Name "Two" -Value 2
   New-UDSelectOption -Name "Three" -Value 3
} -FullWidth -Icon (New-UDIcon -Icon Home)

Una selección con un icono.

Ejemplo 8: agrupada

New-UDSelect -Label 'Select' -Id 'select7' -Option {
   New-UDSelectGroup -Name "Category 1" -Option {
       New-UDSelectOption -Name "One" -Value 1
       New-UDSelectOption -Name "Two" -Value 2
   }
   New-UDSelectGroup -Name "Category 2" -Option {
       New-UDSelectOption -Name "Three" -Value 3
       New-UDSelectOption -Name "Four" -Value 4
   }
} -FullWidth

Una selección con grupos de opciones.

[Component("Select", "ListDropdown", "Creates a new card.")]