Eingabe.Text

Hinweis

Erstellen Sie Copilot-, Teams- oder Outlook-Szenarien, die von adaptiven Karten unterstützt werden? Besuchen Sie den Dokumentationshub für adaptive Karten, den neuen One-Stop-Shop für alle Ihre Anforderungen an adaptive Karten! Es verfügt über alle Ressourcen, die Sie suchen, einschließlich der vollständigen Dokumentation für viele neue Features, z. B. dynamisches Layout, Symbol, Badge, Karussell, Diagramme und vieles mehr!

Wichtiger Hinweis zur Barrierefreiheit: In Version 1.3 des Schemas haben wir eine Bezeichnungseigenschaft für Eingaben eingeführt, um die Barrierefreiheit zu verbessern. Wenn die Host-App, auf die Sie abzielen , v1.3 unterstützt, sollten Sie die Bezeichnung anstelle eines TextBlock verwenden, wie in einigen Beispielen unten dargestellt. Sobald die meisten Host-Apps auf die neueste Version aktualisiert wurden, aktualisieren wir die Beispiele entsprechend.

Eingabe.Text

Ermöglicht es einem Benutzer, Text einzugeben.

Eigenschaften von Input.Text

Eigentum Typ Erforderlich Description Version
type "Input.Text" Yes Muss "Input.Text" sein. 1,0
id string Yes Eindeutiger Bezeichner für den Wert. Wird verwendet, um gesammelte Eingaben zu identifizieren, wenn die Übermittlungsaktion ausgeführt wird. 1,0
isMultiline boolean Nein Wenn true, lassen Sie mehrere Eingabezeilen zu. 1,0
MaxLength number Nein Hinweis auf zu sammelnde Zeichen mit maximaler Länge (kann von einigen Clients ignoriert werden). 1,0
Platzhalter string Nein Beschreibung der gewünschten Eingabe. Wird angezeigt, wenn kein Text eingegeben wurde. 1,0
regex string Nein Regulärer Ausdruck, der das erforderliche Format dieser Texteingabe angibt. 1.3
style TextInputStyle Nein Formatvorlagenhinweise für die Texteingabe. 1,0
inlineAction ISelectAction Nein Die Inlineaktion für die Eingabe. In der Regel rechts neben der Eingabe angezeigt. Es wird dringend empfohlen, ein Symbol für die Aktion bereitzustellen (das anstelle des Titels der Aktion angezeigt wird). 1.2
value string Nein Der Anfangswert für dieses Feld. 1,0

Geerbte Eigenschaften

Eigentum Typ Erforderlich Description Version
Errormessage string Nein Fehlermeldung, die angezeigt wird, wenn eingegebene Eingabe ungültig ist 1.3
isRequired boolean Nein Gibt an, ob diese Eingabe erforderlich ist. 1.3
Bezeichnung string Nein Bezeichnung für diese Eingabe 1.3
labelPosition InputLabelPosition Nein [NUR IM JAVASCRIPT SDK UNTERSTÜTZT] Bestimmt die Position der Beschriftung. Es kann die Werte „inline“ und „above“ annehmen. Standardmäßig wird die Beschriftung "oben" platziert, wenn die Beschriftungsposition nicht angegeben wird. 1.6
labelWidth string, number Nein [NUR IM JAVASCRIPT SDK UNTERSTÜTZT] Bestimmt die Breite der Beschriftung in Prozent wie 40 oder eine bestimmte Pixelbreite wie "40px", wenn die Beschriftung inline mit der Eingabe platziert wird. labelWidth würde ignoriert, wenn die Beschriftung oberhalb der Eingabe angezeigt wird. 1.6
inputStyle InputStyle Nein [NUR IM JAVASCRIPT SDK UNTERSTÜTZT] Stilhinweise für Eingabefelder. Ermöglicht das Anzeigen von Eingabefeldern als schreibgeschützt, aber wenn der Benutzer auf das Feld klickt oder den Fokus darauf setzt, kann er diese Felder aktualisieren. 1.6
Ausweichlösung Element, FallbackOption Nein Beschreibt, was zu tun ist, wenn ein unbekanntes Element auftritt oder dies oder alle untergeordneten Elemente nicht erfüllt werden können. 1.2
height BlockElementHeight Nein Gibt die Höhe des Elements an. 1.1
separator boolean Nein Wenn true, zeichnen Sie eine trennende Linie am oberen Rand des Elements. 1,0
Abstand Spacing Nein Steuert den Abstand zwischen diesem Element und dem vorherigen Element. 1,0
isVisible boolean Nein, Standard: true Wenn false, wird dieses Element aus dem visuellen Baum entfernt. 1.2
erfordert Dictionary<string> Nein Eine Reihe von Schlüssel-Wert-Paaren, die Features angeben, die für das Element mit entsprechender Mindestversion erforderlich sind. Wenn ein Feature fehlt oder die Version nicht ausreichend ist, wird ein Rückfall ausgelöst. 1.2

Example

Beispiel 1: Standard-, Mehrzeilen- und Vorfülltexteingaben

JSON Adaptive Karte
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" } ] } [Adaptive Karte probieren Sie es selbst >aus ]

Eigenschaften

isMultiline (Version 1.0)

Wenn true, lassen Sie mehrere Eingabezeilen zu.

  • Typ: boolean
  • Erforderlich: Nein

maxLength (Version 1.0)

Hinweis auf zu sammelnde Zeichen mit maximaler Länge (kann von einigen Clients ignoriert werden).

  • Typ: number
  • Erforderlich: Nein

Platzhalter (Version 1.0)

Beschreibung der gewünschten Eingabe. Wird angezeigt, wenn kein Text eingegeben wurde.

  • Typ: string
  • Erforderlich: Nein

regex (Version 1.3)

Regulärer Ausdruck, der das erforderliche Format dieser Texteingabe angibt.

  • Typ: string
  • Version : 1.3
  • Erforderlich: Nein

style (Version 1.0)

Stilhinweis für die Texteingabe.

  • Typ: TextInputStyle
  • Erforderlich: Nein
  • Zulässige Werte:
    • "text"
    • "tel"
    • "url"
    • "email"
    • "password": In Version 1.5 hinzugefügt. Anzeigen von Eingabetext mit Kennwortformatierung
JSON Adaptive Karte
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" } ] } [Adaptive Karte probieren Sie es selbst >aus ]

inlineAction (Version 1.2)

Die Inlineaktion für die Eingabe. In der Regel rechts neben der Eingabe angezeigt. Es wird dringend empfohlen, ein Symbol für die Aktion bereitzustellen (das anstelle des Titels der Aktion angezeigt wird).

  • Typ: ISelectAction
  • Version : 1.2
  • Erforderlich: Nein
  • Zulässige Werte:
    • Action.Execute
    • Action.OpenUrl
    • Action.Submit
    • Action.ToggleVisibility
JSON Adaptive Karte
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" } } ] } [Adaptive Karte probieren Sie es selbst >aus ]

wert (Version 1.0)

Der Anfangswert für dieses Feld.

  • Typ: string
  • Erforderlich: Nein

ID (Version 1.0)

Eindeutiger Bezeichner für den Wert. Wird verwendet, um gesammelte Eingaben zu identifizieren, wenn die Übermittlungsaktion ausgeführt wird.

  • Typ: string
  • Erforderlich: Ja

errorMessage (Version 1.3)

Fehlermeldung, die angezeigt wird, wenn eingegebene Eingabe ungültig ist

  • Typ: string
  • Version : 1.3
  • Erforderlich: Nein

isRequired (Version 1.3)

Gibt an, ob diese Eingabe erforderlich ist.

  • Typ: boolean
  • Version : 1.3
  • Erforderlich: Nein

bezeichnung (Version 1.3)

Bezeichnung für diese Eingabe

  • Typ: string
  • Version : 1.3
  • Erforderlich: Nein

labelPosition (Version 1.6)

[NUR IM JAVASCRIPT SDK UNTERSTÜTZT] Bestimmt die Position der Beschriftung. Es kann die Werte „inline“ und „above“ annehmen. Standardmäßig wird die Beschriftung "oben" platziert, wenn die Beschriftungsposition nicht angegeben wird.

  • Typ: InputLabelPosition
  • Version : 1.6
  • Erforderlich: Nein
  • Zulässige Werte:
    • "inline"
    • "above"

labelWidth (Version 1.6)

[NUR IM JAVASCRIPT SDK UNTERSTÜTZT] Bestimmt die Breite der Beschriftung in Prozent wie 40 oder eine bestimmte Pixelbreite wie "40px", wenn die Beschriftung inline mit der Eingabe platziert wird. labelWidth wird ignoriert, wenn die Beschriftung oberhalb der Eingabe angezeigt wird.

  • Typ: string, number
  • Version : 1.6
  • Erforderlich: Nein

inputStyle (Version 1.6)

[NUR IM JAVASCRIPT SDK UNTERSTÜTZT] Stilhinweise für Eingabefelder. Ermöglicht das Anzeigen von Eingabefeldern als schreibgeschützt, aber wenn der Benutzer auf das Feld klickt oder den Fokus darauf setzt, kann er diese Felder aktualisieren.

  • Typ: InputStyle
  • Version : 1.6
  • Erforderlich: Nein
  • Zulässige Werte:
    • "revealOnHover"
    • "default"

Fallback (Version 1.2)

Beschreibt, was zu tun ist, wenn ein unbekanntes Element auftritt oder die Anforderungen dieses oder eines der untergeordneten Elemente nicht erfüllt werden können.

  • Typ: Element, FallbackOption
  • Version : 1.2
  • Erforderlich: Nein
  • Zulässige Werte:
    • ActionSet
    • ColumnSet
    • Container
    • FactSet
    • Image
    • ImageSet
    • Input.ChoiceSet
    • Input.Date
    • Input.Number
    • Input.Text
    • Input.Time
    • Input.Toggle
    • Media
    • RichTextBlock
    • Table
    • TextBlock
    • "drop": Bewirkt, dass dieses Element sofort gelöscht wird, wenn unbekannte Elemente gefunden werden. Das unbekannte Element taucht nicht weiter oben auf.

Höhe (Version 1.1)

Gibt die Höhe des Elements an.

  • Typ: BlockElementHeight
  • Version : 1.1
  • Erforderlich: Nein
  • Zulässige Werte:
    • "auto": Die Höhe des Containers wird durch die Höhe des Inhalts bestimmt.
    • "stretch": Der Container dehnt seine Höhe auf die verbleibende verfügbare Höhe des übergeordneten Containers.

Trennzeichen (Version 1.0)

Wenn true, zeichnen Sie eine trennende Linie am oberen Rand des Elements.

  • Typ: boolean
  • Erforderlich: Nein

Abstand (Version 1.0)

Steuert den Abstand zwischen diesem Element und dem vorherigen Element.

  • Typ: Spacing
  • Erforderlich: Nein
  • Zulässige Werte:
    • "default"
    • "none"
    • "small"
    • "medium"
    • "large"
    • "extraLarge"
    • "padding"

isVisible (Version 1.2)

Wenn false, wird dieses Element aus dem visuellen Baum entfernt.

  • Typ: boolean
  • Version : 1.2
  • Erforderlich: Nein, Standard: true

erfordert (Version 1.2)

Eine Reihe von Schlüssel-Wert-Paaren, die Features angeben, die für das Element mit entsprechender Mindestversion erforderlich sind. Wenn ein Feature fehlt oder die Version nicht ausreichend ist, wird ein Rückfall ausgelöst.

  • Typ: Dictionary<string>
  • Version : 1.2
  • Erforderlich: Nein
  • Last updated on