Mashup Builder > Widgets > Standard-Widgets > Widget "Textbereich"
Widget "Textbereich"
Das Widget "Textbereich" ermöglicht es dem Mashup-Benutzer, einen mehrzeiligen Text in einem Mashup einzugeben.
* 
Das Widget "Textbereich" ist als Standard-Widget in ThingWorx Platform und als Webkomponente verfügbar, die aus einem SDK importiert werden kann.
Standardmäßige Widget-Größenanpassung
Die Größenanpassung des Widgets "Textbereich" variiert je nach Ihrer Version von ThingWorx:
In ThingWorx 9.3.2 und höher ist das Widget standardmäßig reaktionsfähig. Wenn Sie es einem leeren Container hinzufügen, wird er erweitert, um den gesamten verfügbaren Platz im Container zu füllen.
In früheren Versionen von ThingWorx hat das Widget eine Standardbreite und -höhe, die Sie mithilfe von Eigenschaften manuell anpassen können.
Wenn Sie zu ThingWorx 9.3.2 oder höher migrieren, füllen Widgets des Typs "Textbereich", die als einzelnes Widget innerhalb eines Containers angezeigt werden, den gesamten verfügbaren Platz im Container. Diese Änderung kann sich auf das Layout des Mashups auswirken. Stellen Sie sicher, dass Sie das Mashup-Layout anpassen, um das Layout zu aktualisieren. Weitere Informationen finden Sie in den folgenden Abschnitten.
Widget-Größenanpassung in ThingWorx 9.3.1 und früher
Standardmäßig wird der Textbereich mit Standardbemaßungen für Breite und Höhe angezeigt. Die Breite wird auf einen festen Wert festgelegt. Die Höhe wird jedoch auf Autosize festgelegt, damit das Widget vertikal wachsen kann. Während der Eingabe wird das Widget erweitert, sodass zusätzliche Zeichen angezeigt werden, wenn der Text den verfügbaren Platz überschreitet, bis der in der Eigenschaft MaxNumberOfCharacters definierte Wert erreicht ist. Sie können zusätzliche Widgets hinzufügen und das Layout mithilfe der Ausrichtungs- und Verteilungsoptionen im Menü Layout steuern. Die folgende Abbildung zeigt das Widget in einem Mashup-Layout:
Das Layout ist wie folgt aufgeteilt:
1. Ein reaktionsfähiger Container, der vier Widgets enthält: eine Beschriftung, zwei Textfelder und einen Textbereich.
2. Ein fester Container mit zwei Schaltflächen.
Die Widget-Breite wird auf einen festen Wert festgelegt. Die Höhe ist jedoch auf Autosize festgelegt, damit das Widget vertikal erweitert werden kann, wenn die Anzahl der Zeichen größer als der verfügbare Platz ist. Sie können die Eigenschaften Width und Height verwenden, um die Widget-Größe anzupassen. Eine Ellipse wird angezeigt.
Widget-Größenanpassung in ThingWorx 9.3.2 und höher
Wenn Sie das Widget zu einem neuen oder vorhandenen Mashup hinzufügen, werden seine Standardbemaßungen entsprechend der Größe des zugehörigen Containers festgelegt. Das Widget wird automatisch erweitert, um den verfügbaren Platz innerhalb des Containers zu füllen. Sie müssen das Container-Layout mit dem Fensterbereich Layout konfigurieren, um die Widget-Bemaßungen relativ zum Layout anzupassen. Wenn das Widget auf den Container erweitert wird, sind die Eigenschaften Width und Height nicht im Fensterbereich Eigenschaften aufgeführt. Das Hinzufügen zusätzlicher Widgets zum Textbereich-Container stellt die frühere Größenanpassung wieder her. Die folgende Abbildung zeigt das Widget in einem reaktionsfähigen Container in Version 9.3.2 oder höher der ThingWorx Plattform.
Das Layout ist wie folgt aufgeteilt:
1. Ein statischer Container mit einer festen Höhe, der drei Widgets enthält: ein Widget "Beschriftung" und zwei Textfeld-Widgets. Die Richtung der Elemente ist auf Vertikal festgelegt.
2. Ein reaktionsfähiger Container mit einem Textbereich-Widget.
3. Ein statischer Container, der zwei Schaltflächen anzeigt.
Wenn Sie das Widget mithilfe eines separaten Containers anzeigen, können Sie reaktionsfähigere Layouts erstellen. Die folgende Abbildung zeigt die vorherige Form, wenn mehr Platz für das Mashup verfügbar ist. Beachten Sie, dass der Textbereich mit seinem Container wächst und die Textfelder dieselbe Größe aufweisen.
Widget-Eigenschaften
Die Eigenschaften des Widgets "Textbereich" sind unten aufgelistet.
Eigenschaftenname
Beschreibung
Basistyp
Standardwert
Bindung möglich? (J/N)
Lokalisierbar? (J/N)
Text
Text, der im Textbereich angezeigt wird.
STRING
N/A
J
J
Label
Text, der als Beschriftung für den Textbereich angezeigt wird.
STRING
N/A
J
J
Counter
Zählt die Anzahl der Zeichen, die in den Textbereich eingegeben werden, und zeigt sie an.
BOOLEAN
False
N
N
MaxNumberOfCharacters
Ermöglicht das Festlegen einer maximalen Anzahl von zulässigen Zeichen im Textbereich.
NUMBER
100
J
N
HintText
Zeigt Platzhaltertext an, der erklärt, was in das Feld eingegeben werden soll.
STRING
N/A
N
J
Disabled
Verwenden Sie diese Eigenschaft, um das Widget im Mashup zu deaktivieren. Das Widget wird im Mashup angezeigt, Sie können jedoch nicht darauf klicken.
BOOLEAN
False
J
N
ReadOnly
Ermöglicht das Festlegen des Textbereichs als schreibgeschützt, sodass der Benutzer den enthaltenen Text nicht bearbeiten kann.
BOOLEAN
False
N
N
TextAlignment
Ermöglicht das Ausrichten des Texts links oder rechts.
STRING
Links
N
N
LabelAlignment
Ermöglicht das Ausrichten der Beschriftung links, rechts oder in der Mitte.
STRING
Links
N
N
TabSequence
Die Sequenz, in der Widgets hervorgehoben werden, wenn ein Benutzer die Tabstopp-Taste drückt.
NUMBER
N/A
N
N
CustomClass
Ermöglicht das Definieren des CSS für das oberste div-Element des Widgets. Es können mehrere Klassen, getrennt durch ein Leerzeichen, eingegeben werden.
STRING
N/A
J
N
Changed
Ereignis, das ausgelöst wird, wenn die Daten geändert werden.
N/A
N/A
J
N
ResetToDefaultValue
Setzt die Eingaben für dieses Widget auf ihre Standardwerte zurück.
N/A
N/A
J
N
Width
Breite des Widgets.
In ThingWorx 9.3.2 oder höher ist diese Eigenschaft ausgeblendet, es sei denn, Sie fügen das Widget einem Container mit einem oder mehreren Widgets hinzu.
NUMBER
273
N
N
Height
Höhe des Widgets. Sie wird standardmäßig automatisch berechnet. Geben Sie einen Wert im Eigenschaftsfensterbereich ein, oder ändern Sie die Größe des Widgets im Zeichenbereich, um eine feste Höhe festzulegen. In ThingWorx 9.3.2 oder höher ist diese Eigenschaft ausgeblendet, es sei denn, Sie fügen das Widget einem Container mit einem oder mehreren Widgets hinzu.
NUMBER
Automatisch anpassen
N
N
MinWidth
Legt die minimale Breite des Widgets fest, wenn es zu einem reaktionsfähigen Container in ThingWorx 9.3.2 oder höher hinzugefügt wird.
NUMBER
N/A
N
N
TextChanged
Ein bindbares Ereignis, das ausgelöst wird, wenn Sie nach dem Aktualisieren des Widget-Werts auf einen Bereich außerhalb des Widgets klicken.
N/A
N/A
J
N
TooltipField
Legt einen Tooltip-Text fest, der angezeigt wird, wenn Sie mit der Maus auf das Widget zeigen.
STRING
N/A
J
J
TooltipIcon
Legt ein Symbolbild für den Tooltip des Widgets fest.
Sie können ein Bild hinzufügen oder einen Bild-URL-Pfad angeben.
MEDIA ENTITY
N/A
N
N
Widget-Daten validieren
Zusätzlich zu den allgemeinen Validierungseigenschaften können Sie die Eigenschaften MaxLength und MinLength verwenden, um die Anzahl der Zeichen im Widget "Textbereich" zu validieren.
Sie können die Standardfehlermeldungen mit den Eigenschaften MaxLengthFailureMessage und MinLengthFailureMessage anpassen. Die Höchst- und Mindestwerte werden in den Meldungen mit dem Parameter ${value} angezeigt.
Weitere Informationen zur Verwendung der allgemeinen Validierungseigenschaften finden Sie unter Validierung auf Widgets anwenden.
In der folgenden Tabelle werden Validierungseigenschaften aufgeführt, die im Fensterbereich Validierung verfügbar sind.
Eigenschaft
Beschreibung
Basistyp
Standardwert
Bindbar (J/N)
Lokalisierbar (J/N)
CriteriaMessage
Die Meldung, die für die Validierungskriterien und beim Fehlschlagen der Validierung angezeigt wird.
STRING
N/A
J
J
CriteriaMessageDetails
Details, die für die Validierungskriterien und die Fehlermeldung angezeigt werden sollen.
STRING
N/A
J
J
MaxLength
Die maximale Länge für den Textbereichswert.
STRING
N/A
J
N
MaxLengthFailureMessage
Die Meldung, die angezeigt wird, wenn der aktuelle Wert die maximale Zeichenlänge überschreitet.
STRING
${value} characters is the maximum
J
J
MinLength
Die minimale Länge für den Textbereichswert.
STRING
N/A
J
N
MinLengthFailureMessage
Die Meldung, die angezeigt wird, wenn der aktuelle Wert unter der minimalen Zeichenlänge ist.
STRING
${value} characters is the minimum
J
J
RequiredMessage
Die Meldung, die angezeigt wird, wenn "Wert erforderlich" auf "true" festgelegt und kein Element ausgewählt ist.
STRING
Ein Wert ist erforderlich
J
J
ShowValidationCriteria
Zeigt eine Hinweismeldung über die erforderliche Eingabe an, wenn der Textbereich bearbeitet wird.
BOOLEAN
False
J
N
ShowValidationFailure
Zeigt eine Fehlermeldung an, wenn die Validierung des eingegebenen Werts fehlschlägt.
BOOLEAN
False
J
N
ShowValidationState
Ein bindbarer Dienst, der es Ihnen ermöglicht, den Validierungsstatus anzuzeigen, bevor ein Benutzer zur Laufzeit mit dem Widget interagiert. Standardmäßig wird der Validierungsstatus nur nach einer Benutzerinteraktion angezeigt.
Dienst
N/A
In
N
ShowValidationSuccess
Zeigt eine Erfolgsmeldung an, wenn die Validierung des eingegebenen Werts erfolgreich ist.
BOOLEAN
False
J
N
SuccessMessage
Die Meldung, die angezeigt wird, wenn die Validierung erfolgreich ist.
STRING
N/A
J
J
SuccessMessageDetails
Eine sekundäre Meldung, die mehr Informationen zur Validierungserfolg-Meldung anzeigt.
STRING
N/A
J
J
Validate
Ein bindbares Ereignis, das ausgelöst wird, wenn der Widget-Wert sich ändert. Binden Sie dieses Ereignis an den Dienst oder die Funktion, um ein Validierungsmuster oder einen Ausdruck anzuwenden.
Ereignis
N/A
J
N
ValidationCriteriaIcon
SVG-Symbol auswählen, das in der Hinweisnachricht für die Validierungskriterien angezeigt wird.
IMAGELINK
info
N
N
ValidationFailureIcon
Legt das SVG-Symbol so fest, dass es in der Statusmeldung angezeigt wird, wenn die Validierung fehlschlägt.
IMAGELINK
error
N
N
ValidationOutput
Ruft die Ausgabe der Widget-Validierung ab. Zurückgegebene Werte sind Undefined, Unvalidated, Valid oder Invalid.
STRING
N/A
J
N
ValidationState
Eine bindbare Eigenschaft, die den Validierungsstatus festlegt. Sie können diese Eigenschaft auf Undefined, Unvalidated, Valid oder Invalid festlegen.
STRING
Undefined
J
N
ValidationSuccessIcon
SVG-Symbol auswählen, das in der Statusmeldung angezeigt wird, wenn die Validierung erfolgreich ist.
IMAGELINK
success
N
N
ValueRequired
Auswahl eines Elements in der Liste erforderlich machen.
BOOLEAN
False
J
N
War dies hilfreich?