Input.ChoiceSet

Annotazioni

Si stanno creando scenari Copilot, Teams o Outlook basati su schede adattive? Visita l'Hub della documentazione delle Adaptive Card, il nuovo sportello unico per tutte le tue esigenze di Adaptive Card! Include tutte le risorse che si stanno cercando, inclusa la documentazione completa per molte nuove funzionalità, ad esempio layout reattivo, icona, badge, sequenza, grafici e molto altro ancora.

Nota importante sull'accessibilità: Nella versione 1.3 dello schema è stata introdotta una proprietà label negli input per migliorare l'accessibilità. Se l'app host di destinazione supporta la versione 1.3, si dovrebbe usare label anziché un TextBlock come illustrato in alcuni esempi seguenti. Dopo che la maggior parte delle app host è stata aggiornata alla versione più recente, gli esempi verranno aggiornati di conseguenza.

Scelta di input.

Consente a un utente di immettere una scelta.

Proprietà Input.ChoiceSet

Proprietà TIPO Obbligatorio Description Versione
type "Input.ChoiceSet" Yes Deve essere "Input.ChoiceSet". 1.0
ID string Yes Identificatore univoco per il valore. Usato per identificare l'input raccolto quando viene eseguita l'azione Submit. 1.0
scelte Input.Choice[] NO Choice Opzioni. 1.0
choices.data Data.Query NO Consente di recuperare dinamicamente le scelte dal bot come suggerimenti nell'elenco a discesa quando l'utente digita nel campo di input. 1.6
isMultiSelect boolean NO Consente di selezionare più opzioni. 1.0
style ChoiceInputStyle NO 1.0
value string NO Scelta iniziale (o set di scelte) da selezionare. Per la selezione multipla, specificare una stringa delimitata da virgole di valori. 1.0
segnaposto string NO Descrizione dell'input desiderato. Visibile solo quando non è stata effettuata alcuna selezione, style è compact e isMultiSelect è false 1.0
incapsulare boolean NO Se true, permettere il ritorno a capo del testo. In caso contrario, il testo viene tagliato. 1.2

Proprietà ereditate

Proprietà TIPO Obbligatorio Description Versione
Errormessage string NO Messaggio di errore da visualizzare quando l'input immesso non è valido 1.3
isRequired boolean NO Indica se questo input è obbligatorio o meno 1.3
label string NO Etichetta per questo input 1.3
labelPosition InputLabelPosition NO [SUPPORTATO SOLO IN JAVASCRIPT SDK] Determina la posizione dell'etichetta. Può accettare valori 'inline' e 'above'. Per impostazione predefinita, l'etichetta viene posizionata "sopra" quando la posizione dell'etichetta non è specificata. 1.6
labelWidth string, number NO [SUPPORTATO SOLO IN JAVASCRIPT SDK] Determina la larghezza dell'etichetta in percentuale, ad esempio 40 o una larghezza di pixel specifica, ad esempio "40px" quando l'etichetta viene posizionata inline con l'input. labelWidth viene ignorato quando l'etichetta viene visualizzata sopra l'input. 1.6
inputStyle InputStyle NO [SUPPORTATO SOLO IN JAVASCRIPT SDK] Hint di stile per i campi di input. Consente di visualizzare i campi di input come di sola lettura, ma quando l'utente fa clic/si concentra sul campo, consente di aggiornare tali campi. 1.6
Fallback Element, FallbackOption NO Descrive le operazioni da eseguire quando viene rilevato un elemento sconosciuto o quando non è possibile soddisfare le esigenze di questo o qualsiasi elemento figlio. 1.2
altezza BlockElementHeight NO Specifica l'altezza dell'elemento. 1.1
separator boolean NO Quando true, disegnare una linea di separazione nella parte superiore dell'elemento. 1.0
spaziatura Spacing NO Controlla la quantità di spaziatura tra questo elemento e l'elemento precedente. 1.0
isVisible boolean No, impostazione predefinita: true Se false, questo elemento verrà rimosso dalla struttura ad albero visuale. 1.2
Richiede Dictionary<string> NO Serie di coppie chiave/valore che indicano le funzionalità richieste dall'elemento con la versione minima corrispondente. Quando una funzionalità è mancante o di versione insufficiente, viene attivato il fallback. 1.2

Example

Esempio 1: Dimostrazione degli stili choiceSet e selezione multipla

JSON Scheda adattiva
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" } ] }

Proprietà

scelte (versione 1.0)

Choice Opzioni.

  • Tipo: Input.Choice[]
  • Obbligatorio: No
  • Valori consentiti:
    • Input.Choice

choices.data (versione 1.6)

Consente di recuperare dinamicamente le scelte dal bot come suggerimenti nell'elenco a discesa quando l'utente digita nel campo di input.

  • Tipo: Data.Query
  • Versione : 1.6
  • Obbligatorio: No
  • Valori consentiti:
    • Data.Query

isMultiSelect (versione 1.0)

Consente di selezionare più opzioni.

  • Tipo: boolean
  • Obbligatorio: No

style (versione 1.0)

  • Tipo: ChoiceInputStyle
  • Obbligatorio: No
  • Valori consentiti:
    • "compact"
    • "expanded"
    • "filtered": aggiunta nella versione 1.5. Consente agli utenti di filtrare le scelte in un set di scelte.

value (versione 1.0)

Scelta iniziale (o set di scelte) da selezionare. Per la selezione multipla, specificare una stringa delimitata da virgole di valori.

  • Tipo: string
  • Obbligatorio: No

segnaposto (versione 1.0)

Descrizione dell'input desiderato. Visibile solo quando non è stata effettuata alcuna selezione, style è compact e isMultiSelect è false

  • Tipo: string
  • Obbligatorio: No
JSON Scheda adattiva
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 (versione 1.2)

Se true, permettere il ritorno a capo del testo. In caso contrario, il testo viene tagliato.

  • Tipo: boolean
  • Versione : 1.2
  • Obbligatorio: No

id (versione 1.0)

Identificatore univoco per il valore. Usato per identificare l'input raccolto quando viene eseguita l'azione Submit.

  • Tipo: string
  • Obbligatorio: Sì

errorMessage (versione 1.3)

Messaggio di errore da visualizzare quando l'input immesso non è valido

  • Tipo: string
  • Versione : 1.3
  • Obbligatorio: No

isRequired (versione 1.3)

Indica se questo input è obbligatorio o meno

  • Tipo: boolean
  • Versione : 1.3
  • Obbligatorio: No

label (versione 1.3)

Etichetta per questo input

  • Tipo: string
  • Versione : 1.3
  • Obbligatorio: No

labelPosition (versione 1.6)

[SUPPORTATO SOLO IN JAVASCRIPT SDK] Determina la posizione dell'etichetta. Può accettare valori 'inline' e 'above'. Per impostazione predefinita, l'etichetta viene posizionata "sopra" quando la posizione dell'etichetta non è specificata.

  • Tipo: InputLabelPosition
  • Versione : 1.6
  • Obbligatorio: No
  • Valori consentiti:
    • "inline"
    • "above"

labelWidth (versione 1.6)

[SUPPORTATO SOLO IN JAVASCRIPT SDK] Determina la larghezza dell'etichetta in percentuale, ad esempio 40 o una larghezza di pixel specifica, ad esempio "40px" quando l'etichetta viene posizionata inline con l'input. labelWidth verrà ignorato quando l'etichetta viene visualizzata sopra l'input.

  • Tipo: string, number
  • Versione : 1.6
  • Obbligatorio: No

inputStyle (versione 1.6)

[SUPPORTATO SOLO IN JAVASCRIPT SDK] Hint di stile per i campi di input. Consente di visualizzare i campi di input come di sola lettura, ma quando l'utente fa clic/si concentra sul campo, consente di aggiornare tali campi.

  • Tipo: InputStyle
  • Versione : 1.6
  • Obbligatorio: No
  • Valori consentiti:
    • "revealOnHover"
    • "default"

fallback (versione 1.2)

Descrive le operazioni da eseguire quando viene rilevato un elemento sconosciuto o quando non è possibile soddisfare le esigenze di questo elemento o di eventuali elementi figli.

  • Tipo: Element, FallbackOption
  • Versione : 1.2
  • Obbligatorio: No
  • Valori consentiti:
    • ActionSet
    • ColumnSet
    • Container
    • FactSet
    • Image
    • ImageSet
    • Input.ChoiceSet
    • Input.Date
    • Input.Number
    • Input.Text
    • Input.Time
    • Input.Toggle
    • Media
    • RichTextBlock
    • Table
    • TextBlock
    • "drop": fa sì che questo elemento venga eliminato immediatamente quando vengono rilevati elementi sconosciuti. L'elemento sconosciuto non si propaga verso l'alto.

altezza (versione 1.1)

Specifica l'altezza dell'elemento.

  • Tipo: BlockElementHeight
  • Versione : 1.1
  • Obbligatorio: No
  • Valori consentiti:
    • "auto": l'altezza del contenitore verrà determinata dall'altezza del relativo contenuto.
    • "stretch": il contenitore estenderà l'altezza fino all'altezza rimanente disponibile del contenitore padre.

separatore (versione 1.0)

Quando true, disegnare una linea di separazione nella parte superiore dell'elemento.

  • Tipo: boolean
  • Obbligatorio: No

spaziatura (versione 1.0)

Controlla la quantità di spaziatura tra questo elemento e l'elemento precedente.

  • Tipo: Spacing
  • Obbligatorio: No
  • Valori consentiti:
    • "default"
    • "none"
    • "small"
    • "medium"
    • "large"
    • "extraLarge"
    • "padding"

isVisible (versione 1.2)

Se false, questo elemento verrà rimosso dalla struttura ad albero visuale.

  • Tipo: boolean
  • Versione : 1.2
  • Obbligatorio: No, impostazione predefinita: true

richiede (versione 1.2)

Serie di coppie chiave/valore che indicano le funzionalità richieste dall'elemento con la versione minima corrispondente. Quando una funzionalità è mancante o di versione insufficiente, viene attivato il fallback.

  • Tipo: Dictionary<string>
  • Versione : 1.2
  • Obbligatorio: No
  • Last updated on