Entrada.Número

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.

Entrada.Número

Permite que un usuario escriba un número.

Propiedades Input.Number

Propiedad	Tipo	Obligatorio	Description	Versión
type	"Input.Number"	Sí	Debe ser "Input.Number".	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
máximo	number	No	Indicación de valor máximo (puede ser ignorado por algunos clientes).	1,0
min	number	No	Sugerencia sobre el valor mínimo (puede ser ignorada por algunos clientes).	1,0
marcador	string	No	Descripción de la entrada deseada. Se muestra cuando no se ha realizado ninguna selección.	1,0
value	number	No	Valor inicial de este campo.	1,0

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: Input.Number con Min, Max y Valor

JSON	Tarjeta adaptable
json { "$schema": "http://adaptivecards.io/schemas/adaptive-card.json", "type": "AdaptiveCard", "version": "1.3", "body": [ { "type": "Input.Number", "id": "number", "placeholder": "Enter a number", "label": "Enter a number", "min": 1, "max": 10, "value": 3 } ], "actions": [ { "type": "Action.Submit", "title": "OK" } ] }	[Tarjeta adaptable Pruébelo usted mismo >]

Propiedades

max (versión 1.0)

Sugerencia de un límite de valor máximo (puede ser ignorado por algunos clientes).

• Tipo: number
• Obligatorio: No

min (versión 1.0)

Indicación de valor mínimo (que algunos clientes pueden ignorar).

• Tipo: number
• Obligatorio: No

marcador de posición (versión 1.0)

Descripción de la entrada deseada. Se muestra cuando no se ha realizado ninguna selección.

• Tipo: string
• Obligatorio: No

value (versión 1.0)

Valor inicial de este campo.

• Tipo: number
• 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