Input.ChoiceSet

Anmärkning

Skapar du Copilot-, Teams- eller Outlook-scenarier som drivs av adaptiva kort? Besök Adaptive Card Documentation Hub, den nya one-stop-shop för alla dina adaptiva kortbehov! Den har alla resurser du letar efter, inklusive fullständig dokumentation för många nya funktioner, till exempel dynamisk layout, ikon, märke, karusell, diagram och mycket mer!

Viktig information om tillgänglighet: I version 1.3 av schemat introducerade vi en etikettegenskap på inmatningar för att förbättra tillgängligheten. Om värdappen som du riktar in dig på stöder v1.3 bör du använda Label i stället för en TextBlock som visas i vissa exempel nedan. När de flesta värdappar har uppdaterats till den senaste versionen uppdaterar vi exemplen i enlighet med detta.

Input.ChoiceSet

Tillåter att en användare anger ett val.

Egenskaper för Input.ChoiceSet

Fastighet Typ Krävs Description Utgåva
type "Input.ChoiceSet" Yes Måste vara "Input.ChoiceSet". 1.0
ID string Yes Unik identifierare för värdet. Används för att identifiera insamlade indata när åtgärden Skicka utförs. 1.0
alternativ Input.Choice[] Nej Choice alternativ. 1.0
choices.data Data.Query Nej Gör att dynamisk hämtning av val från roboten kan visas som förslag i listrutan när användaren skriver i indatafältet. 1.6
isMultiSelect boolean Nej Tillåt att flera val väljs. 1.0
stil ChoiceInputStyle Nej 1.0
value string Nej Det första valet (eller en uppsättning val) som ska väljas. För flera val anger du en kommaavgränsad sträng med värden. 1.0
platshållare string Nej Beskrivning av önskade indata. Endast synlig när inget val har gjorts, style är compact och isMultiSelect är false 1.0
omslag boolean Nej Om truetillåter du att text radbryts. Annars klipps texten ur. 1.2

Ärvda egenskaper

Fastighet Typ Krävs Description Utgåva
Errormessage string Nej Felmeddelandet som ska visas när angivna indata är ogiltigt 1.3
isRequired boolean Nej Om dessa indata krävs eller inte 1.3
etikett string Nej Etikett för dessa indata 1.3
labelPosition InputLabelPosition Nej [STÖDS ENDAST I JAVASCRIPT SDK] Avgör etikettens position. Det kan innehålla värdena "i rad" och "ovan". Som standard placeras etiketten "ovan" när etikettpositionen inte har angetts. 1.6
labelWidth string, number Nej [STÖDS ENDAST I JAVASCRIPT SDK] Avgör etikettens bredd i procent som 40 eller en specifik pixelbredd som "40px" när etiketten placeras i linje med indata. labelWidth ignoreras när etiketten visas ovanför indata. 1.6
inputStyle InputStyle Nej [STÖDS ENDAST I JAVASCRIPT SDK] Formattips för indatafält. Tillåter att indatafält visas som skrivskyddade, men när användaren klickar/fokuserar på fältet kan de uppdatera dessa fält. 1.6
Fallback Element, FallbackOption Nej Beskriver vad du ska göra när ett okänt element påträffas eller om kraven för detta eller dess underordnade element inte kan uppfyllas. 1.2
höjd BlockElementHeight Nej Anger elementets höjd. 1.1
separator boolean Nej När trueritar du en avgränsande linje överst i elementet. 1.0
avstånd Spacing Nej Styr mängden avstånd mellan det här elementet och föregående element. 1.0
isVisible boolean Nej, standard: true Om falsetas det här objektet bort från det visuella trädet. 1.2
Kräver Dictionary<string> Nej En serie nyckel/värde-par som anger funktioner som objektet kräver med motsvarande lägsta version. När en funktion saknas eller inte har tillräcklig version utlöses återställningen. 1.2

Example

Exempel 1: Demonstration av Valuppsättningsformat och Flervalsalternativ

JSON Adaptivt kort
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" } ] }

Egenskaper

val (Version 1.0)

Choice Alternativ.

  • Typ: Input.Choice[]
  • Obligatoriskt: Nej
  • Tillåtna värden:
    • Input.Choice

choices.data (version 1.6)

Gör att dynamisk hämtning av val från roboten kan visas som förslag i listrutan när användaren skriver i indatafältet.

  • Typ: Data.Query
  • Version : 1.6
  • Obligatoriskt: Nej
  • Tillåtna värden:
    • Data.Query

isMultiSelect (version 1.0)

Tillåt att flera val väljs.

  • Typ: boolean
  • Obligatoriskt: Nej

style (version 1.0)

  • Typ: ChoiceInputStyle
  • Obligatoriskt: Nej
  • Tillåtna värden:
    • "compact"
    • "expanded"
    • "filtered": Har lagts till i version 1.5. Tillåter användare att filtrera val i en valuppsättning.

värde (version 1.0)

Det första valet (eller en uppsättning val) som ska väljas. För flera val anger du en kommaavgränsad sträng med värden.

  • Typ: string
  • Obligatoriskt: Nej

platshållare (version 1.0)

Beskrivning av önskade indata. Endast synlig när inget val har gjorts, style är compact och isMultiSelect är false

  • Typ: string
  • Obligatoriskt: Nej
JSON Adaptivt kort
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)

Om truetillåter du att text radbryts. Annars klipps texten ur.

  • Typ: boolean
  • Version : 1.2
  • Obligatoriskt: Nej

id (version 1.0)

Unik identifierare för värdet. Används för att identifiera insamlade indata när åtgärden Skicka utförs.

  • Typ: string
  • Obligatoriskt: Ja

errorMessage (version 1.3)

Felmeddelandet som ska visas när angivna indata är ogiltigt

  • Typ: string
  • Version : 1.3
  • Obligatoriskt: Nej

isRequired (version 1.3)

Om dessa indata krävs eller inte

  • Typ: boolean
  • Version : 1.3
  • Obligatoriskt: Nej

etikett (version 1.3)

Etikett för dessa indata

  • Typ: string
  • Version : 1.3
  • Obligatoriskt: Nej

labelPosition (version 1.6)

[STÖDS ENDAST I JAVASCRIPT SDK] Avgör etikettens position. Det kan ta värdena "inline" och "ovan". Som standard placeras etiketten "ovan" när etikettpositionen inte har angetts.

  • Typ: InputLabelPosition
  • Version : 1.6
  • Obligatoriskt: Nej
  • Tillåtna värden:
    • "inline"
    • "above"

labelWidth (version 1.6)

[STÖDS ENDAST I JAVASCRIPT SDK] Avgör etikettens bredd i procent som 40 eller en specifik pixelbredd som "40px" när etiketten placeras i linje med indata. labelWidth ignoreras när etiketten visas ovanför indata.

  • Typ: string, number
  • Version : 1.6
  • Obligatoriskt: Nej

inputStyle (version 1.6)

[STÖDS ENDAST I JAVASCRIPT SDK] Formattips för indatafält. Tillåter att indatafält visas som skrivskyddade, men när användaren klickar/fokuserar på fältet kan de uppdatera dessa fält.

  • Typ: InputStyle
  • Version : 1.6
  • Obligatoriskt: Nej
  • Tillåtna värden:
    • "revealOnHover"
    • "default"

sekundär alternativ (version 1.2)

Beskriver vad du ska göra när ett okänt element påträffas eller om det här eller eventuella underordnade element inte kan uppfyllas.

  • Typ: Element, FallbackOption
  • Version : 1.2
  • Obligatoriskt: Nej
  • Tillåtna värden:
    • ActionSet
    • ColumnSet
    • Container
    • FactSet
    • Image
    • ImageSet
    • Input.ChoiceSet
    • Input.Date
    • Input.Number
    • Input.Text
    • Input.Time
    • Input.Toggle
    • Media
    • RichTextBlock
    • Table
    • TextBlock
    • "drop": Gör att det här elementet tas bort omedelbart när okända element påträffas. Det okända elementet bubblar inte upp högre.

höjd (version 1.1)

Anger elementets höjd.

  • Typ: BlockElementHeight
  • Version : 1.1
  • Obligatoriskt: Nej
  • Tillåtna värden:
    • "auto": Containerns höjd bestäms av innehållets höjd.
    • "stretch": Containern sträcker ut sin höjd till den tillgängliga återstående höjden för den överordnade containern.

avgränsare (version 1.0)

När trueritar du en avgränsande linje överst i elementet.

  • Typ: boolean
  • Obligatoriskt: Nej

avstånd (version 1.0)

Styr mängden avstånd mellan det här elementet och föregående element.

  • Typ: Spacing
  • Obligatoriskt: Nej
  • Tillåtna värden:
    • "default"
    • "none"
    • "small"
    • "medium"
    • "large"
    • "extraLarge"
    • "padding"

isVisible (version 1.2)

Om falsetas det här objektet bort från det visuella trädet.

  • Typ: boolean
  • Version : 1.2
  • Obligatoriskt: Nej, standard: true

kräver (version 1.2)

En serie nyckel/värde-par som anger funktioner som objektet kräver med motsvarande lägsta version. När en funktion saknas eller inte har tillräcklig version utlöses återställningen.

  • Typ: Dictionary<string>
  • Version : 1.2
  • Obligatoriskt: Nej
  • Last updated on