Texto de entrada

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.Texto

Permite que un usuario escriba texto.

Propiedades Input.Text

Propiedad Tipo Obligatorio Description Versión
type "Input.Text" Sí Debe ser "Input.Text". 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
isMultiline boolean No Si true, permita varias líneas de texto. 1,0
maxLength number No Sugerencia de cantidad máxima de caracteres para recopilar (que algunos clientes pueden ignorar). 1,0
marcador string No Descripción de la entrada deseada. Se muestra cuando no se ha introducido ningún texto. 1,0
regex string No Expresión regular que indica el formato necesario de esta entrada de texto. 1.3
style TextInputStyle No Sugerencia de estilo para la entrada de texto. 1,0
inlineAction ISelectAction No Acción en línea para el input. Normalmente se muestra a la derecha de la entrada. Se recomienda encarecidamente proporcionar un icono en la acción (que se mostrará en lugar del título de la acción). 1.2
value string 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: Entradas de texto predeterminadas, multilíneas y rellenadas previamente

JSON Tarjeta adaptable
json { "$schema": "http://adaptivecards.io/schemas/adaptive-card.json", "type": "AdaptiveCard", "version": "1.0", "body": [ { "type": "TextBlock", "text": "Default text input" }, { "type": "Input.Text", "id": "defaultInputId", "placeholder": "enter comment", "maxLength": 500 }, { "type": "TextBlock", "text": "Multiline text input" }, { "type": "Input.Text", "id": "multilineInputId", "placeholder": "enter comment", "maxLength": 500, "isMultiline": true }, { "type": "TextBlock", "text": "Pre-filled value" }, { "type": "Input.Text", "id": "prefilledInputId", "placeholder": "enter comment", "maxLength": 500, "isMultiline": true, "value": "This value was pre-filled" } ], "actions": [ { "type": "Action.Submit", "title": "OK" } ] } [Tarjeta adaptable Pruébelo usted mismo >]

Propiedades

isMultiline (versión 1.0)

Si true está activado, permita varias líneas de entrada.

  • Tipo: boolean
  • Obligatorio: No

maxLength (versión 1.0)

Sugerencia sobre la longitud máxima de caracteres para almacenar (es posible que algunos clientes la ignoren).

  • Tipo: number
  • Obligatorio: No

marcador de posición (versión 1.0)

Descripción de la entrada deseada. Se muestra cuando no se ha introducido ningún texto.

  • Tipo: string
  • Obligatorio: No

regex (versión 1.3)

Expresión regular que indica el formato necesario de esta entrada de texto.

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

style (versión 1.0)

Sugerencia de estilo para la entrada de texto.

  • Tipo: TextInputStyle
  • Obligatorio: No
  • Valores permitidos:
    • "text"
    • "tel"
    • "url"
    • "email"
    • "password": se ha agregado en la versión 1.5. Mostrar texto de entrada con enmascaramiento de contraseñas.
JSON Tarjeta adaptable
json { "$schema": "http://adaptivecards.io/schemas/adaptive-card.json", "type": "AdaptiveCard", "version": "1.3", "body": [ { "type": "TextBlock", "text": "Specify the type of text being requested:", "style": "heading" }, { "type": "Input.Text", "id": "myComment", "label": "style: text", "style": "text" }, { "type": "Input.Text", "id": "myEmail", "label": "style: email", "style": "email" }, { "type": "Input.Text", "id": "myTel", "label": "style: tel", "style": "tel" }, { "type": "Input.Text", "id": "myUrl", "label": "style: url", "style": "url" }, { "type": "Input.Text", "id": "myPassword", "label": "style: password", "style": "password" } ], "actions": [ { "type": "Action.Submit", "title": "OK" } ] } [Tarjeta adaptable Pruébelo usted mismo >]

inlineAction (versión 1.2)

Acción en línea para el input. Normalmente se muestra a la derecha de la entrada. Se recomienda encarecidamente proporcionar un icono en la acción (que se mostrará en lugar del título de la acción).

  • Tipo: ISelectAction
  • Versión : 1.2
  • Obligatorio: No
  • Valores permitidos:
    • Action.Execute
    • Action.OpenUrl
    • Action.Submit
    • Action.ToggleVisibility
JSON Tarjeta adaptable
json { "$schema": "http://adaptivecards.io/schemas/adaptive-card.json", "type": "AdaptiveCard", "version": "1.5", "body": [ { "type": "Input.Text", "id": "iconInlineActionId", "label": "Text input with an inline action", "inlineAction": { "type": "Action.Submit", "iconUrl": "https://adaptivecards.io/content/send.png", "tooltip": "Send" } }, { "type": "Input.Text", "label": "Text input with an inline action with no icon", "id": "textInlineActionId", "inlineAction": { "type": "Action.OpenUrl", "title": "Reply", "tooltip": "Reply to this message", "url": "https://adaptivecards.io" } } ] } [Tarjeta adaptable Pruébelo usted mismo >]

value (versión 1.0)

Valor inicial de este campo.

  • Tipo: string
  • 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 'inline' y 'above'. 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
  • Last updated on