apex:component |
Composante |
|---|---|
| Visualforce | APEX |
Syntaxe
|
<apex:component paramètres> ... </apex:component> |
Paramètres
| Nom | Type | Description |
|---|---|---|
| access | String | Ce paramètre permet d'indiquer si la composante peut être utilisé en dehors de n'importe quelle page dans le même espace de noms que la composante. Les valeurs possibles sont "public" (par défaut) et "global". Utilisez global pour indiquer que la composante peut être utilisé en dehors de l'espace de noms de la composante. Si l'attribut d'accès est défini sur global, l'attribut d'accès sur tous les enfants apex:attribute requis doit également être défini sur global. Si l'attribut d'accès est défini sur public, l'attribut d'accès sur l'enfant apex:attribute ne peut pas être défini sur global. Remarque : les composantes portant cette désignation sont soumis aux politiques de dépréciation décrites pour les paquets gérés. |
| allowDML | Boolean | Ce paramètre permet d'indiquer si cet attribut est défini sur "true", vous pouvez inclure DML dans la composante. Le défaut est "false". L'autorisation du DML peut entraîner des effets secondaires pouvant être problématiques pour les consommateurs utilisant la composante avec des mises à jour de page partielles. Lorsque vous autorisez DML dans une composante, vous devez inclure des attributs de rendu afin que le consommateur puisse actualiser correctement sa page. De plus, vous devez détailler, dans la description de la composante, quelles données sont manipulées par le DML afin que les consommateurs de la composante soient conscients des effets secondaires potentiels. |
| controller | String | Ce paramètre permet d'indiquer le nom du contrôleur Apex utilisé pour contrôler le comportement de cette composante personnalisé. |
| extensions | String | Ce paramètre permet d'indiquer le nom d'une ou plusieurs extensions de contrôleur qui ajoutent une logique supplémentaire à cette composante personnalisé. |
| id | String | Ce paramètre permet d'indiquer l'identificateur offrant la possibilité au composante d'être référencé par d'autres balises dans la définition de la composante. |
| language | String | Ce paramètre permet d'indiquer la langue utilisée pour afficher les étiquettes ayant des traductions associées dans Salesforce. Cette valeur remplace la langue de l'utilisateur visualisant la composante. Les valeurs possibles pour cet attribut incluent toutes les clefs de langue pour les langues prises en charge par Salesforce, par exemple, "en" ou "en-US". |
| layout | String | Ce paramètre permet d'indiquer le style de mise en page HTML de la composante. Les valeurs possibles sont "block" (enveloppant la composante avec une balise div du HTML), "inline" (enveloppant la composante avec une balise span du HTML) et "none" (n'enveloppant la composante avec aucune balise HTML générée). Si elle n'est pas spécifiée, cette valeur par défaut est «inline». |
| rendered | Boolean | Ce paramètre permet d'indiquer une valeur booléenne spécifiant si la composante personnalisé est rendu. Si elle n'est pas spécifiée, cette valeur par défaut est "true". |
| selfClosing | Boolean | Ce paramètre permet d'indiquer une valeur booléenne spécifiant comment l'éditeur Visualforce ferme cette composante. Si cet attribut est défini sur "true", l'éditeur Visualforce complète automatiquement la composante en tant que balise à fermeture automatique. Sinon, il complète automatiquement la composante avec des balises d'ouverture et de fermeture. Par exemple, si cet attribut est défini sur "true" sur un composant appelé myComponent, l'éditeur complétera automatiquement la balise de la composante en tant que <c:myComponent/>. S'il est défini sur "false", l'éditeur complétera automatiquement la balise en tant que <c:myComponent></c:myComponent>. Si la composante inclut un componentBody, la valeur par défaut de cet attribut est "false". Si la composante n'inclut pas de componentBody, la valeur par défaut de l'attribut est "true". |
Description
Cette balise permet d'indiquer une composante Visualforce personnalisé.
Remarques
- La balise apex:component est une composante Visualforce personnalisé. Toutes les définitions de composantes personnalisés doivent être encapsulées dans une seule balise <apex:component>.
- Cette composante prend en charge les attributs d'intercommunication HTML utilisant le préfixe «html-». Les attributs de transfert sont attachés à la balise de conteneur générée, <div> ou <span>, selon l'attribut de mise en page.
Dernière mise à jour : Lundi, le 26 Octobre 2020