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