Die Darstellung eines JSF-Steuerelements ändern

Sie können das Aussehen eines JSF-Steuerelements (JavaServer Faces) mithilfe von EGL-Code ändern und so zum Beispiel die Schriftfarbe ändern. Um größere Änderungen am Aussehen des Steuerelements durch Ändern dessen Darstellungsklasse vorzunehmen, lesen Sie das Kapitel Die Darstellungsklasse eines JSF-Steuerelements ändern.

Für diese Task gelten die folgenden Voraussetzungen: Nähere Informationen zu diesen Vorbedingungen finden Sie im Kapitel Mit dem Quellenassistent auf den JSF-Komponentenbaum zugreifen.
Führen Sie die folgenden Schritte aus, um die Darstellung eines JSF-Steuerelements von einem EGL-JSF-Handler aus zu ändern:
  1. Drücken Sie in einer leeren Zeile innerhalb einer Funktion im JSF-Handler Strg+Umschalt+Z. Das Fenster 'EGL-Quellenassistent' wird geöffnet und die JSF-Steuerelemente werden auf der Seite angezeigt.
  2. Wählen Sie im Fenster 'EGL-Quellenassistent' das JSF-Steuerelement aus, auf das Sie zugreifen möchten.
  3. Klicken Sie auf 'OK'.
    Im EGL-Quellenassistent werden zwei Zeilen EGL-Code zum JSF-Handler hinzugefügt. Mit der ersten Zeile wird eine EGL-Variable des Typs definiert, der mit dem ausgewählten JSF-Steuerelement übereinstimmt. Mit der zweiten Zeile wird diese Variable dem JSF-Steuerelement zugeordnet. Der Code zum Zugreifen auf ein JSF-Eingabetextsteuerelement könnte zum Beispiel folgendermaßen aussehen:
    text1 HtmlInputText;
    text1 = myViewRoot.findComponent("form1:text1");
  4. Ändern Sie unter Verwendung der mit dem Quellenassistent erstellten EGL-Variable die Darstellung des JSF-Steuerelements mithilfe der Funktion setStyle. Um zum Beispiel die Schriftfarbe in einem Textsteuerelement in rot zu ändern, fügen Sie den folgenden Code hinzu:
    text1.setStyle("color : red");
    Wenn dieser Code ausgeführt wird, wird das Darstellungsattribut des Eingabesteuerelements geändert. In diesem Beispiel sieht der im Browser angezeigte HTML-Code folgendermaßen aus:
    <input id="form1:text1" type="text" name="form1:text1" style="color : red" />
    Mit dem neuen Darstellungsattribut werden vorherige Darstellungsattribute überschrieben. Trennen Sie Änderungen mit Semikolons (;), um mehrere Änderungen an der Darstellung eines Steuerelements vorzunehmen. Verwenden Sie den folgenden Code, um zum Beispiel die Farbe in rot zu ändern und die Größe auf 20 Punkt:
    text1.setStyle("color : red; font-size: 20pt");
Im Folgenden sind einige Beispiele mit anderen Änderungen aufgeführt, die an der Darstellung eines Steuerelements vorgenommen werden können. Nicht alle Darstellungen sind mit allen JSF-Steuerelementen kompatibel.
text1.setStyle("font-size : 20pt");
Zum Festlegen der Schriftgröße im Steuerelement auf 20 Punkt.
text1.setStyle("text-align: center");
Zum Zentrieren des Textes innerhalb des Steuerelements.
text1.setStyle("border-style : solid; border-color : red");
Zum Hinzufügen eines roten Rahmens aus einer durchgezogenen Linie um das Steuerelement herum.
text1.setStyle("font-weight : bold");
Zum Formatieren des Textes im Steuerelement in Fettdruck.
text1.setStyle("height : 50px");
Zum Festlegen der Höhe des Steuerelements auf 50 Pixel.

Feedback