Widget „Überprüfung - Textbereich“

Mit dem Spry-Widget vom Typ „Überprüfung - Textbereich“ werden gültige bzw. ungültige Zustände bei der Eingabe von Sätzen durch den Site-Besucher angezeigt. Wenn der Textbereich als erforderliches Feld definiert wurde und der Benutzer keinen Text eingibt, zeigt das Widget eine Meldung mit der Aufforderung zur Texteingabe an.

Das folgende Beispiel zeigt das Widget „Überprüfung - Textbereich“ in verschiedenen Zuständen:

Grafik in Originalgröße anzeigen

A:
Zähler für die restlichen Zeichen

B:
Textbereich-Widget im Fokus, Zeichen max.-Zustand

C:
Textbereich-Widget im Fokus, gültiger Zustand

D:
Textbereich-Widget, erforderlicher Zustand

E:
Zähler für die eingegebenen Zeichen

Das Widget „Überprüfung - Textbereich“ beinhaltet mehrere Zustände (z. B. Gültig, Ungültig, Erforderlich usw.). Sie können die Eigenschaften für diese Zustände, je nach gewünschtem Überprüfungstyp, mit dem Eigenschafteninspektor anpassen. Mit diesem Widget lassen sich unterschiedliche Aspekte überprüfen, z. B. wenn der Besucher außerhalb des Widgets klickt, bei der Texteingabe oder beim Abschicken des Formulars.

Anfangszustand
Der Widget-Zustand, in dem die Seite in den Browser geladen wird oder der Benutzer das Formular zurücksetzt.

Fokuszustand
Der Widget-Zustand, in dem der Besucher im Widget einen Einfügepunkt setzt.

Gültig-Zustand
Der Widget-Zustand, in dem der Besucher Informationen korrekt eingegeben hat und das Formular abgeschickt werden kann.

Erforderlich-Zustand
Der Widget-Zustand, in dem der Besucher keinen Text eingegeben hat.

Zeichen min.-Zustand
Der Widget-Zustand, in dem der Besucher weniger Zeichen als die Mindestanzahl im Textbereich eingegeben hat.

Zeichen max.-Zustand
Der Widget-Zustand, in dem der Benutzer im Textbereich mehr Zeichen als die Höchstanzahl zulässiger Zeichen eingegeben hat.

Wenn ein Widget „Überprüfung - Textbereich“ durch eine Benutzeraktion in einen dieser Zustände versetzt wird, wendet die Logik des Spry-Frameworks zur Laufzeit eine bestimmte CSS-Klasse auf den HTML-Container des Widgets an. Wenn der Benutzer beispielsweise ein Formular abschickt, aber keinen Text im Textbereich eingegeben hat, wendet Spry eine Klasse auf das Widget an, die zur Anzeige der Meldung „Es muss ein Wert angegeben werden“ führt. Die Regeln für Stil und Anzeige von Fehlermeldungen sind in der CSS-Regel für das Widget, hier „SpryValidationTextArea.css“, enthalten.

Das Standard-HTML für das Widget „Überprüfung - Textbereich“, normalerweise in einem Formular, enthält ein <span>-Container-Tag, das das <textarea>-Tag des Textbereichs umgibt. Das HTML für das Widget enthält außerdem Skript-Tags im Kopf des Dokuments und unterhalb des HTML-Markups des Widgets.

Eine ausführliche Erläuterung der Funktionsweise von Widgets vom Typ „Überprüfung - Textbereich“, einschließlich der vollständigen Code-Struktur, finden Sie unter www.adobe.com/go/learn_dw_sprytextarea_de.