Invoer.Tekst

Opmerking

Bouwt u Copilot-, Teams- of Outlook-scenario's op basis van adaptieve kaarten? Ga naar Adaptive Card Documentation Hub, de nieuwe one-stop-shop voor al uw adaptieve kaartbehoeften. Het bevat alle resources die u zoekt, inclusief volledige documentatie voor veel nieuwe functies, zoals Responsieve indeling, Pictogram, Badge, Carrousel, Grafieken en nog veel meer!

Belangrijke opmerking over toegankelijkheid: In versie 1.3 van het schema hebben we een labeleigenschap geïntroduceerd op Invoer om de toegankelijkheid te verbeteren. Als de Host-app die u als doel hebt , v1.3 ondersteunt, moet u een label gebruiken in plaats van een TextBlock , zoals in enkele voorbeelden hieronder wordt weergegeven. Zodra de meeste Host-apps zijn bijgewerkt naar de nieuwste versie, werken we de voorbeelden dienovereenkomstig bij.

Invoer.Tekst

Hiermee kan een gebruiker tekst invoeren.

Eigenschappen van Input.Text

Vastgoed Typologie Verplicht Description Versie
type "Input.Text" Yes Moet "Input.Text"zijn. 1.0
ID string Yes Unieke id voor de waarde. Wordt gebruikt om verzamelde invoer te identificeren wanneer de actie Verzenden wordt uitgevoerd. 1.0
isMultiline boolean Nee. Als u true meerdere regels invoer toestaat. 1.0
maxLength number Nee. Hint van maximale lengte tekens die moeten worden verzameld (kan worden genegeerd door sommige clients). 1.0
Tijdelijke aanduiding string Nee. Beschrijving van de gewenste invoer. Wordt weergegeven wanneer er geen tekst is ingevoerd. 1.0
regex- string Nee. Reguliere expressie die de vereiste notatie van deze tekstinvoer aangeeft. 1.3
stijl TextInputStyle Nee. Stijlhint voor tekstinvoer. 1.0
inlineAction ISelectAction Nee. De inlineactie voor de invoer. Meestal rechts van de invoer weergegeven. Het is raadzaam om een pictogram op te geven voor de actie (die wordt weergegeven in plaats van de titel van de actie). 1.2
value string Nee. De initiële waarde voor dit veld. 1.0

Overgenomen eigenschappen

Vastgoed Typologie Verplicht Description Versie
Errormessage string Nee. Foutbericht dat moet worden weergegeven wanneer invoer ongeldig is 1.3
isRequired boolean Nee. Of deze invoer al dan niet vereist is 1.3
etiket string Nee. Label voor deze invoer 1.3
labelPosition InputLabelPosition Nee. [ALLEEN ONDERSTEUND IN JAVASCRIPT SDK] Bepaalt de positie van het label. Deze parameter kan de waarden 'inline' en 'boven' aannemen. Standaard wordt het label 'boven' geplaatst wanneer de labelpositie niet is opgegeven. 1.6
labelWidth string, number Nee. [ALLEEN ONDERSTEUND IN JAVASCRIPT SDK] Bepaalt de breedte van het label in procenten zoals 40 of een specifieke pixelbreedte zoals '40px' wanneer het label inline wordt geplaatst met de invoer. labelWidth wordt genegeerd wanneer het label boven de invoer wordt weergegeven. 1.6
inputStyle InputStyle Nee. [ALLEEN ONDERSTEUND IN JAVASCRIPT SDK] Hint voor stijl voor invoervelden. Hiermee kunnen invoervelden worden weergegeven als alleen-lezen, maar wanneer de gebruiker op het veld klikt/zich richt, kunnen deze velden worden bijgewerkt. 1.6
Fallback Element, FallbackOption Nee. Hierin wordt beschreven wat u moet doen wanneer een onbekend element wordt aangetroffen of wanneer niet kan worden voldaan aan de vereisten van dit element of van eventuele onderliggende elementen. 1.2
hoogte BlockElementHeight Nee. Geeft de hoogte van het element op. 1.1
separator boolean Nee. Wanneer true, tekent u een scheidingslijn bovenaan het element. 1.0
Afstand Spacing Nee. Hiermee bepaalt u de hoeveelheid afstand tussen dit element en het voorgaande element. 1.0
isVisible boolean Nee, standaard: true Als false, zal dit item worden verwijderd uit de visuele boom. 1.2
Vereist Dictionary<string> Nee. Een reeks sleutel-/waardeparen die aangeven welke functies het item nodig heeft met de bijbehorende minimale versie. Wanneer een functie ontbreekt of een onvoldoende versieniveau heeft, wordt fallback geactiveerd. 1.2

Example

Voorbeeld 1: Standaardinvoer, meerdere regels en vooraf ingevulde tekst

JSON Adaptieve kaart
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" } ] } [Adaptieve kaart probeer het zelf >]

Eigenschappen

isMultiline (versie 1.0)

Als true is ingeschakeld, sta meerdere regels invoer toe.

  • Typ: boolean
  • Vereist: Nee

maxLength (versie 1.0)

Aanwijzing van maximale lengte tekens om te verzamelen (kan door sommige clients worden genegeerd).

  • Typ: number
  • Vereist: Nee

tijdelijke aanduiding (versie 1.0)

Beschrijving van de gewenste invoer. Wordt weergegeven wanneer er geen tekst is ingevoerd.

  • Typ: string
  • Vereist: Nee

regex (versie 1.3)

Reguliere expressie die de vereiste notatie van deze tekstinvoer aangeeft.

  • Typ: string
  • Versie : 1.3
  • Vereist: Nee

stijl (versie 1.0)

Stijlhint voor tekstinvoer.

  • Typ: TextInputStyle
  • Vereist: Nee
  • Toegestane waarden:
    • "text"
    • "tel"
    • "url"
    • "email"
    • "password": Toegevoegd in versie 1.5. Invoertekst weergeven met wachtwoordmaskering.
JSON Adaptieve kaart
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" } ] } [Adaptieve kaart probeer het zelf >]

inlineAction (versie 1.2)

De inlineactie voor de invoer. Meestal rechts van de invoer weergegeven. Het is raadzaam om een pictogram op te geven voor de actie (die wordt weergegeven in plaats van de titel van de actie).

  • Typ: ISelectAction
  • Versie : 1.2
  • Vereist: Nee
  • Toegestane waarden:
    • Action.Execute
    • Action.OpenUrl
    • Action.Submit
    • Action.ToggleVisibility
JSON Adaptieve kaart
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" } } ] } [Adaptieve kaart probeer het zelf >]

waarde (versie 1.0)

De initiële waarde voor dit veld.

  • Typ: string
  • Vereist: Nee

id (versie 1.0)

Unieke id voor de waarde. Wordt gebruikt om verzamelde invoer te identificeren wanneer de actie Verzenden wordt uitgevoerd.

  • Typ: string
  • Vereist: Ja

errorMessage (versie 1.3)

Foutbericht dat moet worden weergegeven wanneer invoer ongeldig is

  • Typ: string
  • Versie : 1.3
  • Vereist: Nee

isRequired (versie 1.3)

Of deze invoer al dan niet vereist is

  • Typ: boolean
  • Versie : 1.3
  • Vereist: Nee

label (versie 1.3)

Label voor deze invoer

  • Typ: string
  • Versie : 1.3
  • Vereist: Nee

labelPosition (versie 1.6)

[ALLEEN ONDERSTEUND IN JAVASCRIPT SDK] Bepaalt de positie van het label. Deze parameter kan de waarden 'inline' en 'boven' aannemen. Standaard wordt het label 'boven' geplaatst wanneer de labelpositie niet is opgegeven.

  • Typ: InputLabelPosition
  • Versie : 1.6
  • Vereist: Nee
  • Toegestane waarden:
    • "inline"
    • "above"

labelWidth (versie 1.6)

[ALLEEN ONDERSTEUND IN JAVASCRIPT SDK] Bepaalt de breedte van het label in procenten zoals 40 of een specifieke pixelbreedte zoals '40px' wanneer het label inline wordt geplaatst met de invoer. labelWidth wordt genegeerd wanneer het label boven de invoer wordt weergegeven.

  • Type: string, number
  • Versie : 1.6
  • Vereist: Nee

inputStyle (versie 1.6)

[ALLEEN ONDERSTEUND IN JAVASCRIPT SDK] Hint voor stijl voor invoervelden. Hiermee kunnen invoervelden worden weergegeven als alleen-lezen, maar wanneer de gebruiker op het veld klikt/zich richt, kunnen deze velden worden bijgewerkt.

  • Typ: InputStyle
  • Versie : 1.6
  • Vereist: Nee
  • Toegestane waarden:
    • "revealOnHover"
    • "default"

fallback (Versie 1.2)

Hierin wordt beschreven wat u moet doen wanneer een onbekend element wordt aangetroffen of wanneer niet kan worden voldaan aan de vereisten van dit of enige onderliggende elementen.

  • Type: Element, FallbackOption
  • Versie : 1.2
  • Vereist: Nee
  • Toegestane waarden:
    • ActionSet
    • ColumnSet
    • Container
    • FactSet
    • Image
    • ImageSet
    • Input.ChoiceSet
    • Input.Date
    • Input.Number
    • Input.Text
    • Input.Time
    • Input.Toggle
    • Media
    • RichTextBlock
    • Table
    • TextBlock
    • "drop": zorgt ervoor dat dit element onmiddellijk wordt verwijderd wanneer er onbekende elementen worden aangetroffen. Het onbekende element komt niet hoger naar boven.

hoogte (versie 1.1)

Geeft de hoogte van het element op.

  • Typ: BlockElementHeight
  • Versie : 1.1
  • Vereist: Nee
  • Toegestane waarden:
    • "auto": De hoogte van de container wordt bepaald door de hoogte van de inhoud.
    • "stretch": De container zal zijn hoogte tot de beschikbare resterende hoogte van de bovenliggende container uitbreiden.

scheidingsteken (versie 1.0)

Wanneer true, tekent u een scheidingslijn bovenaan het element.

  • Typ: boolean
  • Vereist: Nee

afstand (versie 1.0)

Hiermee bepaalt u de hoeveelheid afstand tussen dit element en het voorgaande element.

  • Typ: Spacing
  • Vereist: Nee
  • Toegestane waarden:
    • "default"
    • "none"
    • "small"
    • "medium"
    • "large"
    • "extraLarge"
    • "padding"

isVisible (versie 1.2)

Als false, zal dit item worden verwijderd uit de visuele boom.

  • Typ: boolean
  • Versie : 1.2
  • Vereist: Nee, standaard: true

vereist (versie 1.2)

Een reeks sleutel-/waardeparen die aangeven welke functies het item nodig heeft met de bijbehorende minimale versie. Wanneer een functie ontbreekt of een onvoldoende versieniveau heeft, wordt fallback geactiveerd.

  • Typ: Dictionary<string>
  • Versie : 1.2
  • Vereist: Nee
  • Last updated on