Benutzerdefinierter HTML-Code

Mithilfe eines benutzerdefinierten HTML-Elements können Sie einer Seite oder Ansicht HTML-Code hinzufügen.

Das benutzerdefinierte HTML-Element kann eine Gruppe oder mehrere Gruppen von HTML-Elementen enthalten (z. B. die Tags <div> und <label>). Sie können den HTML-Code mithilfe einer verwalteten Datei direkt als Text hinzufügen oder über eine Variable. Das angepasste HTML-Element fügt die Elemente im Tag <div> der Seite oder Ansicht ein. Wenn Sie ein benutzerdefiniertes HTML-Element in einem Container (z. B. in einer der Ansichten wie Tabelle, Registerkarte, horizontaler Abschnitt oder vertikaler Abschnitt) hinzufügen, schließen Sie den HTML-Code in einen Tag <div> ein. Der eingeschlossene HTML-Code wird im Container als separate Einheit behandelt.

Hinweis: Stellen Sie beim Erstellen von Seiten mit angepassten HTML-Blöcken sicher, dass die HTML-Segmente in diesen Blöcken nicht zu groß sind. Angepasste HTML-Blöcke sind für die Verwendung mit kleinen bis mittelgroßen HTML-Segmenten vorgesehen. Wenn Sie ein zu großes HTML-Segment bereitstellen, wird möglicherweise eine Ausnahmebedingung aufgrund eines Stacküberlaufs ausgelöst. In diesem Fall müssen Sie die Größe des HTML-Segments reduzieren, das Sie in der Seite verwenden. Siehe Konfigurieren der JVM Externer Link öffnet ein neues Fenster oder eine neue Registerkarte

in der Produktinformation WebSphere® Application Server.

Einschränkung: Wenn sich Ihr angepasstes HTML-Element in einer sich wiederholenden Ansicht wie einer Tabelle oder einem Abschnitt befindet, binden Sie es nicht an eine Variable, die eine Eigenschaft in einem Listenelement ist. Normalerweise wird der angepasste HTML-Inhalt vom Codegenerator als HTML-Code eingefügt, wenn die Seite erstellt wird. Die sich wiederholenden Ansichten sind jedoch an eine Liste gebunden. Da der Listeninhalt bis zur Laufzeit nicht eingestellt wird, kann der Codegenerator den Index der Variablen nicht in der Liste erkennen, wenn die Seite erstellt wird. Wenn Sie wünschen, dass sich der Text dynamisch ändert, ziehen Sie in Betracht, eine Ansicht (wie z. B. einen Ausgabetext) zu verwenden, die an die Variable gebunden ist.

Wichtig: Verwenden Sie die folgenden Namen nicht als CSS-Klassennamen in Ihrem HTML-Quellcode, da sie reservierte Namen sind:

CoachView
ContentBox

Das benutzerdefinierte HTML-Element unterstützt die Verwendung von JavaScript-Variablen für einfache Typen. Beim Generieren der HTML-Seite ersetzt der Server den Namen der Variablen durch den auf dem Server angegebenen Wert. Nachdem die Seite vom Server generiert wurde, erfolgt jedoch keine weitere Aktualisierung der HTML-Seite, wenn der Wert geändert wird. Eine Aktualisierung der Variablen findet nur statt, wenn der Server die gesamte HTML-Seite erneut generiert. Wenn der Server die Variable nicht auflösen kann, wird der Name der Variablen und nicht der Variablenwert für die Benutzer angezeigt.

Im Code wird die Variable in doppelte geschweifte Klammern eingeschlossen. Bei Seiten kann sich die Variable nur auf die Daten im Namensbereich tw.local beziehen. Dies bedeutet, die Variable kann auf die Daten verweisen, die auf der Seite Variablen des Benutzerservice unter dem lokalen Knoten definiert sind. Beispielsweise verfügt eine Seite über eine Geschäftsobjektvariable user mit einem Parameter name, der den Namen des Benutzers enthält. Auf der Seite kann der Name mit dem folgenden Code in einem HTML-Element angezeigt werden:

<div>Hello, {{tw.local.user.name}}.</div>

In Ansichten kann die Variable auf die Daten im Namensbereich tw.businessData oder im Namensbereich tw.options verweisen. Dies bedeutet, die Variable kann auf die Daten verweisen, die auf der Seite Variablen der Ansicht unter dem Knoten "Geschäftsdaten" oder "Konfigurationsoptionen" definiert sind. Beispiel: Damit eine Ansicht den Namen einer Straße anzeigt, binden Sie die Ansicht an ein Geschäftsobjekt address, das einen Parameter namens street enthält. Fügen Sie in einem HTML-Element den folgenden Code hinzu:

{{tw.businessData.address.street}}

Wenn Sie eine Instanz dieser Ansicht auf einer Seite anordnen, wird dem Benutzer der Wert des Parameter street in der Ansicht angezeigt. Wenn der Benutzer jedoch den Parameter street aktualisiert, wird der Inhalt des HTML-Elements erst aktualisiert, wenn der Server die gesamte Seite erneut generiert.

Tipp: Fügen Sie zum Einfügen eines Scripts das Script mithilfe integrierter Scripts auf der Seite Verhalten der Ansicht hinzu. Fügen Sie das Script nicht mithilfe eines benutzerdefinierten HTML-Elements hinzu.