Input.ChoiceSet

Hinweis

Erstellen Sie Copilot-, Teams- oder Outlook-Szenarien, die von adaptiven Karten unterstützt werden? Besuchen Sie den Dokumentationshub für adaptive Karten, den neuen One-Stop-Shop für alle Ihre Anforderungen an adaptive Karten! Es verfügt über alle Ressourcen, die Sie suchen, einschließlich der vollständigen Dokumentation für viele neue Features, z. B. dynamisches Layout, Symbol, Badge, Karussell, Diagramme und vieles mehr!

Wichtiger Hinweis zur Barrierefreiheit: In Version 1.3 des Schemas haben wir eine Bezeichnungseigenschaft für Eingaben eingeführt, um die Barrierefreiheit zu verbessern. Wenn die Host-App, auf die Sie abzielen , v1.3 unterstützt, sollten Sie die Bezeichnung anstelle eines TextBlock verwenden, wie in einigen Beispielen unten dargestellt. Sobald die meisten Host-Apps auf die neueste Version aktualisiert wurden, aktualisieren wir die Beispiele entsprechend.

Input.ChoiceSet

Ermöglicht es einem Benutzer, eine Auswahl einzugeben.

Input.ChoiceSet-Eigenschaften

Eigentum Typ Erforderlich Description Version
type "Input.ChoiceSet" Yes Muss "Input.ChoiceSet" sein. 1,0
id string Yes Eindeutiger Bezeichner für den Wert. Wird verwendet, um gesammelte Eingaben zu identifizieren, wenn die Übermittlungsaktion ausgeführt wird. 1,0
Auswahlmöglichkeiten Input.Choice[] Nein Choice Optionen. 1,0
choices.data Data.Query Nein Ermöglicht das dynamische Abrufen von Auswahlmöglichkeiten aus dem Bot, die als Vorschläge im Dropdown angezeigt werden, wenn der Benutzer im Eingabefeld eingibt. 1.6
isMultiSelect boolean Nein Zulassen, dass mehrere Auswahlmöglichkeiten ausgewählt werden. 1,0
style ChoiceInputStyle Nein 1,0
value string Nein Die anfängliche Auswahl (oder gruppe von Auswahlmöglichkeiten), die ausgewählt werden soll. Geben Sie für Mehrfachauswahl eine durch Trennzeichen getrennte Zeichenfolge mit Werten an. 1,0
Platzhalter string Nein Beschreibung der gewünschten Eingabe. Nur sichtbar, wenn keine Auswahl getroffen wurde, ist stylecompact und isMultiSelectfalse. 1,0
umhüllen boolean Nein Wenn true, Zeilenumbruch des Textes zulassen. Andernfalls wird der Text abgeschnitten. 1.2

Geerbte Eigenschaften

Eigentum Typ Erforderlich Description Version
Errormessage string Nein Fehlermeldung, die angezeigt wird, wenn eingegebene Eingabe ungültig ist 1.3
isRequired boolean Nein Gibt an, ob diese Eingabe erforderlich ist. 1.3
Bezeichnung string Nein Bezeichnung für diese Eingabe 1.3
labelPosition InputLabelPosition Nein [NUR IM JAVASCRIPT SDK UNTERSTÜTZT] Bestimmt die Position der Beschriftung. Es kann die Werte „inline“ und „above“ annehmen. Standardmäßig wird die Beschriftung "oben" platziert, wenn die Beschriftungsposition nicht angegeben wird. 1.6
labelWidth string, number Nein [NUR IM JAVASCRIPT SDK UNTERSTÜTZT] Bestimmt die Breite der Beschriftung in Prozent wie 40 oder eine bestimmte Pixelbreite wie "40px", wenn die Beschriftung inline mit der Eingabe platziert wird. labelWidth würde ignoriert, wenn die Beschriftung oberhalb der Eingabe angezeigt wird. 1.6
inputStyle InputStyle Nein [NUR IM JAVASCRIPT SDK UNTERSTÜTZT] Stilhinweise für Eingabefelder. Ermöglicht das Anzeigen von Eingabefeldern als schreibgeschützt, aber wenn der Benutzer auf das Feld klickt oder den Fokus darauf setzt, kann er diese Felder aktualisieren. 1.6
Ausweichlösung Element, FallbackOption Nein Beschreibt, was zu tun ist, wenn ein unbekanntes Element auftritt oder dies oder alle untergeordneten Elemente nicht erfüllt werden können. 1.2
height BlockElementHeight Nein Gibt die Höhe des Elements an. 1.1
separator boolean Nein Wenn true, zeichnen Sie eine trennende Linie am oberen Rand des Elements. 1,0
Abstand Spacing Nein Steuert den Abstand zwischen diesem Element und dem vorherigen Element. 1,0
isVisible boolean Nein, Standard: true Wenn false, wird dieses Element aus dem visuellen Baum entfernt. 1.2
erfordert Dictionary<string> Nein Eine Reihe von Schlüssel-Wert-Paaren, die Features angeben, die für das Element mit entsprechender Mindestversion erforderlich sind. Wenn ein Feature fehlt oder die Version nicht ausreichend ist, wird ein Rückfall ausgelöst. 1.2

Example

Beispiel 1: Demonstration von ChoiceSet-Stilen und Mehrfachauswahl

JSON Adaptive Karte
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" } ] }

Eigenschaften

Auswahl (Version 1.0)

Choice Optionen.

  • Typ: Input.Choice[]
  • Erforderlich: Nein
  • Zulässige Werte:
    • Input.Choice

choices.data (Version 1.6)

Ermöglicht das dynamische Abrufen von Auswahlmöglichkeiten aus dem Bot, die als Vorschläge im Dropdown angezeigt werden, wenn der Benutzer im Eingabefeld eingibt.

  • Typ: Data.Query
  • Version : 1.6
  • Erforderlich: Nein
  • Zulässige Werte:
    • Data.Query

isMultiSelect (Version 1.0)

Zulassen, dass mehrere Auswahlmöglichkeiten ausgewählt werden.

  • Typ: boolean
  • Erforderlich: Nein

style (Version 1.0)

  • Typ: ChoiceInputStyle
  • Erforderlich: Nein
  • Zulässige Werte:
    • "compact"
    • "expanded"
    • "filtered": In Version 1.5 hinzugefügt. Ermöglicht Benutzern das Filtern von Auswahlmöglichkeiten in einem Auswahlsatz.

wert (Version 1.0)

Die anfängliche Auswahl (oder gruppe von Auswahlmöglichkeiten), die ausgewählt werden soll. Geben Sie für Mehrfachauswahl eine durch Trennzeichen getrennte Zeichenfolge mit Werten an.

  • Typ: string
  • Erforderlich: Nein

Platzhalter (Version 1.0)

Beschreibung der gewünschten Eingabe. Nur sichtbar, wenn keine Auswahl getroffen wurde, ist stylecompact und isMultiSelect ist false

  • Typ: string
  • Erforderlich: Nein
JSON Adaptive Karte
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)

Wenn true, Zeilenumbruch des Textes zulassen. Andernfalls wird der Text abgeschnitten.

  • Typ: boolean
  • Version : 1.2
  • Erforderlich: Nein

ID (Version 1.0)

Eindeutiger Bezeichner für den Wert. Wird verwendet, um gesammelte Eingaben zu identifizieren, wenn die Übermittlungsaktion ausgeführt wird.

  • Typ: string
  • Erforderlich: Ja

errorMessage (Version 1.3)

Fehlermeldung, die angezeigt wird, wenn eingegebene Eingabe ungültig ist

  • Typ: string
  • Version : 1.3
  • Erforderlich: Nein

isRequired (Version 1.3)

Gibt an, ob diese Eingabe erforderlich ist.

  • Typ: boolean
  • Version : 1.3
  • Erforderlich: Nein

bezeichnung (Version 1.3)

Bezeichnung für diese Eingabe

  • Typ: string
  • Version : 1.3
  • Erforderlich: Nein

labelPosition (Version 1.6)

[NUR IM JAVASCRIPT SDK UNTERSTÜTZT] Bestimmt die Position der Beschriftung. Es kann die Werte „inline“ und „above“ annehmen. Standardmäßig wird die Beschriftung "oben" platziert, wenn die Beschriftungsposition nicht angegeben wird.

  • Typ: InputLabelPosition
  • Version : 1.6
  • Erforderlich: Nein
  • Zulässige Werte:
    • "inline"
    • "above"

labelWidth (Version 1.6)

[NUR IM JAVASCRIPT SDK UNTERSTÜTZT] Bestimmt die Breite der Beschriftung in Prozent wie 40 oder eine bestimmte Pixelbreite wie "40px", wenn die Beschriftung inline mit der Eingabe platziert wird. labelWidth wird ignoriert, wenn die Beschriftung oberhalb der Eingabe angezeigt wird.

  • Typ: string, number
  • Version : 1.6
  • Erforderlich: Nein

inputStyle (Version 1.6)

[NUR IM JAVASCRIPT SDK UNTERSTÜTZT] Stilhinweise für Eingabefelder. Ermöglicht das Anzeigen von Eingabefeldern als schreibgeschützt, aber wenn der Benutzer auf das Feld klickt oder den Fokus darauf setzt, kann er diese Felder aktualisieren.

  • Typ: InputStyle
  • Version : 1.6
  • Erforderlich: Nein
  • Zulässige Werte:
    • "revealOnHover"
    • "default"

Fallback (Version 1.2)

Beschreibt, was zu tun ist, wenn ein unbekanntes Element auftritt oder die Anforderungen dieses oder eines der untergeordneten Elemente nicht erfüllt werden können.

  • Typ: Element, FallbackOption
  • Version : 1.2
  • Erforderlich: Nein
  • Zulässige Werte:
    • ActionSet
    • ColumnSet
    • Container
    • FactSet
    • Image
    • ImageSet
    • Input.ChoiceSet
    • Input.Date
    • Input.Number
    • Input.Text
    • Input.Time
    • Input.Toggle
    • Media
    • RichTextBlock
    • Table
    • TextBlock
    • "drop": Bewirkt, dass dieses Element sofort gelöscht wird, wenn unbekannte Elemente gefunden werden. Das unbekannte Element taucht nicht weiter oben auf.

Höhe (Version 1.1)

Gibt die Höhe des Elements an.

  • Typ: BlockElementHeight
  • Version : 1.1
  • Erforderlich: Nein
  • Zulässige Werte:
    • "auto": Die Höhe des Containers wird durch die Höhe des Inhalts bestimmt.
    • "stretch": Der Container dehnt seine Höhe auf die verbleibende verfügbare Höhe des übergeordneten Containers.

Trennzeichen (Version 1.0)

Wenn true, zeichnen Sie eine trennende Linie am oberen Rand des Elements.

  • Typ: boolean
  • Erforderlich: Nein

Abstand (Version 1.0)

Steuert den Abstand zwischen diesem Element und dem vorherigen Element.

  • Typ: Spacing
  • Erforderlich: Nein
  • Zulässige Werte:
    • "default"
    • "none"
    • "small"
    • "medium"
    • "large"
    • "extraLarge"
    • "padding"

isVisible (Version 1.2)

Wenn false, wird dieses Element aus dem visuellen Baum entfernt.

  • Typ: boolean
  • Version : 1.2
  • Erforderlich: Nein, Standard: true

erfordert (Version 1.2)

Eine Reihe von Schlüssel-Wert-Paaren, die Features angeben, die für das Element mit entsprechender Mindestversion erforderlich sind. Wenn ein Feature fehlt oder die Version nicht ausreichend ist, wird ein Rückfall ausgelöst.

  • Typ: Dictionary<string>
  • Version : 1.2
  • Erforderlich: Nein
  • Last updated on