Input.ChoiceSet

Nota:

¿Está creando escenarios de Copilot, Teams o Outlook con tecnología de tarjetas adaptables? Visite el Centro de documentación de tarjetas adaptables, la nueva tienda única para todas sus necesidades de tarjeta adaptable. Tiene todos los recursos que busca, incluida la documentación completa para muchas características nuevas, como diseño dinámico, icono, distintivo, carrusel, gráficos, etc.

Nota importante sobre la accesibilidad: En la versión 1.3 del esquema se introdujo una propiedad label en Entradas para mejorar la accesibilidad. Si la aplicación anfitriona a la que está orientando admite la versión 1.3, debe usar etiqueta en lugar de TextBlock, como se muestra en algunos ejemplos a continuación. Una vez que la mayoría de las aplicaciones host se hayan actualizado a la versión más reciente, actualizaremos los ejemplos según corresponda.

Input.ChoiceSet

Permite que un usuario escriba una opción.

Propiedades Input.ChoiceSet

Propiedad	Tipo	Obligatorio	Description	Versión
type	"Input.ChoiceSet"	Sí	Debe ser "Input.ChoiceSet".	1,0
ID	string	Sí	Identificador único del valor. Se usa para identificar la entrada recopilada cuando se realiza la acción Enviar.	1,0
opciones de	Input.Choice[]	No	Choice Opciones.	1,0
choices.data	Data.Query	No	Permite la captura dinámica de opciones del bot que se mostrará como sugerencias en la lista desplegable cuando el usuario escribe en el campo de entrada.	1.6
isMultiSelect	boolean	No	Permitir que se seleccionen varias opciones.	1,0
style	ChoiceInputStyle	No		1,0
value	string	No	Elección inicial (o conjunto de opciones) que se debe seleccionar. Para la selección múltiple, especifique una cadena separada por comas de valores.	1,0
marcador	string	No	Descripción de la entrada deseada. Solo es visible cuando no se ha realizado ninguna selección, es stylecompact y isMultiSelect es false	1,0
envolver	boolean	No	Si true, permita que el texto se ajuste al espacio disponible. De lo contrario, el texto se recorta.	1.2

Propiedades heredadas

Propiedad	Tipo	Obligatorio	Description	Versión
Errormessage	string	No	Mensaje de error que se muestra cuando la entrada especificada no es válida	1.3
isRequired	boolean	No	Indica si se requiere o no esta entrada	1.3
label	string	No	Etiqueta para esta entrada	1.3
labelPosition	InputLabelPosition	No	[SOLO SE ADMITE EN EL SDK DE JAVASCRIPT] Determina la posición de la etiqueta. Puede tomar valores 'inline' y 'above'. De forma predeterminada, la etiqueta se coloca "arriba" cuando no se especifica la posición de la etiqueta.	1.6
labelWidth	string, number	No	[SOLO SE ADMITE EN EL SDK DE JAVASCRIPT] Determina el ancho de la etiqueta en porcentaje, como 40 o un ancho de píxel específico, como "40px" cuando la etiqueta se coloca en línea con la entrada. labelWidth se omitiría cuando la etiqueta se muestra encima de la entrada.	1.6
inputStyle	InputStyle	No	[SOLO SE ADMITE EN EL SDK DE JAVASCRIPT] Sugerencia de estilo para los campos de entrada. Permite que los campos de entrada aparezcan como de solo lectura, pero cuando el usuario hace clic o se centra en el campo, les permite actualizar esos campos.	1.6
Alternativa	Element, FallbackOption	No	Describe qué hacer cuando se encuentra un elemento desconocido o no se pueden cumplir los requisitos de este o de cualquier elemento secundario.	1.2
height	BlockElementHeight	No	Especifica el alto del elemento.	1.1
separator	boolean	No	Cuando true, dibuje una línea de separación en la parte superior del elemento.	1,0
espaciamiento	Spacing	No	Controla la cantidad de espaciado entre este elemento y el elemento anterior.	1,0
isVisible	boolean	No, valor predeterminado: true	Si false es cierto, este elemento se quitará del árbol visual.	1.2
Requiere	Dictionary<string>	No	Serie de pares clave-valor que indican las características que el elemento requiere con la versión mínima correspondiente. Cuando una característica está ausente o una versión es inadecuada, se activa el mecanismo de respaldo.	1.2

Example

Ejemplo 1: Demostración de estilos de conjunto de opciones y selección múltiple

JSON

Tarjeta adaptable

json { "$schema": "http://adaptivecards.io/schemas/adaptive-card.json", "type": "AdaptiveCard", "version": "1.3", "body": [ { "type": "Input.ChoiceSet", "id": "myColor", "style": "compact", "label": "What color do you want? (isMultiSelect:false, style:compact)", "isMultiSelect": false, "value": "1", "choices": [ { "title": "Red", "value": "1" }, { "title": "Green", "value": "2" }, { "title": "Blue", "value": "3" } ] }, { "type": "Input.ChoiceSet", "id": "myColor2", "style": "expanded", "label": "What color do you want? (isMultiSelect:false, style:expanded)", "isMultiSelect": false, "value": "1", "choices": [ { "title": "Red", "value": "1" }, { "title": "Green", "value": "2" }, { "title": "Blue", "value": "3" } ] }, { "type": "Input.ChoiceSet", "id": "myColor3", "isMultiSelect": true, "value": "1,3", "style": "compact", "label": "What colors do you want? (isMultiSelect:true, style:compact)", "choices": [ { "title": "Red", "value": "1" }, { "title": "Green", "value": "2" }, { "title": "Blue", "value": "3" } ] }, { "type": "Input.ChoiceSet", "id": "myColor4", "isMultiSelect": true, "value": "1", "style": "expanded", "label": "What colors do you want? (isMultiSelect:true, style:expanded)", "choices": [ { "title": "Red", "value": "1" }, { "title": "Green", "value": "2" }, { "title": "Blue", "value": "3" } ] } ], "actions": [ { "type": "Action.Submit", "title": "OK" } ] }

Propiedades

opciones (versión 1.0)

Choice Opciones.

• Tipo: Input.Choice[]
• Obligatorio: No
• Valores permitidos:
  • Input.Choice

choices.data (versión 1.6)

Permite la captura dinámica de opciones del bot que se mostrará como sugerencias en la lista desplegable cuando el usuario escribe en el campo de entrada.

• Tipo: Data.Query
• Versión : 1.6
• Obligatorio: No
• Valores permitidos:
  • Data.Query

isMultiSelect (versión 1.0)

Permitir que se seleccionen varias opciones.

• Tipo: boolean
• Obligatorio: No

style (versión 1.0)

• Tipo: ChoiceInputStyle
• Obligatorio: No
• Valores permitidos:
  • "compact"
  • "expanded"
  • "filtered": se ha agregado en la versión 1.5. Permite a los usuarios filtrar las opciones de un conjunto de opciones.

value (versión 1.0)

Elección inicial (o conjunto de opciones) que se debe seleccionar. Para la selección múltiple, especifique una cadena separada por comas de valores.

• Tipo: string
• Obligatorio: No

marcador de posición (versión 1.0)

Descripción de la entrada deseada. Solo es visible cuando no se ha realizado ninguna selección, es stylecompact y isMultiSelect es false

• Tipo: string
• Obligatorio: No

JSON

Tarjeta adaptable

json { "type": "AdaptiveCard", "$schema": "http://adaptivecards.io/schemas/adaptive-card.json", "version": "1.3", "body": [ { "type": "Input.ChoiceSet", "id": "CompactSelectVal", "label": "What color do you want? (compact)", "style": "compact", "isRequired": true, "errorMessage": "This is a required input", "placeholder": "Please choose", "choices": [ { "title": "Red", "value": "1" }, { "title": "Green", "value": "2" }, { "title": "Blue", "value": "3" } ] } ], "actions": [ { "type": "Action.Submit", "title": "OK" } ] }

wrap (versión 1.2)

Si true, permita que el texto se ajuste al espacio disponible. De lo contrario, el texto se recorta.

• Tipo: boolean
• Versión : 1.2
• Obligatorio: No

id (versión 1.0)

Identificador único del valor. Se usa para identificar la entrada recopilada cuando se realiza la acción Enviar.

• Tipo: string
• Obligatorio: Sí

errorMessage (versión 1.3)

Mensaje de error que se muestra cuando la entrada especificada no es válida

• Tipo: string
• Versión : 1.3
• Obligatorio: No

isRequired (versión 1.3)

Indica si se requiere o no esta entrada

• Tipo: boolean
• Versión : 1.3
• Obligatorio: No

label (versión 1.3)

Etiqueta para esta entrada

• Tipo: string
• Versión : 1.3
• Obligatorio: No

labelPosition (versión 1.6)

[SOLO SE ADMITE EN EL SDK DE JAVASCRIPT] Determina la posición de la etiqueta. Puede tomar valores "en línea" y "encima". De forma predeterminada, la etiqueta se coloca "arriba" cuando no se especifica la posición de la etiqueta.

• Tipo: InputLabelPosition
• Versión : 1.6
• Obligatorio: No
• Valores permitidos:
  • "inline"
  • "above"

labelWidth (versión 1.6)

[SOLO SE ADMITE EN EL SDK DE JAVASCRIPT] Determina el ancho de la etiqueta en porcentaje, como 40 o un ancho de píxel específico, como "40px" cuando la etiqueta se coloca en línea con la entrada. labelWidth se omitiría cuando la etiqueta se muestra encima de la entrada.

• Tipo: string, number
• Versión : 1.6
• Obligatorio: No

inputStyle (versión 1.6)

[SOLO SE ADMITE EN EL SDK DE JAVASCRIPT] Sugerencia de estilo para los campos de entrada. Permite que los campos de entrada aparezcan como de solo lectura, pero cuando el usuario hace clic o se centra en el campo, les permite actualizar esos campos.

• Tipo: InputStyle
• Versión : 1.6
• Obligatorio: No
• Valores permitidos:
  • "revealOnHover"
  • "default"

mecanismo alternativo (Versión 1.2)

Describa qué hacer cuando se encuentra un elemento desconocido o no se puedan satisfacer los requisitos de este o de cualquier elemento secundario.

• Tipo: Element, FallbackOption
• Versión : 1.2
• Obligatorio: No
• Valores permitidos:
  • ActionSet
  • ColumnSet
  • Container
  • FactSet
  • Image
  • ImageSet
  • Input.ChoiceSet
  • Input.Date
  • Input.Number
  • Input.Text
  • Input.Time
  • Input.Toggle
  • Media
  • RichTextBlock
  • Table
  • TextBlock
  • "drop": hace que este elemento se quite inmediatamente cuando se encuentren elementos desconocidos. El elemento desconocido no se propaga más arriba.

altura (versión 1.1)

Especifica el alto del elemento.

• Tipo: BlockElementHeight
• Versión : 1.1
• Obligatorio: No
• Valores permitidos:
  • "auto": el alto del contenedor se determinará mediante el alto de su contenido.
  • "stretch": El contenedor estirará su altura al alto restante disponible del contenedor padre.

separador (versión 1.0)

Cuando true, dibuje una línea de separación en la parte superior del elemento.

• Tipo: boolean
• Obligatorio: No

espaciado (versión 1.0)

Controla la cantidad de espaciado entre este elemento y el elemento anterior.

• Tipo: Spacing
• Obligatorio: No
• Valores permitidos:
  • "default"
  • "none"
  • "small"
  • "medium"
  • "large"
  • "extraLarge"
  • "padding"

isVisible (versión 1.2)

Si false es cierto, este elemento se quitará del árbol visual.

• Tipo: boolean
• Versión : 1.2
• Obligatorio: No, valor predeterminado: true

requiere (versión 1.2)

Serie de pares clave-valor que indican las características que el elemento requiere con la versión mínima correspondiente. Cuando una característica está ausente o una versión es inadecuada, se activa el mecanismo de respaldo.

• Tipo: Dictionary<string>
• Versión : 1.2
• Obligatorio: No