Input.Text

Anmärkning

Skapar du Copilot-, Teams- eller Outlook-scenarier som drivs av adaptiva kort? Besök Adaptive Card Documentation Hub, den nya one-stop-shop för alla dina adaptiva kortbehov! Den har alla resurser du letar efter, inklusive fullständig dokumentation för många nya funktioner, till exempel dynamisk layout, ikon, märke, karusell, diagram och mycket mer!

Viktig information om tillgänglighet: I version 1.3 av schemat introducerade vi en etikettegenskap på inmatningar för att förbättra tillgängligheten. Om värdappen som du riktar in dig på stöder v1.3 bör du använda Label i stället för en TextBlock som visas i vissa exempel nedan. När de flesta värdappar har uppdaterats till den senaste versionen uppdaterar vi exemplen i enlighet med detta.

Input.Text

Låter en användare ange text.

Egenskaper för Input.Text

Fastighet Typ Krävs Description Utgåva
type "Input.Text" Yes Måste vara "Input.Text". 1.0
ID string Yes Unik identifierare för värdet. Används för att identifiera insamlade indata när åtgärden Skicka utförs. 1.0
isMultiline boolean Nej Om truetillåter du flera indatarader. 1.0
maxLength number Nej Tips om maximal längd tecken att samla in (kan ignoreras av vissa klienter). 1.0
platshållare string Nej Beskrivning av önskade indata. Visas när ingen text har angetts. 1.0
regex string Nej Reguljärt uttryck som anger det format som krävs för textinmatningen. 1.3
stil TextInputStyle Nej Formattips för textinmatning. 1.0
inlineAction ISelectAction Nej Den in-line-åtgärden för indata. Visas vanligtvis till höger om indata. Vi rekommenderar starkt att du anger en ikon för åtgärden (som visas i stället för åtgärdens rubrik). 1.2
value string Nej Det initiala värdet för det här fältet. 1.0

Ärvda egenskaper

Fastighet Typ Krävs Description Utgåva
Errormessage string Nej Felmeddelandet som ska visas när angivna indata är ogiltigt 1.3
isRequired boolean Nej Om dessa indata krävs eller inte 1.3
etikett string Nej Etikett för dessa indata 1.3
labelPosition InputLabelPosition Nej [STÖDS ENDAST I JAVASCRIPT SDK] Avgör etikettens position. Det kan innehålla värdena "i rad" och "ovan". Som standard placeras etiketten "ovan" när etikettpositionen inte har angetts. 1.6
labelWidth string, number Nej [STÖDS ENDAST I JAVASCRIPT SDK] Avgör etikettens bredd i procent som 40 eller en specifik pixelbredd som "40px" när etiketten placeras i linje med indata. labelWidth ignoreras när etiketten visas ovanför indata. 1.6
inputStyle InputStyle Nej [STÖDS ENDAST I JAVASCRIPT SDK] Formattips för indatafält. Tillåter att indatafält visas som skrivskyddade, men när användaren klickar/fokuserar på fältet kan de uppdatera dessa fält. 1.6
Fallback Element, FallbackOption Nej Beskriver vad du ska göra när ett okänt element påträffas eller om kraven för detta eller dess underordnade element inte kan uppfyllas. 1.2
höjd BlockElementHeight Nej Anger elementets höjd. 1.1
separator boolean Nej När trueritar du en avgränsande linje överst i elementet. 1.0
avstånd Spacing Nej Styr mängden avstånd mellan det här elementet och föregående element. 1.0
isVisible boolean Nej, standard: true Om falsetas det här objektet bort från det visuella trädet. 1.2
Kräver Dictionary<string> Nej En serie nyckel/värde-par som anger funktioner som objektet kräver med motsvarande lägsta version. När en funktion saknas eller inte har tillräcklig version utlöses återställningen. 1.2

Example

Exempel 1: Standard- och flerrads- och förfyllda textinmatningar

JSON Adaptivt kort
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" } ] } [Adaptivt kort Prova själv >]

Egenskaper

isMultiline (version 1.0)

Om true tillåter det, använd flera rader för inmatning.

  • Typ: boolean
  • Obligatoriskt: Nej

maxLength (version 1.0)

Antydan om maximalt antal tecken att samla in (kan ignoreras av vissa klienter).

  • Typ: number
  • Obligatoriskt: Nej

platshållare (version 1.0)

Beskrivning av önskade indata. Visas när ingen text har angetts.

  • Typ: string
  • Obligatoriskt: Nej

regex (version 1.3)

Reguljärt uttryck som anger det format som krävs för textinmatningen.

  • Typ: string
  • Version : 1.3
  • Obligatoriskt: Nej

style (version 1.0)

Formattips för textinmatning.

  • Typ: TextInputStyle
  • Obligatoriskt: Nej
  • Tillåtna värden:
    • "text"
    • "tel"
    • "url"
    • "email"
    • "password": Har lagts till i version 1.5. Visa indatatext med lösenordsmaskering.
JSON Adaptivt kort
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" } ] } [Adaptivt kort Prova själv >]

inlineAction (version 1.2)

Den in-line-åtgärden för indata. Visas vanligtvis till höger om indata. Vi rekommenderar starkt att du anger en ikon för åtgärden (som visas i stället för åtgärdens rubrik).

  • Typ: ISelectAction
  • Version : 1.2
  • Obligatoriskt: Nej
  • Tillåtna värden:
    • Action.Execute
    • Action.OpenUrl
    • Action.Submit
    • Action.ToggleVisibility
JSON Adaptivt kort
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" } } ] } [Adaptivt kort Prova själv >]

värde (version 1.0)

Det initiala värdet för det här fältet.

  • Typ: string
  • Obligatoriskt: Nej

id (version 1.0)

Unik identifierare för värdet. Används för att identifiera insamlade indata när åtgärden Skicka utförs.

  • Typ: string
  • Obligatoriskt: Ja

errorMessage (version 1.3)

Felmeddelandet som ska visas när angivna indata är ogiltigt

  • Typ: string
  • Version : 1.3
  • Obligatoriskt: Nej

isRequired (version 1.3)

Om dessa indata krävs eller inte

  • Typ: boolean
  • Version : 1.3
  • Obligatoriskt: Nej

etikett (version 1.3)

Etikett för dessa indata

  • Typ: string
  • Version : 1.3
  • Obligatoriskt: Nej

labelPosition (version 1.6)

[STÖDS ENDAST I JAVASCRIPT SDK] Avgör etikettens position. Det kan innehålla värdena "i rad" och "ovan". Som standard placeras etiketten "ovan" när etikettpositionen inte har angetts.

  • Typ: InputLabelPosition
  • Version : 1.6
  • Obligatoriskt: Nej
  • Tillåtna värden:
    • "inline"
    • "above"

labelWidth (version 1.6)

[STÖDS ENDAST I JAVASCRIPT SDK] Avgör etikettens bredd i procent som 40 eller en specifik pixelbredd som "40px" när etiketten placeras i linje med indata. labelWidth ignoreras när etiketten visas ovanför indata.

  • Typ: string, number
  • Version : 1.6
  • Obligatoriskt: Nej

inputStyle (version 1.6)

[STÖDS ENDAST I JAVASCRIPT SDK] Formattips för indatafält. Tillåter att indatafält visas som skrivskyddade, men när användaren klickar/fokuserar på fältet kan de uppdatera dessa fält.

  • Typ: InputStyle
  • Version : 1.6
  • Obligatoriskt: Nej
  • Tillåtna värden:
    • "revealOnHover"
    • "default"

sekundär alternativ (version 1.2)

Beskriver vad du ska göra när ett okänt element påträffas eller om det här eller eventuella underordnade element inte kan uppfyllas.

  • Typ: Element, FallbackOption
  • Version : 1.2
  • Obligatoriskt: Nej
  • Tillåtna värden:
    • ActionSet
    • ColumnSet
    • Container
    • FactSet
    • Image
    • ImageSet
    • Input.ChoiceSet
    • Input.Date
    • Input.Number
    • Input.Text
    • Input.Time
    • Input.Toggle
    • Media
    • RichTextBlock
    • Table
    • TextBlock
    • "drop": Gör att det här elementet tas bort omedelbart när okända element påträffas. Det okända elementet bubblar inte upp högre.

höjd (version 1.1)

Anger elementets höjd.

  • Typ: BlockElementHeight
  • Version : 1.1
  • Obligatoriskt: Nej
  • Tillåtna värden:
    • "auto": Containerns höjd bestäms av innehållets höjd.
    • "stretch": Containern sträcker ut sin höjd till den tillgängliga återstående höjden för den överordnade containern.

avgränsare (version 1.0)

När trueritar du en avgränsande linje överst i elementet.

  • Typ: boolean
  • Obligatoriskt: Nej

avstånd (version 1.0)

Styr mängden avstånd mellan det här elementet och föregående element.

  • Typ: Spacing
  • Obligatoriskt: Nej
  • Tillåtna värden:
    • "default"
    • "none"
    • "small"
    • "medium"
    • "large"
    • "extraLarge"
    • "padding"

isVisible (version 1.2)

Om falsetas det här objektet bort från det visuella trädet.

  • Typ: boolean
  • Version : 1.2
  • Obligatoriskt: Nej, standard: true

kräver (version 1.2)

En serie nyckel/värde-par som anger funktioner som objektet kräver med motsvarande lägsta version. När en funktion saknas eller inte har tillräcklig version utlöses återställningen.

  • Typ: Dictionary<string>
  • Version : 1.2
  • Obligatoriskt: Nej
  • Last updated on