-
@Retention(value=RUNTIME) @Target(value=TYPE) @Inherited public @interface FacesRenderer
The presence of this annotation on a class automatically registers the class with the runtime as a
Renderer
. The value of therenderKitId()
attribute is taken to be the render-kit-id to which an instance of thisRenderer
is to be added. There must be a public zero-argument constructor on any class where this annotation appears. The implementation must indicate a fatal error if such a constructor does not exist and the application must not be placed in service. Within thatRenderKit
, The value of therendererType()
attribute is taken to be the renderer-type, and the value of thecomponentFamily()
attribute is to be taken as the component-family. The implementation must guarantee that for each class annotated withFacesRenderer
, found with the algorithm in section JSF.11.5, the following actions are taken.Obtain a reference to the
RenderKitFactory
for this application.See if a
RenderKit
exists for render-kit-id. If so, let that instance be renderKit for discussion. If not, the implementation must indicate a fatal error if such aRenderKit
does not exist and the application must not be placed in service.Create an instance of this class using the public zero-argument constructor.
Call
RenderKit.addRenderer(java.lang.String, java.lang.String, javax.faces.render.Renderer)
on renderKit, passing component-family as the first argument, renderer-type as the second, and the newly instantiatedRenderKit
instance as the third argument.
-
-
Required Element Summary
Required Elements Modifier and Type Required Element and Description String
componentFamily
The value of this annotation attribute is taken to be the component-family which, in combination with
rendererType()
can be used to obtain a reference to an instance of thisRenderer
by callingRenderKit.getRenderer(java.lang.String, java.lang.String)
.String
rendererType
The value of this annotation attribute is taken to be the renderer-type which, in combination with
componentFamily()
can be used to obtain a reference to an instance of thisRenderer
by callingRenderKit.getRenderer(java.lang.String, java.lang.String)
.
-
Optional Element Summary
Optional Elements Modifier and Type Optional Element and Description String
renderKitId
The value of this annotation attribute is taken to be the render-kit-id in which an instance of this class of
Renderer
must be installed.
-
-
-
Element Detail
-
rendererType
public abstract String rendererType
The value of this annotation attribute is taken to be the renderer-type which, in combination with
componentFamily()
can be used to obtain a reference to an instance of thisRenderer
by callingRenderKit.getRenderer(java.lang.String, java.lang.String)
.
-
-
-
componentFamily
public abstract String componentFamily
The value of this annotation attribute is taken to be the component-family which, in combination with
rendererType()
can be used to obtain a reference to an instance of thisRenderer
by callingRenderKit.getRenderer(java.lang.String, java.lang.String)
.
-
-
-
renderKitId
public abstract String renderKitId
The value of this annotation attribute is taken to be the render-kit-id in which an instance of this class of
Renderer
must be installed.- Default:
- "HTML_BASIC"
-
-
Traduction non disponible
Les API Java ne sont pas encore traduites en français sur l'infobrol. Seule la version anglaise est disponible pour l'instant.
Version en cache
21/08/2025 20:17:54 Cette version de la page est en cache (à la date du 21/08/2025 20:17:54) afin d'accélérer le traitement.Vous pouvez activer le mode utilisateur dans le menu en haut pour afficher la version plus récente de la page.
Document créé le 11/06/2005, dernière modification le 18/08/2025
Source du document imprimé : https://www.gaudry.be/java-api-javaee-rf-javax/faces/render/FacesRenderer.html
L'infobrol est un site personnel dont le contenu n'engage que moi. Le texte est mis à disposition sous licence CreativeCommons(BY-NC-SA). Plus d'info sur les conditions d'utilisation et sur l'auteur.
Références
Ces références et liens indiquent des documents consultés lors de la rédaction de cette page, ou qui peuvent apporter un complément d'information, mais les auteurs de ces sources ne peuvent être tenus responsables du contenu de cette page.
L'auteur de ce site est seul responsable de la manière dont sont présentés ici les différents concepts, et des libertés qui sont prises avec les ouvrages de référence. N'oubliez pas que vous devez croiser les informations de sources multiples afin de diminuer les risques d'erreurs.