ResizableTextArea Kontrolle
Eine Komponente für Benutzereingaben.
Notiz
Sie finden die vollständige Dokumentation und den Quellcode im GitHub-Codekomponenten-Repository.
Beschreibung des Dataflows
Textbereiche bieten Benutzern die Möglichkeit, Text einzugeben und zu bearbeiten. Sie werden in Formularen, modalen Dialogfeldern, Tabellen und anderen Oberflächen verwendet, in denen Texteingaben erforderlich sind.
Diese Komponente ermöglicht es dem Benutzer, die Größe des Textbereichs bequem zu ändern.
Notiz
Komponenten-Quellcode und weitere Informationen finden Sie im GitHub-Codekomponenten-Repository.
Eigenschaften
Schlüsseleigenschaften
| Eigenschaften | Beschreibung des Dataflows |
|---|---|
Text |
Der im Steuerelement festgelegte Textwert. Dies ist die standardmäßige gebundene Eigenschaft, wenn sie in einer Modellgesteuerten App verwendet wird. |
Default |
Der Standardwert, den das Steuerelement haben wird, wenn das Steuerelement zurückgesetzt oder der Standardwert geändert wird. Dadurch funktioniert das Steuerelement ähnlich wie Steuerelemente in Canvas-App-Formularen. |
MaxLength |
Die maximale Anzahl von Zeichen, die eingegeben werden können. |
HintText |
Der Text, der angezeigt wird, wenn kein Textwert festgelegt wurde. |
EmptyPlaceholderText |
Der Text, der angezeigt wird, wenn kein Wert vorhanden ist, und das Steuerelement keinen Fokus hat. Dies stellt einen ähnlichen Stil wie das Modellgesteuerte Textsteuerelement bereit, das --- anzeigt, wenn kein Wert ausgefüllt ist. |
DefaultHeight |
Die Höhe, auf die der Textbereich zu Beginn festgelegt sein soll. Wenn dies nicht in einer Canvas-App/auf einer benutzerdefinierten Seite festgelegt ist, wird die Größe standardmäßig auf die Höhe der Codekomponente eingestellt. Dies ist bei Modellgesteuerten Apps erforderlich, da das Formular keine anfängliche Höhe bereitstellt. |
DefaultWidth |
Die Breite, auf die der Textbereich anfänglich festgelegt werden soll. Wenn dies nicht in einer Canvas-App/auf einer benutzerdefinierten Seite festgelegt ist, wird die Größe standardmäßig auf die Höhe der Codekomponente eingestellt. Dies ist bei Modellgesteuerten Apps nicht erforderlich, da die Standardbreite die Breite der Formularspalte ist. |
MinHeight |
Die Mindesthöhe, auf die die textarea geändert werden kann. Für keine Begrenzung auf Null setzen. |
MaxHeight |
Die Maximalhöhe, auf die die textarea geändert werden kann. Für keine Begrenzung auf Null setzen. |
Min Width |
Die Mindestbreite, auf die die textarea geändert werden kann. Für keine Begrenzung auf Null setzen. |
MaxWidth |
Die Maximalbreite, auf die die textarea geändert werden kann. Für keine Begrenzung auf Null setzen. |
AllowResize |
Definiert, in welche Richtung die textarea geändert werden kann. „Keine“, „Beide“, „Vertikal“ oder „Horizontal“. |
EnableSpellCheck |
Definiert, ob der Browser die textarea auf Rechtschreibung prüfen soll oder nicht. |
Ausgabeeigenschaften
| Eigenschaften | Beschreibung |
|---|---|
Resized Height** (output) - The user adjusted height | Angepasste Breite** (Ausgabe) – Die vom Benutzer angepasste Breite |
Stileigenschaften
| Eigenschaften | Beschreibung des Dataflows |
|---|---|
PaddingLeft |
Der Abstand, der innerhalb der textarea hinzugefügt werden soll. |
PaddingRight |
Der Abstand, der innerhalb der textarea hinzugefügt werden soll. |
PaddingTop |
Der Abstand, der innerhalb der textarea hinzugefügt werden soll. |
PaddingBottom |
Der Abstand, der innerhalb der textarea hinzugefügt werden soll. |
Left Padding Adjustment |
In einer Modellgesteuerten App gibt es auch bei ausgeblendeter Beschriftung links neben der Codekomponente einen Abstand für Symbole (z. B. Schlosssymbol). Um dies zu korrigieren, muss die Breite verringert werden, indem die linke Abstandsanpassung auf 21 eingestellt wird. Ist auch eine Beschriftung vorhanden, muss die linke Abstandsanpassung auf die Breite der Beschriftung eingestellt werden. |
RenderBorderStyle |
Das kann entweder Normal oder Zentriert sein. Bei einer Einstellung auf „Normal“ wird die Randbreite innerhalb des Textbereichsfelds erhöht. Bei einer Verwendung von Zentriert wird der Rahmen um den Rand des Textbereichsfelds zentriert. Verwenden Sie „Zentriert“, um mit den Klassischen Power Apps-Steuerelementen kompatibel zu sein und „Normal“ für Modellgesteuerte und Fluent-UI-Steuerelemente. |
Accessibility Label |
Die Arienbeschriftung |
Nicht alle Kombinationen von Stil/Status werden von jeder Komponente implementiert. Weitere Informationen finden Sie im Abschnitt zu Statusabhängigen Stileigenschaften der GitHub-Komponentendokumentation.
Ereigniseigenschaften
| Eigenschaften | Beschreibung des Dataflows |
|---|---|
Input Event |
Legen Sie die Eigenschaft „Eingabeereignis“ auf eine Zeichenfolge fest, die im SetFocus beginnt, um den Fokus auf das Steuerelement zu legen. Sie müssen ein zufälliges Suffix angeben, damit das Ereignis ausgelöst wird. |
Andere Eigenschaften entsprechen dem standardmäßigen Texteingabesteuerelement.
Behavior
Unterstützt SetFocus als InputEvent.
Einschränkungen
Diese Codekomponente kann nur in Canvas-Apps, benutzerdefinierten Seiten und Modellgesteuerten Apps verwendet werden.
Weitere Hinweise auf Einschränkungen finden Sie im Abschnitt zu gestalterischen Herausforderungen der GitHub-Dokumentation.