Code HTML personnalisé

En utilisant un élément HTML personnalisé, vous pouvez ajouter du code HTML à une page ou à une vue.

Ce code HTML personnalisé peut contenir un ou plusieurs ensembles d'éléments HTML, tels que des balises <div> et <label>. Vous pouvez ajouter le code HTML directement sous forme de texte en utilisant un fichier géré ou une variable. L'élément HTML personnalisé insère les éléments dans la balise <div> de la page ou de la vue. Si vous utilisez un élément HTML personnalisé dans un conteneur, comme les vues standard Table, Onglet, Section horizontale et verticale, encapsulez le code HTML dans une balise <div>. De la sorte, le conteneur traitera tout le code HTML comme une seule entité.

Remarque: Lorsque vous générez des pages à l'aide de blocs HTML personnalisés, assurez-vous que les segments HTML de ces blocs ne sont pas trop grands. Les blocs HTML personnalisés sont conçus pour être utilisés avec des segments HTML de taille petite à moyenne. Si vous indiquez un segment HTML trop grand, une exception de dépassement de la capacité de pile peut être générée. Si tel est le cas, réduisez la taille du segment HTML que vous utilisez dans la page. Voir Configuration de la JVM Le lien externe ouvre une nouvelle fenêtre ou un nouvel onglet

dans les informations sur le produit WebSphere® Application Server.

Restriction: Si votre élément HTML personnalisé se trouve dans une vue répétitive telle qu'une table ou une section, ne le liez pas à une variable qui est une propriété d'un élément de liste. Le générateur de code insère généralement le contenu HTML personnalisé sous la forme de code HTML lors de la création de la page. Toutefois, les vues qui se répètent sont liées à une liste. Le contenu de la liste n'étant pas défini tant que l'exécution n'a pas eu lieu, le générateur de code ne peut pas identifier l'index dans la liste lors de la création de la page. Si vous souhaitez avoir un texte modifié de manière dynamique, vous pouvez envisager d'utiliser une vue, comme Texte de sortie, liée à la variable.

Important: N'utilisez pas les noms suivants comme noms de classe CSS dans votre code source HTML car il s'agit de noms réservés:

CoachView
ContentBox

L'élément HTML personnalisé prend en charge l'utilisation de variables JavaScript pour les types simples. Lorsque le serveur génère la page HTML pour le client, il remplace le nom de la variable par sa valeur. Cependant, après avoir généré la page, le serveur ne met pas à jour le code HTML si la valeur est modifiée. Il ne met à jour la variable que lorsqu'il régénère la page HTML complète. Si le serveur ne peut pas résoudre la variable, les utilisateurs ne voient que son nom au lieu de sa valeur.

Dans le code, vous devez encadrer la variable par des doubles accolades. Pour les pages, la variable ne peut se référer qu'à des données dans l'espace de nom tw.local. Autrement dit, la variable peut se référer aux données définies dans la page Variables du service utilisateur sous le noeud local. Par exemple, une page pourrait avoir une variable d'objet métier user (utilisateur) avec un paramètre name contenant le nom de l'utilisateur. Vous pouvez indiquer à la page d'afficher le nom en utilisant le code suivant dans un élément HTML :

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

Pour les vues, la variable peut se référer aux données dans l'espace de nom tw.businessData ou tw.options. Autrement dit, la variable peut se référer aux données définies dans la page Variables de la vue sous les noeuds Données métier ou Options de configuration. Par exemple, pour qu'une vue affiche le nom d'une rue, vous pourriez lier la vue d'un objet métier address à un paramètre street. Dans un élément HTML, vous ajouteriez alors le code suivant :

{{tw.businessData.address.street}}

Si vous placez une instance de cette vue dans une page, l'utilisateur verra la valeur du paramètre street (rue) dans la vue. Cependant, si l'utilisateur met à jour la valeur du paramètre street, le contenu de l'élément HTML ne sera pas actualisé tant que le serveur n'aura pas régénéré la page complète.

Astuce: Pour insérer un script, ajoutez-le à l'aide de scripts en ligne sur la page Comportement de la vue. N'ajoutez pas le script à l'aide d'un élément HTML personnalisé.