Input.ChoiceSet

Opmerking

Bouwt u Copilot-, Teams- of Outlook-scenario's op basis van adaptieve kaarten? Ga naar Adaptive Card Documentation Hub, de nieuwe one-stop-shop voor al uw adaptieve kaartbehoeften. Het bevat alle resources die u zoekt, inclusief volledige documentatie voor veel nieuwe functies, zoals Responsieve indeling, Pictogram, Badge, Carrousel, Grafieken en nog veel meer!

Belangrijke opmerking over toegankelijkheid: In versie 1.3 van het schema hebben we een labeleigenschap geïntroduceerd op Invoer om de toegankelijkheid te verbeteren. Als de Host-app die u als doel hebt , v1.3 ondersteunt, moet u een label gebruiken in plaats van een TextBlock , zoals in enkele voorbeelden hieronder wordt weergegeven. Zodra de meeste Host-apps zijn bijgewerkt naar de nieuwste versie, werken we de voorbeelden dienovereenkomstig bij.

Input.ChoiceSet

Hiermee kan een gebruiker een keuze invoeren.

Eigenschappen van Input.ChoiceSet

Vastgoed Typologie Verplicht Description Versie
type "Input.ChoiceSet" Yes Moet "Input.ChoiceSet"zijn. 1.0
ID string Yes Unieke id voor de waarde. Wordt gebruikt om verzamelde invoer te identificeren wanneer de actie Verzenden wordt uitgevoerd. 1.0
keuzes Input.Choice[] Nee. Choice Opties. 1.0
choices.data Data.Query Nee. Hiermee kan het dynamisch ophalen van keuzes van de bot worden weergegeven als suggesties in de vervolgkeuzelijst wanneer de gebruiker in het invoerveld typt. 1.6
isMultiSelect boolean Nee. Toestaan dat meerdere opties worden geselecteerd. 1.0
stijl ChoiceInputStyle Nee. 1.0
value string Nee. De eerste keuze (of een reeks keuzes) die moet worden geselecteerd. Geef voor meervoudige selectie een door komma's gescheiden tekenreeks met waarden op. 1.0
Tijdelijke aanduiding string Nee. Beschrijving van de gewenste invoer. Alleen zichtbaar wanneer er geen selectie is gemaakt, de style is compact en isMultiSelect is false 1.0
wikkelen boolean Nee. Als true, staat u toe dat tekst terugloopt. Anders wordt tekst geknipt. 1.2

Overgenomen eigenschappen

Vastgoed Typologie Verplicht Description Versie
Errormessage string Nee. Foutbericht dat moet worden weergegeven wanneer invoer ongeldig is 1.3
isRequired boolean Nee. Of deze invoer al dan niet vereist is 1.3
etiket string Nee. Label voor deze invoer 1.3
labelPosition InputLabelPosition Nee. [ALLEEN ONDERSTEUND IN JAVASCRIPT SDK] Bepaalt de positie van het label. Deze parameter kan de waarden 'inline' en 'boven' aannemen. Standaard wordt het label 'boven' geplaatst wanneer de labelpositie niet is opgegeven. 1.6
labelWidth string, number Nee. [ALLEEN ONDERSTEUND IN JAVASCRIPT SDK] Bepaalt de breedte van het label in procenten zoals 40 of een specifieke pixelbreedte zoals '40px' wanneer het label inline wordt geplaatst met de invoer. labelWidth wordt genegeerd wanneer het label boven de invoer wordt weergegeven. 1.6
inputStyle InputStyle Nee. [ALLEEN ONDERSTEUND IN JAVASCRIPT SDK] Hint voor stijl voor invoervelden. Hiermee kunnen invoervelden worden weergegeven als alleen-lezen, maar wanneer de gebruiker op het veld klikt/zich richt, kunnen deze velden worden bijgewerkt. 1.6
Fallback Element, FallbackOption Nee. Hierin wordt beschreven wat u moet doen wanneer een onbekend element wordt aangetroffen of wanneer niet kan worden voldaan aan de vereisten van dit element of van eventuele onderliggende elementen. 1.2
hoogte BlockElementHeight Nee. Geeft de hoogte van het element op. 1.1
separator boolean Nee. Wanneer true, tekent u een scheidingslijn bovenaan het element. 1.0
Afstand Spacing Nee. Hiermee bepaalt u de hoeveelheid afstand tussen dit element en het voorgaande element. 1.0
isVisible boolean Nee, standaard: true Als false, zal dit item worden verwijderd uit de visuele boom. 1.2
Vereist Dictionary<string> Nee. Een reeks sleutel-/waardeparen die aangeven welke functies het item nodig heeft met de bijbehorende minimale versie. Wanneer een functie ontbreekt of een onvoldoende versieniveau heeft, wordt fallback geactiveerd. 1.2

Example

Voorbeeld 1: ChoiceSet-stijlen demonstreren en Meervoudige selectie selecteren

JSON Adaptieve kaart
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" } ] }

Eigenschappen

keuzes (versie 1.0)

Choice Opties.

  • Typ: Input.Choice[]
  • Vereist: Nee
  • Toegestane waarden:
    • Input.Choice

choices.data (versie 1.6)

Hiermee kan het dynamisch ophalen van keuzes van de bot worden weergegeven als suggesties in de vervolgkeuzelijst wanneer de gebruiker in het invoerveld typt.

  • Typ: Data.Query
  • Versie : 1.6
  • Vereist: Nee
  • Toegestane waarden:
    • Data.Query

isMultiSelect (versie 1.0)

Toestaan dat meerdere opties worden geselecteerd.

  • Typ: boolean
  • Vereist: Nee

stijl (versie 1.0)

  • Typ: ChoiceInputStyle
  • Vereist: Nee
  • Toegestane waarden:
    • "compact"
    • "expanded"
    • "filtered": Toegevoegd in versie 1.5. Hiermee kunnen gebruikers keuzes in een keuzeset filteren.

waarde (versie 1.0)

De eerste keuze (of een reeks keuzes) die moet worden geselecteerd. Geef voor meervoudige selectie een door komma's gescheiden tekenreeks met waarden op.

  • Typ: string
  • Vereist: Nee

tijdelijke aanduiding (versie 1.0)

Beschrijving van de gewenste invoer. Alleen zichtbaar wanneer er geen selectie is gemaakt, de style is compact en isMultiSelect is false

  • Typ: string
  • Vereist: Nee
JSON Adaptieve kaart
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 (versie 1.2)

Als true, staat u toe dat tekst terugloopt. Anders wordt tekst geknipt.

  • Typ: boolean
  • Versie : 1.2
  • Vereist: Nee

id (versie 1.0)

Unieke id voor de waarde. Wordt gebruikt om verzamelde invoer te identificeren wanneer de actie Verzenden wordt uitgevoerd.

  • Typ: string
  • Vereist: Ja

errorMessage (versie 1.3)

Foutbericht dat moet worden weergegeven wanneer invoer ongeldig is

  • Typ: string
  • Versie : 1.3
  • Vereist: Nee

isRequired (versie 1.3)

Of deze invoer al dan niet vereist is

  • Typ: boolean
  • Versie : 1.3
  • Vereist: Nee

label (versie 1.3)

Label voor deze invoer

  • Typ: string
  • Versie : 1.3
  • Vereist: Nee

labelPosition (versie 1.6)

[ALLEEN ONDERSTEUND IN JAVASCRIPT SDK] Bepaalt de positie van het label. De waarden 'inline' en 'boven' kunnen worden gebruikt. Standaard wordt het label 'boven' geplaatst wanneer de labelpositie niet is opgegeven.

  • Typ: InputLabelPosition
  • Versie : 1.6
  • Vereist: Nee
  • Toegestane waarden:
    • "inline"
    • "above"

labelWidth (versie 1.6)

[ALLEEN ONDERSTEUND IN JAVASCRIPT SDK] Bepaalt de breedte van het label in procenten zoals 40 of een specifieke pixelbreedte zoals '40px' wanneer het label inline wordt geplaatst met de invoer. labelWidth wordt genegeerd wanneer het label boven de invoer wordt weergegeven.

  • Type: string, number
  • Versie : 1.6
  • Vereist: Nee

inputStyle (versie 1.6)

[ALLEEN ONDERSTEUND IN JAVASCRIPT SDK] Hint voor stijl voor invoervelden. Hiermee kunnen invoervelden worden weergegeven als alleen-lezen, maar wanneer de gebruiker op het veld klikt/zich richt, kunnen deze velden worden bijgewerkt.

  • Typ: InputStyle
  • Versie : 1.6
  • Vereist: Nee
  • Toegestane waarden:
    • "revealOnHover"
    • "default"

fallback (Versie 1.2)

Hierin wordt beschreven wat u moet doen wanneer een onbekend element wordt aangetroffen of wanneer niet kan worden voldaan aan de vereisten van dit of enige onderliggende elementen.

  • Type: Element, FallbackOption
  • Versie : 1.2
  • Vereist: Nee
  • Toegestane waarden:
    • ActionSet
    • ColumnSet
    • Container
    • FactSet
    • Image
    • ImageSet
    • Input.ChoiceSet
    • Input.Date
    • Input.Number
    • Input.Text
    • Input.Time
    • Input.Toggle
    • Media
    • RichTextBlock
    • Table
    • TextBlock
    • "drop": zorgt ervoor dat dit element onmiddellijk wordt verwijderd wanneer er onbekende elementen worden aangetroffen. Het onbekende element komt niet hoger naar boven.

hoogte (versie 1.1)

Geeft de hoogte van het element op.

  • Typ: BlockElementHeight
  • Versie : 1.1
  • Vereist: Nee
  • Toegestane waarden:
    • "auto": De hoogte van de container wordt bepaald door de hoogte van de inhoud.
    • "stretch": De container zal zijn hoogte tot de beschikbare resterende hoogte van de bovenliggende container uitbreiden.

scheidingsteken (versie 1.0)

Wanneer true, tekent u een scheidingslijn bovenaan het element.

  • Typ: boolean
  • Vereist: Nee

afstand (versie 1.0)

Hiermee bepaalt u de hoeveelheid afstand tussen dit element en het voorgaande element.

  • Typ: Spacing
  • Vereist: Nee
  • Toegestane waarden:
    • "default"
    • "none"
    • "small"
    • "medium"
    • "large"
    • "extraLarge"
    • "padding"

isVisible (versie 1.2)

Als false, zal dit item worden verwijderd uit de visuele boom.

  • Typ: boolean
  • Versie : 1.2
  • Vereist: Nee, standaard: true

vereist (versie 1.2)

Een reeks sleutel-/waardeparen die aangeven welke functies het item nodig heeft met de bijbehorende minimale versie. Wanneer een functie ontbreekt of een onvoldoende versieniveau heeft, wordt fallback geactiveerd.

  • Typ: Dictionary<string>
  • Versie : 1.2
  • Vereist: Nee
  • Last updated on