Choice interface

Paket:

botbuilder-dialogs

Eine Instanz einer Auswahl, die verwendet werden kann, um eine Auswahl für einen Benutzer zu rendern oder etwas zu erkennen, das ein Benutzer ausgewählt hat.

Hinweise

Der Wert wird für einen Benutzer gerendert, es sei denn, es wird eine Aktion bereitgestellt. In diesem Fall werden die Aktionen title für den Benutzer gerendert.

Zur Erkennungszeit wird immer das value sein, was von findChoices() und recognizeChoices()zurückgegeben wird. Standardmäßig wird die Benutzeräußerung mit allen in der Auswahl angegebenen Zeichenfolgen verglichen. Sie können die Verwendung von und/oder action.title während der value Erkennung mithilfe der FindChoicesOptions -Struktur deaktivieren.

const choice = {
    value: 'red',
    action: {
        type: 'imBack',
        title: 'The Red Pill',
        value: 'red pill'
    },
    synonyms: ['crimson', 'scarlet', 'ruby', 'cherry']
};

Eigenschaften

action	(Optional) Aktion, die beim Rendern der Auswahl als vorgeschlagene Aktion verwendet werden soll. Dies MUSS eine vollständige Aktion sein, die die Felder , titleund value enthälttype. Wenn nicht angegeben wird, wird eine imBack Aktion basierend auf dem Feld "choices value " generiert.
synonyms	(Optional) Liste der Synonyme, die zusätzlich zu den Wert - und Aktionsfeldern erkannt werden sollen.
value	Wert, der zurückgegeben werden soll, wenn er von erkannt wird findChoices(). Wird auch verwendet, um dem Benutzer Auswahlmöglichkeiten zu rendern, wenn keine Aktion bereitgestellt wird.

Details zur Eigenschaft

action

(Optional) Aktion, die beim Rendern der Auswahl als vorgeschlagene Aktion verwendet werden soll. Dies MUSS eine vollständige Aktion sein, die die Felder , titleund value enthälttype. Wenn nicht angegeben wird, wird eine imBack Aktion basierend auf dem Feld "choices value " generiert.

action?: CardAction

Eigenschaftswert

CardAction

synonyms

(Optional) Liste der Synonyme, die zusätzlich zu den Wert - und Aktionsfeldern erkannt werden sollen.

synonyms?: string[]

Eigenschaftswert

string[]

value

Wert, der zurückgegeben werden soll, wenn er von erkannt wird findChoices(). Wird auch verwendet, um dem Benutzer Auswahlmöglichkeiten zu rendern, wenn keine Aktion bereitgestellt wird.

value: string

Eigenschaftswert

string