Une définition de bibliothèque JSP contient les ressources de projet nécessaires pour une bibliothèque de composants et les métadonnées nécessaires pour l'interprétation des balises JSP. Elle vous aide à personnaliser l'intégration d'une bibliothèque de balises JSP personnalisées dans ce produit.
L'éditeur de définition d'une bibliothèque JSP permet de configurer les détails sur la façon d'intégrer une nouvelle bibliothèque JSP dans le projet.
Les détails suivants indiquent comment configurer le projet Web pour utiliser la nouvelle bibliothèque de composants. La configuration déclare comment copier les fichiers dans le projet Web et les modifications de configuration à apporter pour que les composants fonctionnent correctement.
La bibliothèque de balises répertorie toutes les balises personnalisées qui constituent la bibliothèque et active la configuration d'un grand nombre de détails relatif au comportement de l'outil. Par exemple, vous pouvez spécifier l'apparence des balises dans la Palette, les comportements lors de l'insertion de balises dans l'éditeur, l'apparence visuelle des composants dans la source de page Web et différents détails sur les attributs de balise et la liaison de données.
Vous pouvez configurer des détails sur les balises dans la bibliothèque de composant.Lorsque la définition de bibliothèque est générée, elle contient toutes les balises de la bibliothèque de composants. Vous pouvez modifier l'ordre des balises en utilisant les boutons Haut et Bas. L'ordre des balises spécifié est indiqué dans l'apparence de la bibliothèque dans la palette.
Certaines informations visuelles sur la catégorie de palette de bibliothèque peuvent être configurées. Configurez des liens de feuille de style ou des références JavaScript qui s'appliquent à toutes les balises dans une bibliothèque. Lorsqu'une balise est ajoutée à partir de la palette, les balises <link> et <script> correspondantes sont ajoutées à la page Web.
Un canevas de visualisation sert à contrôler l'apparence d'un composant dans le volet Conception de l'éditeur de page. Le canevas consiste en un marquage HTML et en plusieurs variables de substitution optionnelles, qui servent à modifier dynamiquement le contenu de la visualisation. Lorsque l'utilisateur fait glisser un composant pour l'amener sur une page, le canevas correspondant est évalué. L'éditeur de page utilise le code HTML résultant pour créer une représentation qui soit utile en phase de conception. Les détails des variables de canevas disponibles s'affichent dans le tableau 1.
Variable | Description | Exemple |
---|---|---|
${children} | La variable ${children} émet toutes les balises enfant de la balise visualisée, si elles existent, à l'emplacement de la variable ${children} dans le canevas. Les balises enfant sont insérées dans l'ordre où elles apparaissent dans la page originale. L'éditeur de page calcule les visualisations des balises enfant car ces dernières peuvent également utiliser des canevas. Toutes les balises enfant pouvant être insérées au même emplacement, un canevas ne peut utiliser qu'une seule variable ${children}. |
|
${children:row} | Le modificateur row de la variable ${children} émet les balises enfant dans une séquence d'éléments <td> de cellule de table HTML. Utilisez cette variable pour organiser plusieurs composants sur un plan horizontal. |
|
${children:grid(param[,param]*)} | Le modificateur grid crée un ensemble de lignes et de cellules de table HTML qui contiennent les enfants d'une balise. Les enfants sont ajoutés de gauche à droite et passent à la ligne suivante lorsque le nombre de colonnes indiqué est atteint. Le nombre de colonnes par défaut est de 2. La liste facultative de paramètres séparés par une virgule remplace le nombre de colonnes dans la grille. Les options des paramètres sont les suivantes :
Les paramètres sont examinés de manière séquentielle jusqu'à ce qu'une valeur valide soit trouvée. Par exemple, le canevas ${children:grid(attr.size, attr.numcols, 3)} utilise l'attribut size de la balise si ce dernier a été défini, sinon il utilise l'attribut numcols, s'il est défini. Si aucun de ces attributs n'est défini, la constante 3 est utilisée. |
|
${children:stack(param)} | Le modificateur stack est utilisé dans les panneaux composés d'onglets pour créer des lignes et des cellules de table destinées à remplir une visualisation sous forme de cellules empilées. Il crée une table horizontale de libellés sur lesquels on peut cliquer pour chaque balise enfant. Lorsque vous cliquez sur un libellé, la visualisation de la balise enfant passe en début de pile. Le paramètre facultatif indique l'attribut de balise des balises enfant à utiliser pour le libellé, en utilisant la syntaxe attr.attrName. |
|
${attr:attrName} | Cette variable remplace la valeur d'attribut d'une balise à l'emplacement en cours dans le canevas. Si l'attribut n'a pas de valeur définie, une chaîne vide est insérée. |
|