Input.ChoiceSet

Note

Créez-vous des scénarios Copilot, Teams ou Outlook optimisés par des cartes adaptatives ? Visitez le Hub de documentation sur la carte adaptative, le nouveau magasin unique pour tous vos besoins en carte adaptative ! Il dispose de toutes les ressources que vous recherchez, y compris la documentation complète pour de nombreuses nouvelles fonctionnalités, telles que la disposition réactive, l’icône, le badge, le carrouel, les graphiques, etc.

Remarque importante sur l’accessibilité : Dans la version 1.3 du schéma, nous avons introduit une propriété d’étiquette sur les entrées pour améliorer l’accessibilité. Si l’application hôte que vous ciblez prend en charge la version 1.3, vous devez utiliser l’étiquette au lieu d’un TextBlock comme indiqué dans certains exemples ci-dessous. Une fois que la plupart des applications hôtes ont été mises à jour vers la dernière version, nous allons mettre à jour les exemples en conséquence.

Input.ChoiceSet

Permet à un utilisateur d’entrer un choix.

Propriétés Input.ChoiceSet

Propriété Type Obligatoire Descriptif Version
type "Input.ChoiceSet" Oui Doit être "Input.ChoiceSet". 1,0
id string Oui Identificateur unique de la valeur. Permet d’identifier les entrées collectées lorsque l’action Envoyer est effectuée. 1,0
choix Input.Choice[] Non Choice Options. 1,0
choices.data Data.Query Non Permet l’extraction dynamique des choix du bot à afficher sous forme de suggestions dans la liste déroulante lorsque l’utilisateur tape dans le champ d’entrée. 1.6
isMultiSelect boolean Non Autoriser la sélection de plusieurs choix. 1,0
style ChoiceInputStyle Non 1,0
value string Non Choix initial (ou ensemble de choix) qui doit être sélectionné. Pour la sélection multiple, spécifiez une chaîne séparée par des virgules de valeurs. 1,0
Espace réservé string Non Description de l’entrée souhaitée. Visible uniquement lorsqu’aucune sélection n’a été effectuée, style est compact et isMultiSelect est false 1,0
envelopper boolean Non Si true, permettre au texte de s'enrouler. Sinon, le texte est tronqué. 1.2

Propriétés héritées

Propriété Type Obligatoire Descriptif Version
Errormessage string Non Message d’erreur à afficher lorsque l’entrée entrée n’est pas valide 1.3
isRequired boolean Non Indique si cette entrée est requise ou non 1.3
label string Non Étiquette pour cette entrée 1.3
labelPosition InputLabelPosition Non [PRIS EN CHARGE UNIQUEMENT DANS LE KIT SDK JAVASCRIPT] Détermine la position de l’étiquette. Il peut prendre des valeurs « inline » et « ci-dessus ». Par défaut, l’étiquette est placée « au-dessus » lorsque la position de l’étiquette n’est pas spécifiée. 1.6
labelWidth string, number Non [PRIS EN CHARGE UNIQUEMENT DANS LE KIT SDK JAVASCRIPT] Détermine la largeur de l’étiquette en pourcentage comme 40 ou une largeur de pixel spécifique comme « 40px » lorsque l’étiquette est placée en ligne avec l’entrée. labelWidth est ignoré lorsque l’étiquette est affichée au-dessus de l’entrée. 1.6
inputStyle InputStyle Non [PRIS EN CHARGE UNIQUEMENT DANS LE KIT SDK JAVASCRIPT] Indicateur de style pour les champs d’entrée. Permet aux champs d’entrée d’apparaître en lecture seule, mais lorsque l’utilisateur clique/se concentre sur le champ, il leur permet de mettre à jour ces champs. 1.6
Solution de repli Element, FallbackOption Non Décrit ce qu’il faut faire lorsqu’un élément inconnu est rencontré ou si les besoins de ce ou de tous les enfants ne peuvent pas être rencontrés. 1.2
height BlockElementHeight Non Spécifie la hauteur de l’élément. 1.1
separator boolean Non Quand true, dessinez une ligne de séparation en haut de l’élément. 1,0
espacement Spacing Non Contrôle la quantité d’espacement entre cet élément et l’élément précédent. 1,0
isVisible boolean Non, valeur par défaut : true Si false, cet élément sera supprimé de l’arborescence visuelle. 1.2
Exige Dictionary<string> Non Série de paires clé/valeur indiquant les fonctionnalités requises par l’élément avec la version minimale correspondante. Lorsque qu’une fonctionnalité est manquante ou n'est pas à la version requise, un mécanisme de secours est déclenché. 1.2

Example

Exemple 1 : Démonstration des styles ChoiceSet et sélection multiple

JSON Carte adaptative
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" } ] }

Propriétés

Choix (Version 1.0)

Choice Options.

  • Type : Input.Choice[]
  • Obligatoire : Non
  • Valeurs autorisées :
    • Input.Choice

choices.data (version 1.6)

Permet l’extraction dynamique des choix du bot à afficher sous forme de suggestions dans la liste déroulante lorsque l’utilisateur tape dans le champ d’entrée.

  • Type : Data.Query
  • Version : 1.6
  • Obligatoire : Non
  • Valeurs autorisées :
    • Data.Query

isMultiSelect (version 1.0)

Autoriser la sélection de plusieurs choix.

  • Type : boolean
  • Obligatoire : Non

style (version 1.0)

  • Type : ChoiceInputStyle
  • Obligatoire : Non
  • Valeurs autorisées :
    • "compact"
    • "expanded"
    • "filtered": ajouté dans la version 1.5. Permet aux utilisateurs de filtrer les choix dans un ensemble de choix.

valeur (version 1.0)

Choix initial (ou ensemble de choix) qui doit être sélectionné. Pour la sélection multiple, spécifiez une chaîne séparée par des virgules de valeurs.

  • Type : string
  • Obligatoire : Non

espace réservé (version 1.0)

Description de l’entrée souhaitée. Visible uniquement quand aucune sélection n’a été effectuée, style est compact et isMultiSelect est false.

  • Type : string
  • Obligatoire : Non
JSON Carte adaptative
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 (version 1.2)

Si true, permettre au texte de s'enrouler. Sinon, le texte est tronqué.

  • Type : boolean
  • Version : 1.2
  • Obligatoire : Non

id (version 1.0)

Identificateur unique de la valeur. Permet d’identifier les entrées collectées lorsque l’action Envoyer est effectuée.

  • Type : string
  • Obligatoire : Oui

errorMessage (version 1.3)

Message d’erreur à afficher lorsque l’entrée entrée n’est pas valide

  • Type : string
  • Version : 1.3
  • Obligatoire : Non

isRequired (version 1.3)

Indique si cette entrée est requise ou non

  • Type : boolean
  • Version : 1.3
  • Obligatoire : Non

étiquette (version 1.3)

Étiquette pour cette entrée

  • Type : string
  • Version : 1.3
  • Obligatoire : Non

labelPosition (version 1.6)

[PRIS EN CHARGE UNIQUEMENT DANS LE KIT SDK JAVASCRIPT] Détermine la position de l’étiquette. Il peut prendre des valeurs « inline » et « au-dessus ». Par défaut, l’étiquette est placée « au-dessus » lorsque la position de l’étiquette n’est pas spécifiée.

  • Type : InputLabelPosition
  • Version : 1.6
  • Obligatoire : Non
  • Valeurs autorisées :
    • "inline"
    • "above"

labelWidth (version 1.6)

[PRIS EN CHARGE UNIQUEMENT DANS LE KIT SDK JAVASCRIPT] Détermine la largeur de l’étiquette en pourcentage comme 40 ou une largeur de pixel spécifique comme « 40px » lorsque l’étiquette est placée en ligne avec l’entrée. labelWidth est ignoré lorsque l’étiquette est affichée au-dessus de l’entrée.

  • Type : string, number
  • Version : 1.6
  • Obligatoire : Non

inputStyle (version 1.6)

[PRIS EN CHARGE UNIQUEMENT DANS LE KIT SDK JAVASCRIPT] Indicateur de style pour les champs d’entrée. Permet aux champs d’entrée d’apparaître en lecture seule, mais lorsque l’utilisateur clique/se concentre sur le champ, il leur permet de mettre à jour ces champs.

  • Type : InputStyle
  • Version : 1.6
  • Obligatoire : Non
  • Valeurs autorisées :
    • "revealOnHover"
    • "default"

secours (version 1.2)

Décrit ce qu’il faut faire lorsqu’un élément inconnu est rencontré ou si les besoins de ce ou de tous les enfants ne peuvent pas être rencontrés.

  • Type : Element, FallbackOption
  • Version : 1.2
  • Obligatoire : Non
  • Valeurs autorisées :
    • ActionSet
    • ColumnSet
    • Container
    • FactSet
    • Image
    • ImageSet
    • Input.ChoiceSet
    • Input.Date
    • Input.Number
    • Input.Text
    • Input.Time
    • Input.Toggle
    • Media
    • RichTextBlock
    • Table
    • TextBlock
    • "drop": provoque la suppression immédiate de cet élément lorsque des éléments inconnus sont rencontrés. L'élément inconnu ne se propage pas plus haut.

hauteur (version 1.1)

Spécifie la hauteur de l’élément.

  • Type : BlockElementHeight
  • Version : 1.1
  • Obligatoire : Non
  • Valeurs autorisées :
    • "auto": la hauteur du conteneur sera déterminée par la hauteur de son contenu.
    • "stretch": le conteneur étire sa hauteur jusqu’à la hauteur restante disponible du conteneur parent.

séparateur (version 1.0)

Quand true, dessinez une ligne de séparation en haut de l’élément.

  • Type : boolean
  • Obligatoire : Non

espacement (version 1.0)

Contrôle la quantité d’espacement entre cet élément et l’élément précédent.

  • Type : Spacing
  • Obligatoire : Non
  • Valeurs autorisées :
    • "default"
    • "none"
    • "small"
    • "medium"
    • "large"
    • "extraLarge"
    • "padding"

isVisible (version 1.2)

Si false, cet élément sera supprimé de l’arborescence visuelle.

  • Type : boolean
  • Version : 1.2
  • Obligatoire : Non, valeur par défaut : true

nécessite (version 1.2)

Série de paires clé/valeur indiquant les fonctionnalités requises par l’élément avec la version minimale correspondante. Lorsque qu’une fonctionnalité est manquante ou n'est pas à la version requise, un mécanisme de secours est déclenché.

  • Type : Dictionary<string>
  • Version : 1.2
  • Obligatoire : Non
  • Last updated on