Input.Text

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.

Input.Text

Consente a un utente di immettere testo.

Proprietà di Input.Text

Proprietà TIPO Obbligatorio Description Versione
type "Input.Text" Yes Deve essere "Input.Text". 1.0
ID string Yes Identificatore univoco per il valore. Usato per identificare l'input raccolto quando viene eseguita l'azione Submit. 1.0
isMultiline boolean NO Se true, permettere l'inserimento di più righe. 1.0
maxLength number NO Suggerimento del numero massimo di caratteri da raccogliere (può essere ignorato da alcuni clienti). 1.0
segnaposto string NO Descrizione dell'input desiderato. Visualizzato quando non è stato immesso alcun testo. 1.0
regex string NO Espressione regolare che indica il formato richiesto di questo input di testo. 1.3
style TextInputStyle NO Hint di stile per l'input di testo. 1.0
inlineAction ISelectAction NO Azione inline per l'input. In genere visualizzato a destra dell'input. È consigliabile fornire un'icona sull'azione (che verrà visualizzata anziché il titolo dell'azione). 1.2
value string NO Valore iniziale per questo campo. 1.0

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: Input di testo predefiniti, multilinea e precompilati

JSON Scheda adattiva
json { "$schema": "http://adaptivecards.io/schemas/adaptive-card.json", "type": "AdaptiveCard", "version": "1.0", "body": [ { "type": "TextBlock", "text": "Default text input" }, { "type": "Input.Text", "id": "defaultInputId", "placeholder": "enter comment", "maxLength": 500 }, { "type": "TextBlock", "text": "Multiline text input" }, { "type": "Input.Text", "id": "multilineInputId", "placeholder": "enter comment", "maxLength": 500, "isMultiline": true }, { "type": "TextBlock", "text": "Pre-filled value" }, { "type": "Input.Text", "id": "prefilledInputId", "placeholder": "enter comment", "maxLength": 500, "isMultiline": true, "value": "This value was pre-filled" } ], "actions": [ { "type": "Action.Submit", "title": "OK" } ] } Prova tu stesso la scheda adattiva >

Proprietà

isMultiline (versione 1.0)

Se true, consentire l'inserimento di più righe.

  • Tipo: boolean
  • Obbligatorio: No

maxLength (versione 1.0)

Suggerimento per la lunghezza massima dei caratteri da utilizzare (può essere ignorato da alcuni clienti).

  • Tipo: number
  • Obbligatorio: No

segnaposto (versione 1.0)

Descrizione dell'input desiderato. Visualizzato quando non è stato immesso alcun testo.

  • Tipo: string
  • Obbligatorio: No

regex (versione 1.3)

Espressione regolare che indica il formato richiesto di questo input di testo.

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

style (versione 1.0)

Hint di stile per l'input di testo.

  • Tipo: TextInputStyle
  • Obbligatorio: No
  • Valori consentiti:
    • "text"
    • "tel"
    • "url"
    • "email"
    • "password": aggiunta nella versione 1.5. Visualizzare il testo di input mascherato con la password.
JSON Scheda adattiva
json { "$schema": "http://adaptivecards.io/schemas/adaptive-card.json", "type": "AdaptiveCard", "version": "1.3", "body": [ { "type": "TextBlock", "text": "Specify the type of text being requested:", "style": "heading" }, { "type": "Input.Text", "id": "myComment", "label": "style: text", "style": "text" }, { "type": "Input.Text", "id": "myEmail", "label": "style: email", "style": "email" }, { "type": "Input.Text", "id": "myTel", "label": "style: tel", "style": "tel" }, { "type": "Input.Text", "id": "myUrl", "label": "style: url", "style": "url" }, { "type": "Input.Text", "id": "myPassword", "label": "style: password", "style": "password" } ], "actions": [ { "type": "Action.Submit", "title": "OK" } ] } Prova tu stesso la scheda adattiva >

inlineAction (versione 1.2)

Azione inline per l'input. In genere visualizzato a destra dell'input. È consigliabile fornire un'icona sull'azione (che verrà visualizzata anziché il titolo dell'azione).

  • Tipo: ISelectAction
  • Versione : 1.2
  • Obbligatorio: No
  • Valori consentiti:
    • Action.Execute
    • Action.OpenUrl
    • Action.Submit
    • Action.ToggleVisibility
JSON Scheda adattiva
json { "$schema": "http://adaptivecards.io/schemas/adaptive-card.json", "type": "AdaptiveCard", "version": "1.5", "body": [ { "type": "Input.Text", "id": "iconInlineActionId", "label": "Text input with an inline action", "inlineAction": { "type": "Action.Submit", "iconUrl": "https://adaptivecards.io/content/send.png", "tooltip": "Send" } }, { "type": "Input.Text", "label": "Text input with an inline action with no icon", "id": "textInlineActionId", "inlineAction": { "type": "Action.OpenUrl", "title": "Reply", "tooltip": "Reply to this message", "url": "https://adaptivecards.io" } } ] } Prova tu stesso la scheda adattiva >

value (versione 1.0)

Valore iniziale per questo campo.

  • Tipo: string
  • 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