Sdílet prostřednictvím

Input.ChoiceSet

Poznámka:

Vytváříte scénáře Copilotu, Teams nebo Outlooku s využitím adaptivních karet? Navštivte Adaptive Card Documentation Hub, nové komplexní centrum pro všechny vaše potřeby týkající se adaptivních karet! Obsahuje všechny prostředky, které hledáte, včetně kompletní dokumentace pro řadu nových funkcí, jako je responzivní rozložení, ikona, odznáček, karusely, grafy a mnoho dalšího.

Důležitá poznámka týkající se přístupnosti: Ve verzi 1.3 schématu jsme zavedli vlastnost popisku u vstupů za účelem zlepšení přístupnosti. Pokud hostitelská aplikace, na kterou cílíte, podporuje verzi 1.3, měli byste místo TextBlock použít label, jak je vidět v některých níže uvedených příkladech. Po aktualizaci většiny hostitelských aplikací na nejnovější verzi ukázky odpovídajícím způsobem aktualizujeme.

Input.ChoiceSet

Umožňuje uživateli zadat volbu.

Input.ChoiceSet – vlastnosti

Vlastnictví Typ Povinné Description Version
type "Input.ChoiceSet" Ano Musí být "Input.ChoiceSet". 1.0
id string Ano Jedinečný identifikátor hodnoty. Slouží k identifikaci shromážděných vstupů při provedení akce Odeslat. 1.0
volby Input.Choice[] Ne Choice Možnosti. 1.0
choices.data Data.Query Ne Umožňuje dynamické načítání voleb z robota, které se zobrazí jako návrhy v rozevíracím seznamu, když uživatel zadá do vstupního pole. 1.6
isMultiSelect boolean Ne Povolit výběr více možností 1.0
styl ChoiceInputStyle Ne 1.0
value string Ne Je třeba vybrat počáteční volbu (nebo sadu voleb). Pro vícenásobný výběr zadejte řetězec hodnot oddělený čárkami. 1.0
Zástupný string Ne Popis požadovaného vstupu Viditelné pouze v případě, že nebyl proveden žádný výběr, style je compact a isMultiSelect je false 1.0
zabalit boolean Ne Pokud true, povolte zalamování textu. V opačném případě se text ořízne. 1.2

Zděděné vlastnosti

Vlastnictví Typ Povinné Description Version
Errormessage string Ne Chybová zpráva, která se zobrazí při zadání vstupu je neplatná 1.3
isRequired boolean Ne Určuje, jestli je tento vstup povinný. 1.3
label string Ne Popisek pro tento vstup 1.3
labelPosition InputLabelPosition Ne [PODPOROVÁNO POUZE V JAVASCRIPT SDK] Určuje pozici štítku. Může obsahovat hodnoty 'řádkové' a 'nadřádkové'. Ve výchozím nastavení se popisek umístí nad, pokud není zadána pozice popisku. 1.6
labelWidth string, number Ne [PODPOROVÁNO POUZE V JAVASCRIPT SDK] Určuje šířku popisku v procentech, například 40, nebo konkrétní šířku v pixelech, například 40px, když je popisek umístěn vedle vstupního pole. LabelWidth by se ignoroval, když se popisek zobrazí nad vstupem. 1.6
inputStyle InputStyle Ne [PODPOROVÁNO POUZE V JAVASCRIPT SDK] Tipy pro stylování vstupních polí Umožňuje, aby se vstupní pole zobrazovala jen pro čtení, ale když uživatel klikne nebo se zaměřuje na dané pole, umožní jim aktualizovat tato pole. 1.6
záložní Element, FallbackOption Ne Popisuje, co dělat, když je zjištěn neznámý prvek nebo není možné splnit požadavky tohoto prvku nebo kteréhokoli z jeho podřízených prvků. 1.2
výška BlockElementHeight Ne Určuje výšku prvku. 1.1
separator boolean Ne Když true, nakreslete oddělující čáru v horní části prvku. 1.0
rozteč Spacing Ne Určuje velikost mezery mezi tímto prvkem a předchozím prvkem. 1.0
isVisible boolean Ne, výchozí nastavení: true Pokud false, bude tato položka odebrána z vizuálního stromu. 1.2
požaduje Dictionary<string> Ne Řada párů klíč/hodnota označující funkce, které položka vyžaduje s odpovídající minimální verzí. Pokud funkce chybí nebo chybí požadovaná verze, aktivuje se záložní řešení. 1.2

Example

Příklad 1: Předvedení stylů sady voleb a vícenásobný výběr

JSON Adaptivní karta
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" } ] }

Vlastnosti

choices (verze 1.0)

Choice Možnosti.

  • Typ: Input.Choice[]
  • Povinné: Ne
  • Povolené hodnoty:
    • Input.Choice

choices.data (verze 1.6)

Umožňuje dynamické načítání voleb z robota, které se zobrazí jako návrhy v rozevíracím seznamu, když uživatel zadá do vstupního pole.

  • Typ: Data.Query
  • Verze : 1.6
  • Povinné: Ne
  • Povolené hodnoty:
    • Data.Query

isMultiSelect (verze 1.0)

Povolit výběr více možností

  • Typ: boolean
  • Povinné: Ne

style (verze 1.0)

  • Typ: ChoiceInputStyle
  • Povinné: Ne
  • Povolené hodnoty:
    • "compact"
    • "expanded"
    • "filtered": Přidáno ve verzi 1.5. Umožňuje uživatelům filtrovat volby v sadě voleb.

hodnota (Verze 1.0)

Je třeba vybrat počáteční volbu (nebo sadu voleb). Pro vícenásobný výběr zadejte řetězec hodnot oddělený čárkami.

  • Typ: string
  • Povinné: Ne

zástupný symbol (verze 1.0)

Popis požadovaného vstupu Viditelné pouze v případě, že nebyl proveden žádný výběr, style je compact a isMultiSelect je false

  • Typ: string
  • Povinné: Ne
JSON Adaptivní karta
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 (Verze 1.2)

Pokud true, povolte zalamování textu. V opačném případě se text ořízne.

  • Typ: boolean
  • Verze : 1.2
  • Povinné: Ne

id (verze 1.0)

Jedinečný identifikátor hodnoty. Slouží k identifikaci shromážděných vstupů při provedení akce Odeslat.

  • Typ: string
  • Povinné: Ano

chybováZpráva (verze 1.3)

Chybová zpráva, která se zobrazí při zadání vstupu je neplatná

  • Typ: string
  • Verze : 1.3
  • Povinné: Ne

isRequired (verze 1.3)

Určuje, jestli je tento vstup povinný.

  • Typ: boolean
  • Verze : 1.3
  • Povinné: Ne

štítek (verze 1.3)

Popisek pro tento vstup

  • Typ: string
  • Verze : 1.3
  • Povinné: Ne

labelPosition (verze 1.6)

[PODPOROVÁNO POUZE V JAVASCRIPT SDK] Určuje pozici štítku. Může obsahovat hodnoty 'řádkový' a 'nad.' Ve výchozím nastavení se popisek umístí nad, pokud není zadána pozice popisku.

  • Typ: InputLabelPosition
  • Verze : 1.6
  • Povinné: Ne
  • Povolené hodnoty:
    • "inline"
    • "above"

labelWidth (Verze 1.6)

[Podporováno pouze v sadě JavaScript SDK] Určuje šířku štítku v procentech, například 40, nebo konkrétní šířku v pixelech, například '40px', je-li štítek umístěn vedle vstupu. Při zobrazení popisku nad vstupem by se labelWidth ignoroval.

  • Typ: string, number
  • Verze : 1.6
  • Povinné: Ne

inputStyle (verze 1.6)

[PODPOROVÁNO POUZE V JAVASCRIPT SDK] Tipy pro stylování vstupních polí Umožňuje, aby se vstupní pole zobrazovala jen pro čtení, ale když uživatel klikne nebo se zaměřuje na dané pole, umožní jim aktualizovat tato pole.

  • Typ: InputStyle
  • Verze : 1.6
  • Povinné: Ne
  • Povolené hodnoty:
    • "revealOnHover"
    • "default"

záložní (Verze 1.2)

Popisuje, co dělat, když je zjištěn neznámý prvek nebo když nelze splnit požadavky této nebo jakékoliv podřízené položky.

  • Typ: Element, FallbackOption
  • Verze : 1.2
  • Povinné: Ne
  • Povolené hodnoty:
    • ActionSet
    • ColumnSet
    • Container
    • FactSet
    • Image
    • ImageSet
    • Input.ChoiceSet
    • Input.Date
    • Input.Number
    • Input.Text
    • Input.Time
    • Input.Toggle
    • Media
    • RichTextBlock
    • Table
    • TextBlock
    • "drop": Způsobí okamžité vyřazení tohoto prvku, pokud jsou zjištěny neznámé elementy. Neznámý prvek se nijak výše neprojevuje.

výška (Verze 1.1)

Určuje výšku prvku.

  • Typ: BlockElementHeight
  • Verze : 1.1
  • Povinné: Ne
  • Povolené hodnoty:
    • "auto": Výška kontejneru bude určena výškou jeho obsahu.
    • "stretch": Kontejner roztáhne jeho výšku na dostupnou zbývající výšku nadřazeného kontejneru.

oddělovač (verze 1.0)

Když true, nakreslete oddělující čáru v horní části prvku.

  • Typ: boolean
  • Povinné: Ne

mezery (verze 1.0)

Určuje velikost mezery mezi tímto prvkem a předchozím prvkem.

  • Typ: Spacing
  • Povinné: Ne
  • Povolené hodnoty:
    • "default"
    • "none"
    • "small"
    • "medium"
    • "large"
    • "extraLarge"
    • "padding"

isVisible (verze 1.2)

Pokud false, bude tato položka odebrána z vizuálního stromu.

  • Typ: boolean
  • Verze : 1.2
  • Povinné: Ne, výchozí: true

vyžaduje (verze 1.2)

Řada párů klíč/hodnota označující funkce, které položka vyžaduje s odpovídající minimální verzí. Pokud funkce chybí nebo chybí požadovaná verze, aktivuje se záložní řešení.

  • Typ: Dictionary<string>
  • Verze : 1.2
  • Povinné: Ne
  • Last updated on