Author: artdaw
Date: 2008-07-29 11:06:03 -0400 (Tue, 29 Jul 2008)
New Revision: 9818
Modified:
trunk/docs/cdkguide/en/src/main/docbook/master.xml
Log:
https://jira.jboss.org/jira/browse/RF-3783 - Creating a Renderer section fixed
Modified: trunk/docs/cdkguide/en/src/main/docbook/master.xml
===================================================================
--- trunk/docs/cdkguide/en/src/main/docbook/master.xml 2008-07-29 13:38:19 UTC (rev 9817)
+++ trunk/docs/cdkguide/en/src/main/docbook/master.xml 2008-07-29 15:06:03 UTC (rev 9818)
@@ -84,15 +84,26 @@
</keywordset>
</sectioninfo>
<title>Creating a Renderer</title>
- <para> Renderer is responsible for the JSF component representation. It
generates the
+ <para>
+ Component functionality typically centers around two actions:
+ <property>decoding</property> and
<property>encoding</property> data.
+ Decoding is the process of converting incoming request parameters to the values of the
component.
+ Encoding is converting the current values of the component into the corresponding
markup. In the
+ following figure you can see decoding and encoding occur in the JSF lifecycle:
+ </para>
+ <!-- PIC -->
+ <para>
+ Thus, JSF components consist of two parts: the <property>component
class</property> and the <property>renderer</property>.
+ The <property>component class</property> is responsible for the state and
behavior of a UI component and will be discussed later in the
<property>"Configuring component"</property> section.
+ </para>
+ <para>The <property>Renderer</property> is responsible for
the JSF component representation. It generates the
appropriate client-side markup, such as HTML, WML, XUL, etc. Renderer is
also
responsible for the converting information coming from the client to the
proper type
for the component (for example, a string value from the request is
converted to a
- strongly type <code>Date</code> object). </para>
+ strongly type <code>Date</code> object).
+ </para>
<para>
- It is necessary to create following renderer classes for the <emphasis
role="bold">
- <property><inputDate></property>
- </emphasis> component:
+ It is necessary to create following renderer classes for the <emphasis
role="bold"><property><inputDate></property></emphasis>
component:
</para>
<itemizedlist>
<listitem>