JSF - h: commandLink

La balise h: commandLink rend un élément HTML "anchor".

Balise JSF

<h:commandLink value = "Page 1" action = "page1" />

Sortie rendue

<a href = "#" onclick = "mojarra.jsfcljs(document.getElementById('j_idt13'), 
   {'j_idt13:j_idt14':'j_idt13:j_idt14'},'');return false">Page 1</a>

Attributs de balise

S. Non	Attribut et description
1	id Identifiant d'un composant
2	binding Référence au composant qui peut être utilisé dans un backing bean
3	rendered Un booléen; false supprime le rendu
4	styleClass Nom de classe de feuille de style en cascade (CSS)
5	value La valeur d'un composant, généralement une liaison de valeur
6	valueChangeListener Une méthode qui se lie à une méthode qui répond aux changements de valeur
sept	converter Nom de la classe de convertisseur
8	validator Nom de classe d'un validateur créé et attaché à un composant
9	required Un booléen; si vrai, nécessite la saisie d'une valeur dans le champ associé
dix	Accesskey Une clé, généralement combinée à une métakey définie par le système, qui met l'accent sur un élément
11	accept Liste des types de contenu séparés par des virgules pour un formulaire
12	accept-charset Liste de codages de caractères séparés par des virgules ou des espaces pour un formulaire. leaccept-charset l'attribut est spécifié avec l'attribut HTML JSF nommé acceptcharset.
13	Alt Texte alternatif pour les éléments non textuels tels que des images ou des applets
14	border Valeur de pixel pour la largeur de bordure d'un élément
15	charset Codage de caractères pour une ressource liée
16	coords Coordonnées d'un élément dont la forme est un rectangle, un cercle ou un polygone
17	dir Direction du texte. Les valeurs valides sontltr (de gauche à droite) et rtl (de droite à gauche)
18	hreflang Langue de base d'une ressource spécifiée avec le href attribut; hreflang ne peut être utilisé qu'avec href.
19	lang Langue de base des attributs et du texte d'un élément
20	maxlength Nombre maximum de caractères pour les champs de texte
21	readonly État en lecture seule d'un champ d'entrée; le texte peut être sélectionné dans un champ en lecture seule mais pas modifié
22	rel Relation entre le document courant et un lien spécifié avec le href attribut
23	rev Lien inversé depuis l'ancre spécifiée avec hrefau document actuel. La valeur de l'attribut est une liste de types de liens séparés par des espaces
24	size Taille d'un champ de saisie
25	style Informations de style en ligne
26	tabindex Valeur numérique spécifiant un index de tabulation
27	target Le nom d'un cadre dans lequel un document est ouvert
28	title Un titre, utilisé pour l'accessibilité, qui décrit un élément. Les navigateurs visuels créent généralement des info-bulles pour la valeur du titre
29	type Type de lien; par exemple,stylesheet
30	width Largeur d'un élément
31	onblur L'élément perd le focus
32	onchange Changements de valeur de l'élément
33	onclick Le bouton de la souris est cliqué sur l'élément
34	ondblclick Le bouton de la souris est double-cliqué sur l'élément
35	onfocus L'élément reçoit le focus
36	onkeydown La touche est enfoncée
37	onkeypress La touche est enfoncée puis relâchée
38	onkeyup La clé est libérée
39	onmousedown Le bouton de la souris est enfoncé sur l'élément
40	onmousemove La souris se déplace sur l'élément
41	onmouseout La souris quitte la zone de l'élément
42	onmouseover La souris se déplace sur un élément
43	onmouseup Le bouton de la souris est relâché
44	onreset Le formulaire est réinitialisé
45	onselect Le texte est sélectionné dans un champ de saisie

Exemple d'application

Créons une application JSF de test pour tester la balise ci-dessus.

Étape	La description
1	Créez un projet avec un nom helloworld sous un package com.tutorialspoint.test comme expliqué dans le chapitre JSF - Première application .
2	Modifiez home.xhtml comme expliqué ci-dessous. Gardez le reste des fichiers inchangé.
3	Compilez et exécutez l'application pour vous assurer que la logique métier fonctionne conformément aux exigences.
4	Enfin, créez l'application sous la forme d'un fichier war et déployez-la dans Apache Tomcat Webserver.
5	Lancez votre application Web en utilisant l'URL appropriée, comme expliqué ci-dessous à la dernière étape.

home.xhtml

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
   "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns = "http://www.w3.org/1999/xhtml">
   <head>
      <title>JSF Tutorial!</title>
   </head>
   
   <body>
      <h2>h:commandLink example</h2>
      <hr />
      
      <h:form>
         <h:commandLink value = "Page 1" action = "page1" />
      </h:form>
   </body>
</html>

Une fois que vous êtes prêt avec tous les changements effectués, laissez-nous compiler et exécuter l'application comme nous l'avons fait dans le chapitre JSF - Première application. Si tout va bien avec votre application, cela produira le résultat suivant.