apex:commandLink |
Lien de commande |
|---|---|
| Visualforce | APEX |
Syntaxe
| <apex:commandLink paramètres /> |
Paramètres
| Nom | Type | Description |
|---|---|---|
| accesskey | String | Ce paramètre permet d'indiquer la touche d'accès au clavier mettant le lien de commande en évidence. Lorsque le lien de commande est actif, appuyer sur la touche Enter équivaut à cliquer sur le lien. |
| action | ApexPages.Action | Ce paramètre permet d'indiquer la méthode d'action invoquée par la requête AJAX au serveur. Utilisez la syntaxe de champ de fusion pour référencer la méthode. Par exemple, action="{!save}" référence la méthode save() dans le contrôleur. Si aucune action n'est spécifiée, la page s'actualise simplement. Notez que les liens de commande associés aux actions d'enregistrement, de modification ou de suppression dans un contrôleur standard ne sont affichés que si l'utilisateur dispose des autorisations appropriées. De même, les liens de commande associés aux actions de modification et de suppression ne sont affichés que si un enregistrement est associé à la page. |
| charset | String | Ce paramètre permet d'indiquer un ensemble de caractères utilisé pour encoder l'URL spécifiée. Si elle n'est pas spécifiée, cette valeur par défaut est "ISO-8859-1". |
| coords | String | Ce paramètre permet d'indiquer la position et le format du point chaud sur l'écran utilisé pour le lien de commande (à utiliser dans les images cliquables côté client). Le nombre et l'ordre des valeurs séparées par des virgules dépendent du format définie. Par exemple, pour définir un rectangle, utilisez coords="left-x, top-y, right-x, bottom-y". Pour définir un cercle, utilisez coords="center-x, center-y, radius". Pour définir un polygone, utilisez coords="x1, y1, x2, y2, ..., xN, yN", où x1 = nN et y1 = yN. Les coordonnées peuvent être exprimées en pixels ou en pourcentages et représentent la distance depuis le coin supérieur gauche de l'image cartographiée. Voir aussi l'attribut shape. |
| dir | String | Ce paramètre permet d'indiquer la direction dans laquelle la composante HTML généré doit être lu. Les valeurs possibles incluent "RTL" (de droite à gauche) ou "LTR" (de gauche à droite). |
| hreflang | String | Ce paramètre permet d'indiquer la langue de base de la ressource référencée par ce lien de commande, par exemple, "en" ou "en-US". |
| id | String | Ce paramètre permet d'indiquer l'identificateur offrant la possibilité au composante commandLink d'être référencé par d'autres composants de la page. |
| immediate | Boolean | Ce paramètre permet d'indiquer une Valeur booléenne spécifiant si l'action associée à cette composante doit se produire immédiatement, sans traiter les règles de validation associées aux champs de la page. Si défini sur true, l'action se produit immédiatement et les règles de validation sont ignorées. Si elle n'est pas spécifiée, cette valeur par défaut est false. |
| lang | String | Ce paramètre permet d'indiquer la langue de base pour la sortie HTML générée, par exemple, "en" ou "en-US". |
| onblur | String | Ce paramètre permet d'appeler le JavaScript si l'événement onblur se produit, c'est-à-dire si le focus quitte le lien de commande. |
| onclick | String | Ce paramètre permet d'appeler le JavaScript si l'événement onclick se produit, c'est-à-dire si l'utilisateur clique sur le lien de commande. |
| oncomplete | String | Ce paramètre permet d'appeler le JavaScript lorsque le résultat d'une demande de mise à jour AJAX se termine sur le client. |
| ondblclick | String | Ce paramètre permet d'appeler le JavaScript si l'événement ondblclick se produit, c'est-à-dire si l'utilisateur clique deux fois sur le lien de commande. |
| onfocus | String | Ce paramètre permet d'appeler le JavaScript si l'événement onfocus se produit, c'est-à-dire si le focus est sur le lien de commande. |
| onkeydown | String | Ce paramètre permet d'appeler le JavaScript si l'événement onkeydown se produit, c'est-à-dire si l'utilisateur appuie sur une touche du clavier. |
| onkeypress | String | Ce paramètre permet d'appeler le JavaScript si l'événement onkeypress se produit, c'est-à-dire si l'utilisateur appuie ou maintient enfoncée une touche du clavier. |
| onkeyup | String | Ce paramètre permet d'appeler le JavaScript si l'événement onkeyup se produit, c'est-à-dire si l'utilisateur relâche une touche du clavier. |
| onmousedown | String | Ce paramètre permet d'appeler le JavaScript si l'événement onmousedown se produit, c'est-à-dire si l'utilisateur clique sur un bouton de la souris. |
| onmousemove | String | Ce paramètre permet d'appeler le JavaScript si l'événement onmousemove se produit, c'est-à-dire si l'utilisateur déplace le pointeur de la souris. |
| onmouseout | String | Ce paramètre permet d'appeler le JavaScript si l'événement onmouseout se produit, c'est-à-dire si l'utilisateur éloigne le pointeur de la souris du lien de commande. |
| onmouseover | String | Ce paramètre permet d'appeler le JavaScript si l'événement onmouseover se produit, c'est-à-dire si l'utilisateur déplace le pointeur de la souris sur le lien de commande. |
| onmouseup | String | Ce paramètre permet d'appeler le JavaScript si l'événement onmouseup se produit, c'est-à-dire si l'utilisateur relâche le bouton de la souris. |
| rel | String | Ce paramètre permet d'indiquer la relation entre le document actuel et l'URL spécifiée par ce lien de commande. La valeur de cet attribut est une liste de types de liens séparés par des espaces. |
| rendered | Boolean | Ce paramètre permet d'indiquer une valeur booléenne spécifiant si le composant est rendu sur la page. Si elle n'est pas spécifiée, cette valeur par défaut est true. |
| reRender | Object | Ce paramètre permet d'indiquer l'identificateur d'un ou plusieurs composantes étant redessinés lorsque le résultat d'une demande de mise à jour AJAX revient au client. Cette valeur peut être un identificateur unique, une liste d'identificateurs séparés par des virgules ou une expression de champ de fusion pour une liste ou une collection d'identificateurs. |
| rev | String | Ce paramètre permet d'indiquer le lien inverse de l'URL spécifiée par cette commande renvoie au document actuel. La valeur de cet attribut est une liste de types de liens séparés par des espaces. |
| shape | String | Ce paramètre permet d'indiquer le format du point chaud dans les images cliquables côté client. Les valeurs valides sont default, circle, rect et poly. Voir aussi l'attribut coords. |
| status | String | Ce paramètre permet d'indiquer l'identificateur d'une composante associé affichant l'état d'une demande de mise à jour AJAX. Voir la composante actionStatus. |
| style | String | Ce paramètre permet d'indiquer le style utilisé pour afficher la composante commandLink, utilisé principalement pour ajouter des styles CSS en ligne. |
| styleClass | String | Ce paramètre permet d'indiquer la classe de style utilisée pour afficher la composante commandLink, utilisé principalement pour désigner les styles CSS appliqués lors de l'utilisation d'une feuille de style CSS externe. |
| tabindex | String | Ce paramètre permet d'indiquer l'ordre dans lequel ce lien est sélectionné par rapport aux autres composants de la page lorsqu'un utilisateur appuie plusieurs fois sur la touche Tab. Cette valeur doit être un entier compris entre 0 et 32767, la composante 0 étant la première composante sélectionné lorsqu'un utilisateur appuie sur la touche Tab. |
| target | String | Ce paramètre permet d'indiquer le nom du cadre où doit s'afficher la ressource récupérée par ce lien de commande. Les valeurs possibles pour cet attribut incluent "_blank", "_parent", "_self" et "_top". Vous pouvez également spécifier vos propres noms de cible en attribuant une valeur à l'attribut de nom d'une destination souhaitée. |
| timeout | Integer | Ce paramètre permet d'indiquer le délai (en millisecondes) avant qu'une demande de mise à jour AJAX n'expire. |
| title | String | Ce paramètre permet d'indiquer le texte à afficher sous forme d'info-bulle lorsque le pointeur de la souris de l'utilisateur survole cette composante. |
| type | String | Ce paramètre permet d'indiquer le type de contenu MIME de la ressource désignée par ce lien de commande. Les valeurs possibles pour cet attribut incluent "text/html", "image/png", "image/gif", "video/mpeg", "text/css" et "audio/basic". |
| value | Object | Ce paramètre permet d'indiquer le texte s'affichant en tant qu'étiquette commandLink. Notez que vous pouvez également spécifier du texte ou une image à afficher comme lien de commande en incorporant du contenu dans le corps de la balise commandLink. Si l'attribut de valeur et le contenu incorporé sont inclus, ils sont affichés ensemble. |
Description
Cette balise permet d'indiquer le lien exécutant une action définie par un contrôleur, puis actualise la page actuelle ou accède à une page différente en fonction de la variable PageReference renvoyée par l'action.
Remarques
- La balise apex:commandLink permet d'indiquer un lien exécutant une action définie par un contrôleur, puis actualise la page actuelle ou navigue vers une autre page en fonction de la variable PageReference renvoyée par l'action. Une composante <apex:commandLink> doit toujours être un enfant d'une composante <apex:form>.
- Pour ajouter des paramètres de requête à un <apex:commandLink>, utilisez des composantes <apex:param> imbriqués.
- Cette composante prend en charge les attributs d'intercommunication HTML utilisant le préfixe "html-". Les attributs pass-through sont attachés à la balise <a> générée.
Voir également
Langage de programmation - Apex - Visualforce - Références des composantes - apex:commandButton
Langage de programmation - Apex - Visualforce - Références des composantes - apex:outputLink
Dernière mise à jour : Lundi, le 26 Octobre 2020