Author: SeanRogers
Date: 2009-12-21 02:03:04 -0500 (Mon, 21 Dec 2009)
New Revision: 16175
Added:
root/docs/trunk/Component_Reference/en-US/extras/exam-Component_Reference-a4jactionParam-a4jactionParam_example.xml_sample
root/docs/trunk/Component_Reference/en-US/extras/exam-Component_Reference-a4jjsFunction-a4jjsFunction_example.xml_sample
root/docs/trunk/Component_Reference/en-US/extras/exam-Component_Reference-a4jloadBundle-a4jloadBundle_example-0.xml_sample
root/docs/trunk/Component_Reference/en-US/extras/exam-Component_Reference-a4jloadBundle-a4jloadBundle_example-1.js
root/docs/trunk/Component_Reference/en-US/extras/exam-Component_Reference-a4jloadBundle-a4jloadBundle_example-2.xml_sample
root/docs/trunk/Component_Reference/en-US/extras/exam-Component_Reference-a4jmediaOutput-a4jmediaOutput_example-0.js
root/docs/trunk/Component_Reference/en-US/extras/exam-Component_Reference-a4jmediaOutput-a4jmediaOutput_example-1.js
root/docs/trunk/Component_Reference/en-US/images/figu-Component_Reference-a4jmediaOutput-a4jmediaOutput_example_result.png
Removed:
root/docs/trunk/Component_Reference/en-US/extras/exam-Component_Reference-Resources-a4jloadBundle-0.xml_sample
root/docs/trunk/Component_Reference/en-US/extras/exam-Component_Reference-Resources-a4jloadBundle-1.js
root/docs/trunk/Component_Reference/en-US/extras/exam-Component_Reference-Resources-a4jloadBundle-2.xml_sample
root/docs/trunk/Component_Reference/en-US/extras/exam-Component_Reference-Resources-a4jmediaOutput_example-0.js
root/docs/trunk/Component_Reference/en-US/extras/exam-Component_Reference-Resources-a4jmediaOutput_example-1.js
root/docs/trunk/Component_Reference/en-US/extras/exam-Component_Reference-a4jactionParam-a4jactionParam_example.xmlt
root/docs/trunk/Component_Reference/en-US/extras/exam-Component_Reference-a4jjsFunction-a4jjsFunction_example.xmlt
root/docs/trunk/Component_Reference/en-US/images/figu-Component_Reference-Resources-a4jmediaOutput_example_result.png
Modified:
root/docs/trunk/Component_Reference/en-US/Author_Group.xml
root/docs/trunk/Component_Reference/en-US/Book_Info.xml
root/docs/trunk/Component_Reference/en-US/Component_Reference.xml
root/docs/trunk/Component_Reference/en-US/Preface.xml
root/docs/trunk/Component_Reference/en-US/Revision_History.xml
root/docs/trunk/Component_Reference/en-US/chap-Component_Reference-Actions.xml
root/docs/trunk/Component_Reference/en-US/chap-Component_Reference-Common_Ajax_attributes.xml
root/docs/trunk/Component_Reference/en-US/chap-Component_Reference-Common_features.xml
root/docs/trunk/Component_Reference/en-US/chap-Component_Reference-Containers.xml
root/docs/trunk/Component_Reference/en-US/chap-Component_Reference-Drag_and_drop.xml
root/docs/trunk/Component_Reference/en-US/chap-Component_Reference-Functionality_extension.xml
root/docs/trunk/Component_Reference/en-US/chap-Component_Reference-Functions.xml
root/docs/trunk/Component_Reference/en-US/chap-Component_Reference-Introduction.xml
root/docs/trunk/Component_Reference/en-US/chap-Component_Reference-Layout_and_appearance.xml
root/docs/trunk/Component_Reference/en-US/chap-Component_Reference-Menus_and_toolbars.xml
root/docs/trunk/Component_Reference/en-US/chap-Component_Reference-Output_and_messages.xml
root/docs/trunk/Component_Reference/en-US/chap-Component_Reference-Panels_and_containers.xml
root/docs/trunk/Component_Reference/en-US/chap-Component_Reference-Portals.xml
root/docs/trunk/Component_Reference/en-US/chap-Component_Reference-Processing_management.xml
root/docs/trunk/Component_Reference/en-US/chap-Component_Reference-Resources.xml
root/docs/trunk/Component_Reference/en-US/chap-Component_Reference-Rich_inputs.xml
root/docs/trunk/Component_Reference/en-US/chap-Component_Reference-Tables_and_grids.xml
root/docs/trunk/Component_Reference/en-US/chap-Component_Reference-Trees.xml
root/docs/trunk/Component_Reference/en-US/chap-Component_Reference-Validation.xml
root/docs/trunk/Component_Reference/en-US/fallback_content/Conventions.xml
root/docs/trunk/Component_Reference/en-US/fallback_content/Feedback.xml
root/docs/trunk/Component_Reference/en-US/fallback_content/Legal_Notice.xml
Log:
Fixed file names
Modified: root/docs/trunk/Component_Reference/en-US/Author_Group.xml
===================================================================
--- root/docs/trunk/Component_Reference/en-US/Author_Group.xml 2009-12-21 06:48:31 UTC
(rev 16174)
+++ root/docs/trunk/Component_Reference/en-US/Author_Group.xml 2009-12-21 07:03:04 UTC
(rev 16175)
@@ -1,9 +1,6 @@
<?xml version='1.0' encoding='utf-8' ?>
<!DOCTYPE authorgroup PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
-<!ENTITY % BOOK_ENTITIES SYSTEM "Component_Reference.ent">
-%BOOK_ENTITIES;
]>
-
<authorgroup>
<author>
<firstname>Sean</firstname>
Modified: root/docs/trunk/Component_Reference/en-US/Book_Info.xml
===================================================================
--- root/docs/trunk/Component_Reference/en-US/Book_Info.xml 2009-12-21 06:48:31 UTC (rev
16174)
+++ root/docs/trunk/Component_Reference/en-US/Book_Info.xml 2009-12-21 07:03:04 UTC (rev
16175)
@@ -1,9 +1,6 @@
<?xml version='1.0' encoding='utf-8' ?>
<!DOCTYPE bookinfo PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
-<!ENTITY % BOOK_ENTITIES SYSTEM "Component_Reference.ent">
-%BOOK_ENTITIES;
]>
-
<bookinfo id="book-Component_Reference-Component_Reference">
<title>Component Reference</title>
<subtitle>A reference guide to the components of the RichFaces
&VERSION_LONG;<remark> (draft)</remark>
@@ -13,25 +10,28 @@
<edition>0</edition>
<pubsnumber>1</pubsnumber>
<abstract>
- <para>This book details each component in the RichFaces &VERSION;
-framework, including examples of their use in
applications.</para></abstract>
- <corpauthor>
- <inlinemediaobject>
- <imageobject>
- <imagedata fileref="./images/rf_logo.png" format="PNG"
scalefit="1" />
- </imageobject>
- <textobject>
- <phrase>Logo</phrase>
- </textobject>
- </inlinemediaobject>
- </corpauthor>
- <copyright>
- <year>&YEAR;</year>
- <holder>&HOLDER;</holder>
- </copyright>
- <!-- FOR PUBLICAN --><xi:include
href="Common_Content/Legal_Notice.xml"
xmlns:xi="http://www.w3.org/2001/XInclude"><!-- FOR
JDOCBOOK: --><xi:fallback
xmlns:xi="http://www.w3.org/2001/XInclude"><xi:include
href="fallback_content/Legal_Notice.xml"
xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include>
- </xi:fallback>
- </xi:include>
- <xi:include href="Author_Group.xml"
xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include>
- </bookinfo>
-
+ <para>
+This book details each component in the RichFaces &VERSION;
+framework, including examples of their use in applications.
+</para>
+ </abstract>
+ <corpauthor>
+ <inlinemediaobject>
+ <imageobject>
+ <imagedata fileref="./images/rf_logo.png" format="PNG"
scalefit="1" />
+ </imageobject>
+ <textobject>
+ <phrase>Logo</phrase>
+ </textobject>
+ </inlinemediaobject>
+ </corpauthor>
+ <copyright>
+ <year>&YEAR;</year>
+ <holder>&HOLDER;</holder>
+ </copyright>
+ <!-- FOR PUBLICAN --><xi:include
href="Common_Content/Legal_Notice.xml"
xmlns:xi="http://www.w3.org/2001/XInclude"><!-- FOR
JDOCBOOK: --><xi:fallback
xmlns:xi="http://www.w3.org/2001/XInclude"><xi:include
href="fallback_content/Legal_Notice.xml"
xmlns:xi="http://www.w3.org/2001/XInclude" />
+ </xi:fallback>
+ </xi:include>
+ <xi:include href="Author_Group.xml"
xmlns:xi="http://www.w3.org/2001/XInclude" />
+</bookinfo>
+
Modified: root/docs/trunk/Component_Reference/en-US/Component_Reference.xml
===================================================================
--- root/docs/trunk/Component_Reference/en-US/Component_Reference.xml 2009-12-21 06:48:31
UTC (rev 16174)
+++ root/docs/trunk/Component_Reference/en-US/Component_Reference.xml 2009-12-21 07:03:04
UTC (rev 16175)
@@ -1,38 +1,34 @@
<?xml version='1.0' encoding='utf-8' ?>
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
-<!ENTITY % BOOK_ENTITIES SYSTEM "Component_Reference.ent">
-%BOOK_ENTITIES;
]>
-
<book status="draft">
- <xi:include href="Book_Info.xml"
xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include>
- <!--
+ <xi:include href="Book_Info.xml"
xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <!--
<xi:include href="Preface.xml"
xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include>
- -->
- <xi:include href="chap-Component_Reference-Introduction.xml"
xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include>
- <xi:include href="chap-Component_Reference-Common_Ajax_attributes.xml"
xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include>
- <xi:include href="chap-Component_Reference-Common_features.xml"
xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include>
+ --><xi:include href="chap-Component_Reference-Introduction.xml"
xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="chap-Component_Reference-Common_Ajax_attributes.xml"
xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="chap-Component_Reference-Common_features.xml"
xmlns:xi="http://www.w3.org/2001/XInclude" />
<part id="part-Component_Reference-a4j_tag_library">
<title>a4j tag library</title>
- <xi:include href="chap-Component_Reference-Actions.xml"
xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include>
- <xi:include href="chap-Component_Reference-Resources.xml"
xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include>
- <xi:include href="chap-Component_Reference-Containers.xml"
xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include>
- <xi:include href="chap-Component_Reference-Validation.xml"
xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include>
- <xi:include href="chap-Component_Reference-Processing_management.xml"
xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include>
+ <xi:include href="chap-Component_Reference-Actions.xml"
xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="chap-Component_Reference-Resources.xml"
xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="chap-Component_Reference-Containers.xml"
xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="chap-Component_Reference-Validation.xml"
xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="chap-Component_Reference-Processing_management.xml"
xmlns:xi="http://www.w3.org/2001/XInclude" />
</part>
<part id="part-Component_Reference-rich_tag_library">
<title>rich tag library</title>
- <xi:include href="chap-Component_Reference-Rich_inputs.xml"
xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include>
- <xi:include href="chap-Component_Reference-Panels_and_containers.xml"
xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include>
- <xi:include href="chap-Component_Reference-Tables_and_grids.xml"
xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include>
- <xi:include href="chap-Component_Reference-Trees.xml"
xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include>
- <xi:include href="chap-Component_Reference-Menus_and_toolbars.xml"
xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include>
- <xi:include href="chap-Component_Reference-Output_and_messages.xml"
xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include>
- <xi:include href="chap-Component_Reference-Drag_and_drop.xml"
xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include>
- <xi:include href="chap-Component_Reference-Layout_and_appearance.xml"
xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include>
- <xi:include href="chap-Component_Reference-Functions.xml"
xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include>
- <xi:include href="chap-Component_Reference-Functionality_extension.xml"
xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include>
+ <xi:include href="chap-Component_Reference-Rich_inputs.xml"
xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="chap-Component_Reference-Panels_and_containers.xml"
xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="chap-Component_Reference-Tables_and_grids.xml"
xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="chap-Component_Reference-Trees.xml"
xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="chap-Component_Reference-Menus_and_toolbars.xml"
xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="chap-Component_Reference-Output_and_messages.xml"
xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="chap-Component_Reference-Drag_and_drop.xml"
xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="chap-Component_Reference-Layout_and_appearance.xml"
xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="chap-Component_Reference-Functions.xml"
xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="chap-Component_Reference-Functionality_extension.xml"
xmlns:xi="http://www.w3.org/2001/XInclude" />
</part>
- <xi:include href="Revision_History.xml"
xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include>
+ <xi:include href="Revision_History.xml"
xmlns:xi="http://www.w3.org/2001/XInclude" />
</book>
Modified: root/docs/trunk/Component_Reference/en-US/Preface.xml
===================================================================
--- root/docs/trunk/Component_Reference/en-US/Preface.xml 2009-12-21 06:48:31 UTC (rev
16174)
+++ root/docs/trunk/Component_Reference/en-US/Preface.xml 2009-12-21 07:03:04 UTC (rev
16175)
@@ -1,28 +1,15 @@
<?xml version='1.0' encoding='utf-8' ?>
<!DOCTYPE preface PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
-<!ENTITY % BOOK_ENTITIES SYSTEM "Component_Reference.ent">
-%BOOK_ENTITIES;
]>
-
<preface id="pref-Component_Reference-Preface">
<title>Preface</title>
- <!-- FOR JDOCBOOK -->
- <xi:include href="Common_Content/Conventions.xml"
xmlns:xi="http://www.w3.org/2001/XInclude">
- <!-- FOR PUBLICAN -->
- <xi:fallback
xmlns:xi="http://www.w3.org/2001/XInclude">
- <xi:include href="fallback_content/Conventions.xml"
xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include>
- </xi:fallback>
+ <!-- FOR JDOCBOOK --><xi:include
href="Common_Content/Conventions.xml"
xmlns:xi="http://www.w3.org/2001/XInclude"><!-- FOR
PUBLICAN --><xi:fallback
xmlns:xi="http://www.w3.org/2001/XInclude"><xi:include
href="fallback_content/Conventions.xml"
xmlns:xi="http://www.w3.org/2001/XInclude" />
+ </xi:fallback>
</xi:include>
- <!-- PUBLICAN'S ORIGINAL XINCLUDES -->
- <xi:include href="Feedback.xml"
xmlns:xi="http://www.w3.org/2001/XInclude">
- <xi:fallback
xmlns:xi="http://www.w3.org/2001/XInclude">
- <xi:include href="Common_Content/Feedback.xml"
xmlns:xi="http://www.w3.org/2001/XInclude">
- <!-- FOR JDOCBOOK -->
- <xi:fallback
xmlns:xi="http://www.w3.org/2001/XInclude">
- <xi:include href="fallback_content/Feedback.xml"
xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include>
- </xi:fallback>
- </xi:include>
- </xi:fallback>
+ <!-- PUBLICAN'S ORIGINAL XINCLUDES
--><xi:include href="Feedback.xml"
xmlns:xi="http://www.w3.org/2001/XInclude"><xi:fallback
xmlns:xi="http://www.w3.org/2001/XInclude"><xi:include
href="Common_Content/Feedback.xml"
xmlns:xi="http://www.w3.org/2001/XInclude"><!-- FOR
JDOCBOOK --><xi:fallback
xmlns:xi="http://www.w3.org/2001/XInclude"><xi:include
href="fallback_content/Feedback.xml"
xmlns:xi="http://www.w3.org/2001/XInclude" />
+ </xi:fallback>
</xi:include>
+ </xi:fallback>
+ </xi:include>
</preface>
Modified: root/docs/trunk/Component_Reference/en-US/Revision_History.xml
===================================================================
--- root/docs/trunk/Component_Reference/en-US/Revision_History.xml 2009-12-21 06:48:31 UTC
(rev 16174)
+++ root/docs/trunk/Component_Reference/en-US/Revision_History.xml 2009-12-21 07:03:04 UTC
(rev 16175)
@@ -1,9 +1,6 @@
<?xml version='1.0' encoding='utf-8' ?>
<!DOCTYPE appendix PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
-<!ENTITY % BOOK_ENTITIES SYSTEM "Component_Reference.ent">
-%BOOK_ENTITIES;
]>
-
<appendix id="appe-Component_Reference-Revision_History">
<title>Revision History</title>
<simpara>
Modified: root/docs/trunk/Component_Reference/en-US/chap-Component_Reference-Actions.xml
===================================================================
---
root/docs/trunk/Component_Reference/en-US/chap-Component_Reference-Actions.xml 2009-12-21
06:48:31 UTC (rev 16174)
+++
root/docs/trunk/Component_Reference/en-US/chap-Component_Reference-Actions.xml 2009-12-21
07:03:04 UTC (rev 16175)
@@ -1,9 +1,6 @@
<?xml version='1.0' encoding='utf-8' ?>
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
-<!ENTITY % BOOK_ENTITIES SYSTEM "Component_Reference.ent">
-%BOOK_ENTITIES;
]>
-
<chapter id="chap-Component_Reference-Actions">
<title>Actions</title>
<para>
@@ -51,11 +48,13 @@
</para>
<example
id="exam-Component_Reference-a4jactionParam-a4jactionParam_example">
<title><a4j:actionParam> example</title>
+
<programlisting language="XML" role="XML">
-<xi:include parse="text"
href="extras/exam-Component_Reference-a4jactionParam-a4jactionParam_example.xmlt"
xmlns:xi="http://www.w3.org/2001/XInclude" />
+<xi:include
href="extras/exam-Component_Reference-a4jactionParam-a4jactionParam_example.xml_sample"
parse="text"
xmlns:xi="http://www.w3.org/2001/XInclude" />
</programlisting>
+
<programlisting language="Java" role="JAVA">
-<xi:include parse="text"
href="extras/exam-Component_Reference-a4jactionParam-a4jactionParam_example.js"
xmlns:xi="http://www.w3.org/2001/XInclude" />
+<xi:include
href="extras/exam-Component_Reference-a4jactionParam-a4jactionParam_example.js"
parse="text"
xmlns:xi="http://www.w3.org/2001/XInclude" />
</programlisting>
</example>
<para>
@@ -254,7 +253,7 @@
<title><a4j:jsFunction> example</title>
<programlisting language="XML" role="XML">
-<xi:include
href="extras/exam-Component_Reference-a4jjsFunction-a4jjsFunction_example.xmlt"
parse="text"
xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include>
+<xi:include
href="extras/exam-Component_Reference-a4jjsFunction-a4jjsFunction_example.xml_sample"
parse="text"
xmlns:xi="http://www.w3.org/2001/XInclude" />
</programlisting>
</example>
<para>
Modified:
root/docs/trunk/Component_Reference/en-US/chap-Component_Reference-Common_Ajax_attributes.xml
===================================================================
---
root/docs/trunk/Component_Reference/en-US/chap-Component_Reference-Common_Ajax_attributes.xml 2009-12-21
06:48:31 UTC (rev 16174)
+++
root/docs/trunk/Component_Reference/en-US/chap-Component_Reference-Common_Ajax_attributes.xml 2009-12-21
07:03:04 UTC (rev 16175)
@@ -1,9 +1,6 @@
<?xml version='1.0' encoding='utf-8' ?>
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
-<!ENTITY % BOOK_ENTITIES SYSTEM "Component_Reference.ent">
-%BOOK_ENTITIES;
]>
-
<chapter id="chap-Component_Reference-Common_Ajax_attributes">
<title>Common Ajax attributes</title>
<para>
@@ -17,7 +14,7 @@
<section id="sect-Component_Reference-Rendering-render">
<title><varname>render</varname></title>
<para>
- The <varname>render</varname> attribute provides a reference to one or
more areas on the page that need updating after an Ajax interaction. It uses the
<methodname>UIComponent.findComponent()</methodname> algorithm to find the
components in the component tree using their <varname>id</varname> attributes
as a reference. Components can be referenced by their <varname>id</varname>
attribute alone, or by a hierarchy of components'
<varname>id</varname> attributes to make locating components more efficient.
<xref linkend="exam-Component_Reference-render-render_example" /> shows
both ways of referencing components. Each command button will correctly render the
referenced panel grids, but the second button locates the references more efficiently with
explicit hierarchy paths.
+ The <varname>render</varname> attribute provides a reference to one or
more areas on the page that need updating after an Ajax interaction. It uses the
<methodname>UIComponent.findComponent()</methodname> algorithm to find the
components in the component tree using their <varname>id</varname> attributes
as a reference. Components can be referenced by their <varname>id</varname>
attribute alone, or by a hierarchy of components' <varname>id</varname>
attributes to make locating components more efficient. <xref
linkend="exam-Component_Reference-render-render_example" /> shows both ways
of referencing components. Each command button will correctly render the referenced panel
grids, but the second button locates the references more efficiently with explicit
hierarchy paths.
</para>
<example id="exam-Component_Reference-render-render_example">
<title>render example</title>
@@ -40,12 +37,12 @@
</programlisting>
</example>
<para>
- The value of the <varname>render</varname> attribute can also be an
expression written using JavaServer Faces' Expression Language
(<acronym>EL</acronym>); this can either be a <type>Set</type>,
<type>Collection</type>, <type>Array</type>, or
<type>String</type>.
+ The value of the <varname>render</varname> attribute can also be an
expression written using JavaServer Faces' Expression Language
(<acronym>EL</acronym>); this can either be a <type>Set</type>,
<type>Collection</type>, <type>Array</type>, or
<type>String</type>.
</para>
<important>
<title>Important</title>
<para>
- A common problem with using <varname>render</varname> occurs when the
referenced component has a <varname>rendered</varname> attribute.
<acronym>JSF</acronym> does not mark the place in the browser's
Document Object Model (<acronym>DOM</acronym>) where the rendered component
would be placed in case the <varname>rendered</varname> attribute returns
<literal>false</literal>. As such, when RichFaces sends the render code to the
client, the page does not update as the place for the update is not known.
+ A common problem with using <varname>render</varname> occurs when the
referenced component has a <varname>rendered</varname> attribute.
<acronym>JSF</acronym> does not mark the place in the browser's Document
Object Model (<acronym>DOM</acronym>) where the rendered component would be
placed in case the <varname>rendered</varname> attribute returns
<literal>false</literal>. As such, when RichFaces sends the render code to the
client, the page does not update as the place for the update is not known.
</para>
<para>
To work around this issue, wrap the component to be rendered in an
<sgmltag><a4j:outputPanel></sgmltag> with
<code>layout="none"</code>. The
<sgmltag><a4j:outputPanel></sgmltag> will receive the update and
render the component as required.
@@ -56,7 +53,7 @@
<section id="sect-Component_Reference-Rendering-ajaxRendered">
<title>ajaxRendered</title>
<para>
- A component with <code>ajaxRendered="true"</code> will be
re-rendered with <emphasis>every</emphasis> Ajax request, even when not
referenced by the requesting component's <varname>render</varname>
attribute. This can be useful for updating a status display or error message without
explicitly requesting it.
+ A component with <code>ajaxRendered="true"</code> will be
re-rendered with <emphasis>every</emphasis> Ajax request, even when not
referenced by the requesting component's <varname>render</varname>
attribute. This can be useful for updating a status display or error message without
explicitly requesting it.
</para>
<para>
Rendering of components in this way can be repressed by adding
<code>limitRender="true"</code> to the requesting component, as
described in <xref linkend="sect-Component_Reference-Rendering-limitRender"
/>.
@@ -69,7 +66,7 @@
A component with <code>limitRender="true"</code> specified will
<emphasis>not</emphasis> cause components with
<code>ajaxRendered="true"</code> to re-render, and only those
components listed in the <varname>render</varname> attribute will be updated.
This essentially overrides the <varname>ajaxRendered</varname> attribute in
other components.
</para>
<para>
- <xref linkend="exam-Component_Reference-data-Data_reference_example"
/> describes two command buttons, a panel grid rendered by the buttons, and an output
panel showing error messages. When the first button is clicked, the output panel is
rendered even though it is not explicitly referenced with the
<varname>render</varname> attribute. The second button, however, uses
<code>limitRender="true"</code> to override the output
panel's rendering and only render the panel grid.
+ <xref linkend="exam-Component_Reference-data-Data_reference_example"
/> describes two command buttons, a panel grid rendered by the buttons, and an output
panel showing error messages. When the first button is clicked, the output panel is
rendered even though it is not explicitly referenced with the
<varname>render</varname> attribute. The second button, however, uses
<code>limitRender="true"</code> to override the output panel's
rendering and only render the panel grid.
</para>
<example id="exam-Component_Reference-limitRender-Rendering_example">
<title>Rendering example</title>
@@ -124,7 +121,7 @@
<section
id="sect-Component_Reference-Common_Ajax_attributes-Data_processing">
<title>Data processing</title>
<para>
- RichFaces uses a form-based approach for sending Ajax requests. As such, each time a
request is sent the data from the requesting component's parent
<acronym>JSF</acronym> form is submitted along with the
<acronym>XMLHTTPRequest</acronym> object. The form data contains values from
the input element and auxiliary information such as state-saving data.
+ RichFaces uses a form-based approach for sending Ajax requests. As such, each time a
request is sent the data from the requesting component's parent
<acronym>JSF</acronym> form is submitted along with the
<acronym>XMLHTTPRequest</acronym> object. The form data contains values from
the input element and auxiliary information such as state-saving data.
</para>
<section id="sect-Component_Reference-Data_processing-process">
<title>process</title>
Modified:
root/docs/trunk/Component_Reference/en-US/chap-Component_Reference-Common_features.xml
===================================================================
---
root/docs/trunk/Component_Reference/en-US/chap-Component_Reference-Common_features.xml 2009-12-21
06:48:31 UTC (rev 16174)
+++
root/docs/trunk/Component_Reference/en-US/chap-Component_Reference-Common_features.xml 2009-12-21
07:03:04 UTC (rev 16175)
@@ -1,9 +1,6 @@
<?xml version='1.0' encoding='utf-8' ?>
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
-<!ENTITY % BOOK_ENTITIES SYSTEM "Component_Reference.ent">
-%BOOK_ENTITIES;
]>
-
<chapter id="chap-Component_Reference-Common_features">
<title>Common features</title>
<para>
Modified:
root/docs/trunk/Component_Reference/en-US/chap-Component_Reference-Containers.xml
===================================================================
---
root/docs/trunk/Component_Reference/en-US/chap-Component_Reference-Containers.xml 2009-12-21
06:48:31 UTC (rev 16174)
+++
root/docs/trunk/Component_Reference/en-US/chap-Component_Reference-Containers.xml 2009-12-21
07:03:04 UTC (rev 16175)
@@ -1,9 +1,6 @@
<?xml version='1.0' encoding='utf-8' ?>
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
-<!ENTITY % BOOK_ENTITIES SYSTEM "Component_Reference.ent">
-%BOOK_ENTITIES;
]>
-
<chapter id="chap-Component_Reference-Containers">
<title>Containers</title>
<para>
Modified:
root/docs/trunk/Component_Reference/en-US/chap-Component_Reference-Drag_and_drop.xml
===================================================================
---
root/docs/trunk/Component_Reference/en-US/chap-Component_Reference-Drag_and_drop.xml 2009-12-21
06:48:31 UTC (rev 16174)
+++
root/docs/trunk/Component_Reference/en-US/chap-Component_Reference-Drag_and_drop.xml 2009-12-21
07:03:04 UTC (rev 16175)
@@ -1,9 +1,6 @@
<?xml version='1.0' encoding='utf-8' ?>
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
-<!ENTITY % BOOK_ENTITIES SYSTEM "Component_Reference.ent">
-%BOOK_ENTITIES;
]>
-
<chapter id="chap-Component_Reference-Drag_and_drop">
<title>Drag and drop</title>
<para>
Modified:
root/docs/trunk/Component_Reference/en-US/chap-Component_Reference-Functionality_extension.xml
===================================================================
---
root/docs/trunk/Component_Reference/en-US/chap-Component_Reference-Functionality_extension.xml 2009-12-21
06:48:31 UTC (rev 16174)
+++
root/docs/trunk/Component_Reference/en-US/chap-Component_Reference-Functionality_extension.xml 2009-12-21
07:03:04 UTC (rev 16175)
@@ -1,9 +1,6 @@
<?xml version='1.0' encoding='utf-8' ?>
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
-<!ENTITY % BOOK_ENTITIES SYSTEM "Component_Reference.ent">
-%BOOK_ENTITIES;
]>
-
<chapter id="chap-Component_Reference-Functionality_extension">
<title>Functionality extension</title>
<para>
Modified:
root/docs/trunk/Component_Reference/en-US/chap-Component_Reference-Functions.xml
===================================================================
---
root/docs/trunk/Component_Reference/en-US/chap-Component_Reference-Functions.xml 2009-12-21
06:48:31 UTC (rev 16174)
+++
root/docs/trunk/Component_Reference/en-US/chap-Component_Reference-Functions.xml 2009-12-21
07:03:04 UTC (rev 16175)
@@ -1,9 +1,6 @@
<?xml version='1.0' encoding='utf-8' ?>
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
-<!ENTITY % BOOK_ENTITIES SYSTEM "Component_Reference.ent">
-%BOOK_ENTITIES;
]>
-
<chapter id="chap-Component_Reference-Functions">
<title>Functions</title>
<para>
Modified:
root/docs/trunk/Component_Reference/en-US/chap-Component_Reference-Introduction.xml
===================================================================
---
root/docs/trunk/Component_Reference/en-US/chap-Component_Reference-Introduction.xml 2009-12-21
06:48:31 UTC (rev 16174)
+++
root/docs/trunk/Component_Reference/en-US/chap-Component_Reference-Introduction.xml 2009-12-21
07:03:04 UTC (rev 16175)
@@ -1,9 +1,6 @@
<?xml version='1.0' encoding='utf-8' ?>
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
-<!ENTITY % BOOK_ENTITIES SYSTEM "Component_Reference.ent">
-%BOOK_ENTITIES;
]>
-
<chapter id="chap-Component_Reference-Introduction">
<title>Introduction</title>
<para>
@@ -15,7 +12,7 @@
<section id="sect-Component_Reference-Introduction-Libraries">
<title>Libraries</title>
<para>
- The RichFaces framework as it now stands is made up of two tag libraries: the
<classname>a4j</classname> library and the
<classname>rich</classname> library. The
<classname>a4j</classname> tag library represents Ajax4jsf, which provides
page-level Ajax support with core Ajax components. This allows developers to make use of
custom Ajax behavior with existing components. The <classname>rich</classname>
tag library provides Ajax support at the component level instead, and includes ready-made,
self-contained components. These components don't require additional configuration
in order to send requests or update.
+ The RichFaces framework as it now stands is made up of two tag libraries: the
<classname>a4j</classname> library and the
<classname>rich</classname> library. The
<classname>a4j</classname> tag library represents Ajax4jsf, which provides
page-level Ajax support with core Ajax components. This allows developers to make use of
custom Ajax behavior with existing components. The <classname>rich</classname>
tag library provides Ajax support at the component level instead, and includes ready-made,
self-contained components. These components don't require additional configuration in
order to send requests or update.
</para>
<note>
<title>Note</title>
Modified:
root/docs/trunk/Component_Reference/en-US/chap-Component_Reference-Layout_and_appearance.xml
===================================================================
---
root/docs/trunk/Component_Reference/en-US/chap-Component_Reference-Layout_and_appearance.xml 2009-12-21
06:48:31 UTC (rev 16174)
+++
root/docs/trunk/Component_Reference/en-US/chap-Component_Reference-Layout_and_appearance.xml 2009-12-21
07:03:04 UTC (rev 16175)
@@ -1,9 +1,6 @@
<?xml version='1.0' encoding='utf-8' ?>
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
-<!ENTITY % BOOK_ENTITIES SYSTEM "Component_Reference.ent">
-%BOOK_ENTITIES;
]>
-
<chapter id="chap-Component_Reference-Layout_and_appearance">
<title>Layout and appearance</title>
<para>
Modified:
root/docs/trunk/Component_Reference/en-US/chap-Component_Reference-Menus_and_toolbars.xml
===================================================================
---
root/docs/trunk/Component_Reference/en-US/chap-Component_Reference-Menus_and_toolbars.xml 2009-12-21
06:48:31 UTC (rev 16174)
+++
root/docs/trunk/Component_Reference/en-US/chap-Component_Reference-Menus_and_toolbars.xml 2009-12-21
07:03:04 UTC (rev 16175)
@@ -1,9 +1,6 @@
<?xml version='1.0' encoding='utf-8' ?>
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
-<!ENTITY % BOOK_ENTITIES SYSTEM "Component_Reference.ent">
-%BOOK_ENTITIES;
]>
-
<chapter id="chap-Component_Reference-Menus_and_toolbars">
<title>Menus and toolbars</title>
<para>
@@ -47,7 +44,7 @@
<section
id="sect-Component_Reference-Menus_and_toolbars-richpanelMenu">
<title><rich:panelMenu></title>
<para>
- The <classname><rich:panelMenu></classname> component can be
used in conjunction with
<classname><rich:panelMenuItem></classname> and
<classname><rich:panelMenuGroup></classname> to create an
expanding, hierarchical menu. The
<classname><rich:panelMenu></classname> component's
appearance can be highly customized, and the hierarchy can stretch to any number of
sub-levels.
+ The <classname><rich:panelMenu></classname> component can be
used in conjunction with
<classname><rich:panelMenuItem></classname> and
<classname><rich:panelMenuGroup></classname> to create an
expanding, hierarchical menu. The
<classname><rich:panelMenu></classname> component's
appearance can be highly customized, and the hierarchy can stretch to any number of
sub-levels.
</para>
<para>
The <code>selectedChild</code> attribute is used to point to the name of
the currently selected menu item.
@@ -83,7 +80,7 @@
The <classname><rich:panelMenuGroup></classname> component
defines a group of <classname><rich:panelMenuItem></classname>
components inside a <classname><rich:panelMenu></classname>.
</para>
<para>
- If the <code>expandMode</code> is unspecified, the submission behavior for
the group is inherited from the parent
<classname><rich:panelMenu></classname>. Otherwise, the
<code>expandMode</code> setting is used instead of the parent's
behavior.
+ If the <code>expandMode</code> is unspecified, the submission behavior for
the group is inherited from the parent
<classname><rich:panelMenu></classname>. Otherwise, the
<code>expandMode</code> setting is used instead of the parent's behavior.
</para>
<para>
Icons for the menu group can be chosen from a set of standard icons. There are three
attributes that relate to the different menu states that the icon represents:
<code>iconExpanded</code>, <code>iconCollapsed</code>, and
<code>iconDisabled</code>. The standard icons are shown in <xref
linkend="figu-Component_Reference-richpanelMenuGroup-Standard_icons" />.
@@ -118,7 +115,7 @@
The <classname><rich:panelMenuItem></classname> component
represents a single item inside a
<classname><rich:panelMenuGroup></classname> component, which is
in turn part of a <classname><rich:panelMenu></classname>
component.
</para>
<para>
- If the <code>mode</code> is unspecified, the submission behavior for the
item is inherited from the parent
<classname><rich:panelMenu></classname>. Otherwise, the
<code>mode</code> setting is used instead of the parent's behavior.
+ If the <code>mode</code> is unspecified, the submission behavior for the
item is inherited from the parent
<classname><rich:panelMenu></classname>. Otherwise, the
<code>mode</code> setting is used instead of the parent's behavior.
</para>
<para>
Icons for menu items can be chosen from a set of standard icons. There are two
attributes that relate to the different menu states that the icon represents:
<code>icon</code> and <code>iconDisabled</code>. The standard
icons are shown in <xref
linkend="figu-Component_Reference-richcolumn-Basic_column_example" />.
Modified:
root/docs/trunk/Component_Reference/en-US/chap-Component_Reference-Output_and_messages.xml
===================================================================
---
root/docs/trunk/Component_Reference/en-US/chap-Component_Reference-Output_and_messages.xml 2009-12-21
06:48:31 UTC (rev 16174)
+++
root/docs/trunk/Component_Reference/en-US/chap-Component_Reference-Output_and_messages.xml 2009-12-21
07:03:04 UTC (rev 16175)
@@ -1,9 +1,6 @@
<?xml version='1.0' encoding='utf-8' ?>
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
-<!ENTITY % BOOK_ENTITIES SYSTEM "Component_Reference.ent">
-%BOOK_ENTITIES;
]>
-
<chapter id="chap-Component_Reference-Output_and_messages">
<title>Output and messages</title>
<para>
Modified:
root/docs/trunk/Component_Reference/en-US/chap-Component_Reference-Panels_and_containers.xml
===================================================================
---
root/docs/trunk/Component_Reference/en-US/chap-Component_Reference-Panels_and_containers.xml 2009-12-21
06:48:31 UTC (rev 16174)
+++
root/docs/trunk/Component_Reference/en-US/chap-Component_Reference-Panels_and_containers.xml 2009-12-21
07:03:04 UTC (rev 16175)
@@ -1,9 +1,6 @@
<?xml version='1.0' encoding='utf-8' ?>
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
-<!ENTITY % BOOK_ENTITIES SYSTEM "Component_Reference.ent">
-%BOOK_ENTITIES;
]>
-
<chapter id="chap-Component_Reference-Panels_and_containers">
<title>Panels and containers</title>
<para>
@@ -30,10 +27,10 @@
<title><rich:modalPanel> example</title>
<programlisting language="XML" role="XML">
-<a onclick="Richfaces.showModalPanel('pnl');"
href="#">Show ModalPanel</a>
+<a onclick="Richfaces.showModalPanel('pnl');"
href="#">Show ModalPanel</a>
<a4j:form>
<rich:modalPanel id="pnl" >
- <a onclick="Richfaces.hideModalPanel('pnl');"
href="#">Hide ModalPanel</a>
+ <a onclick="Richfaces.hideModalPanel('pnl');"
href="#">Hide ModalPanel</a>
</rich:modalPanel>
</a4j:form>
</programlisting>
@@ -142,7 +139,7 @@
<section id="sect-Component_Reference-Panels_and_containers-richtab">
<title><rich:tab></title>
<para>
- The <sgmltag><rich:tab></sgmltag> component represents an
individual tab inside a <sgmltag><rich:tabPanel></sgmltag>
component, including the tab's content. Clicking on the tab header will bring its
corresponding content to the front of other tabs.
+ The <sgmltag><rich:tab></sgmltag> component represents an
individual tab inside a <sgmltag><rich:tabPanel></sgmltag>
component, including the tab's content. Clicking on the tab header will bring its
corresponding content to the front of other tabs.
</para>
<para>
Basic usage of the <sgmltag><rich:tab></sgmltag> component
requires the <code>label</code> attribute, which provides the text on the tab
header. The content of the tab is then detailed inside the
<sgmltag><rich:tab></sgmltag> tags.
Modified: root/docs/trunk/Component_Reference/en-US/chap-Component_Reference-Portals.xml
===================================================================
---
root/docs/trunk/Component_Reference/en-US/chap-Component_Reference-Portals.xml 2009-12-21
06:48:31 UTC (rev 16174)
+++
root/docs/trunk/Component_Reference/en-US/chap-Component_Reference-Portals.xml 2009-12-21
07:03:04 UTC (rev 16175)
@@ -1,9 +1,6 @@
<?xml version='1.0' encoding='utf-8' ?>
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
-<!ENTITY % BOOK_ENTITIES SYSTEM "Component_Reference.ent">
-%BOOK_ENTITIES;
]>
-
<chapter id="chap-Component_Reference-Portals">
<title>Portals</title>
<para>
Modified:
root/docs/trunk/Component_Reference/en-US/chap-Component_Reference-Processing_management.xml
===================================================================
---
root/docs/trunk/Component_Reference/en-US/chap-Component_Reference-Processing_management.xml 2009-12-21
06:48:31 UTC (rev 16174)
+++
root/docs/trunk/Component_Reference/en-US/chap-Component_Reference-Processing_management.xml 2009-12-21
07:03:04 UTC (rev 16175)
@@ -1,9 +1,6 @@
<?xml version='1.0' encoding='utf-8' ?>
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
-<!ENTITY % BOOK_ENTITIES SYSTEM "Component_Reference.ent">
-%BOOK_ENTITIES;
]>
-
<chapter id="chap-Component_Reference-Processing_management">
<title>Processing management</title>
<para>
Modified:
root/docs/trunk/Component_Reference/en-US/chap-Component_Reference-Resources.xml
===================================================================
---
root/docs/trunk/Component_Reference/en-US/chap-Component_Reference-Resources.xml 2009-12-21
06:48:31 UTC (rev 16174)
+++
root/docs/trunk/Component_Reference/en-US/chap-Component_Reference-Resources.xml 2009-12-21
07:03:04 UTC (rev 16175)
@@ -1,9 +1,6 @@
<?xml version='1.0' encoding='utf-8' ?>
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
-<!ENTITY % BOOK_ENTITIES SYSTEM "Component_Reference.ent">
-%BOOK_ENTITIES;
]>
-
<chapter id="chap-Component_Reference-Resources">
<title>Resources</title>
<para>
@@ -37,46 +34,50 @@
<para>
Resource bundles are registered in the Faces configuration file,
<filename>faces-config.xml</filename>.
</para>
- <example id="exam-Component_Reference-Resources-a4jloadBundle">
+ <example
id="exam-Component_Reference-a4jloadBundle-a4jloadBundle_example">
<title><sgmltag><a4j:loadBundle></sgmltag>
example</title>
<para>
This example shows a simple application capable of switching between different
localized languages.
</para>
<procedure>
- <step>
+ <step
id="step-Component_Reference-a4jloadBundle_example-Create_resource_bundles">
<title>Create resource bundles</title>
<para>
String resource bundles are contained in files with a <filename
class="extension">.properties</filename> extension. The files consist
of a list of entries, each with a unique name and a corresponding value. A seperate file
is required for each language. Append the filename with the locale identifier
(<literal>en</literal> for English, for example).
</para>
</step>
- <step>
+ <step
id="step-Component_Reference-a4jloadBundle_example-Register_bundles_in_Faces_configuration_file">
<title>Register bundles in Faces configuration file</title>
<para>
The resource bundles need to be registered in the Faces configuration file,
<filename>faces-config.xml</filename>. The filename is defined with the
<sgmltag><message-bundle></sgmltag> tag, without the locale code
and without the extension. The supported locale codes are listed with
<sgmltag><supported-locale></sgmltag> tags.
</para>
+
<programlisting language="XML" role="XML">
-<xi:include parse="text"
href="extras/exam-Component_Reference-Resources-a4jloadBundle-0.xml_sample"
xmlns:xi="http://www.w3.org/2001/XInclude" />
+<xi:include
href="extras/exam-Component_Reference-a4jloadBundle-a4jloadBundle_example-0.xml_sample"
parse="text"
xmlns:xi="http://www.w3.org/2001/XInclude" />
</programlisting>
</step>
- <step>
+ <step
id="step-Component_Reference-a4jloadBundle_example-Create_method_to_set_locale">
<title>Create method to set locale</title>
<para>
The <acronym>JSF</acronym>
<methodname>javax.faces.component.UIViewRoot.setLocale()</methodname> method
can be used to update the locale through a Java class:
</para>
+
<programlisting language="java" role="JAVA">
-<xi:include parse="text"
href="extras/exam-Component_Reference-Resources-a4jloadBundle-1.js"
xmlns:xi="http://www.w3.org/2001/XInclude" />
+<xi:include
href="extras/exam-Component_Reference-a4jloadBundle-a4jloadBundle_example-1.js"
parse="text"
xmlns:xi="http://www.w3.org/2001/XInclude" />
</programlisting>
</step>
- <step>
+ <step
id="step-Component_Reference-a4jloadBundle_example-Add_a4jloadBundle_to_the_JSP_page">
<title>Add <sgmltag><a4j:loadBundle></sgmltag> to
the <acronym>JSP</acronym> page</title>
<para>
The <sgmltag><a4j:loadBundle></sgmltag> component is
added to the application, and links to change the locale will update the displayed text.
</para>
+
<programlisting language="XML" role="XML">
-<xi:include parse="text"
href="extras/exam-Component_Reference-Resources-a4jloadBundle-2.xml_sample"
xmlns:xi="http://www.w3.org/2001/XInclude" />
+<xi:include
href="extras/exam-Component_Reference-a4jloadBundle-a4jloadBundle_example-2.xml_sample"
parse="text"
xmlns:xi="http://www.w3.org/2001/XInclude" />
</programlisting>
</step>
</procedure>
+
<para>
Clicking on the different links will render the localized string as appropriate.
</para>
@@ -113,8 +114,9 @@
<para>
The required <varname>src</varname> attribute defines the path to the
script. A leading slash (<literal>/</literal>) represents the root of the web
context. The <code>resource://</code> prefix can be used to access a file in
the RichFaces resource framework. The path is passed to the
<methodname>getResourceURL()</methodname> method of the application's
<classname>ViewHandler</classname>, with the result then being passed through
the <methodname>encodeResourceURL()</methodname> method of
<classname>ExternalContext</classname>.
</para>
- <example
id="exam-Component_Reference-Resources-a4jloadScript_example">
+ <example
id="exam-Component_Reference-a4jloadScript-a4jloadScript_example">
<title><sgmltag><a4j:loadScript></sgmltag>
example</title>
+
<programlisting language="XML" role="XML">
<a4j:loadScript src="resource:///org/mycompany/assets/script/focus.js"
/>
</programlisting>
@@ -151,8 +153,9 @@
<para>
The required <varname>src</varname> attribute defines the path to the
script. A leading slash (<literal>/</literal>) represents the root of the web
context. The <code>resource://</code> prefix can be used to access a file in
the RichFaces resource framework. The path is passed to the
<methodname>getResourceURL()</methodname> method of the application's
<classname>ViewHandler</classname>, with the result then being passed through
the <methodname>encodeResourceURL()</methodname> method of
<classname>ExternalContext</classname>.
</para>
- <example id="exam-Component_Reference-Resources-a4jloadStyle_example">
+ <example
id="exam-Component_Reference-a4jloadStyle-a4jloadStyle_example">
<title><sgmltag><a4j:loadStyle></sgmltag>
example</title>
+
<programlisting language="XML" role="XML">
<a4j:loadStyle src="resource:///org/mycompany/assets/script/focus.js"
/>
</programlisting>
@@ -187,8 +190,9 @@
<para>
The <varname>beanName</varname> attribute uses JSF Expression Language
(<acronym>EL</acronym>) to define the request scope bean name to keep alive.
The expression must resolve to a managed bean instance. The
<varname>ajaxOnly</varname> attribute determines whether or not the value of
the bean should be available during non-Ajaxx requests; if
<code>ajaxOnly="true"</code>, the request-scope bean keeps its value
during Ajax requests, but any non-Ajax requests will re-create the bean as a regular
request-scope bean.
</para>
- <example id="exam-Component_Reference-Resources-a4jkeepAlive_example">
+ <example
id="exam-Component_Reference-a4jkeepAlive-a4jkeepAlive_example">
<title><sgmltag><a4j:keepAlive></sgmltag>
example</title>
+
<programlisting language="XML" role="XML">
<a4j:keepAlive beanName="#{myClass.testBean}" />
</programlisting>
@@ -226,7 +230,7 @@
The <varname>createContent</varname> attribute points to the method used
for generating the displayed content. If necessary, the
<varname>value</varname> attribute can be used to pass input data to the
content generation method specified with <varname>createContent</varname>. The
<varname>cacheable</varname> attribute specifies whether the resulting content
will be cached or not.
</para>
<para>
- The <varname>mimeType</varname> attribute describes the type of output
content, and corresponds to the type in the header of the
<acronym>HTTP</acronym> request. The <varname>element</varname>
attribute defines <attribute>XHTML</attribute> element used to display the
content:
+ The <varname>mimeType</varname> attribute describes the type of output
content, and corresponds to the type in the header of the
<acronym>HTTP</acronym> request. The <varname>element</varname>
attribute defines <attribute>XHTML</attribute> element used to display the
content:
</para>
<itemizedlist>
<listitem>
@@ -260,25 +264,28 @@
</para>
</listitem>
</itemizedlist>
- <example
id="exam-Component_Reference-Resources-a4jmediaOutput_example">
+ <example
id="exam-Component_Reference-a4jmediaOutput-a4jmediaOutput_example">
<title><sgmltag><a4j:mediaOutput></sgmltag>
example</title>
<para>
This example uses the <sgmltag><a4j:mediaOutput></sgmltag>
component to generate a <acronym>JPEG</acronym> image of verification digits.
The code on the application page is a single element:
</para>
+
<programlisting language="XML" role="XML">
<a4j:mediaOutput element="img" cacheable="false"
session="false" createContent="#{mediaBean.paint}"
value="#{mediaData}" mimeType="image/jpeg" />
</programlisting>
<para>
The <sgmltag><a4j:mediaOutput></sgmltag> component uses the
<methodname>MediaBean.paint</methodname> method to create the image. The
method generates a random number, which is then converted into an output stream and
rendered to a <acronym>JPEG</acronym> image. The
<classname>MediaBean</classname> class is as follows:
</para>
+
<programlisting language="XML" role="XML">
-<xi:include parse="text"
href="extras/exam-Component_Reference-Resources-a4jmediaOutput_example-0.js"
xmlns:xi="http://www.w3.org/2001/XInclude" />
+<xi:include
href="extras/exam-Component_Reference-a4jmediaOutput-a4jmediaOutput_example-0.js"
parse="text"
xmlns:xi="http://www.w3.org/2001/XInclude" />
</programlisting>
<para>
Another class, <classname>MediaData</classname> is required by the
<varname>value</varname> attribute for keeping data to be used as input for
the content creation method. The <classname>MediaData</classname> class is as
follows:
</para>
+
<programlisting language="XML" role="XML">
-<xi:include parse="text"
href="extras/exam-Component_Reference-Resources-a4jmediaOutput_example-1.js"
xmlns:xi="http://www.w3.org/2001/XInclude" />
+<xi:include
href="extras/exam-Component_Reference-a4jmediaOutput-a4jmediaOutput_example-1.js"
parse="text"
xmlns:xi="http://www.w3.org/2001/XInclude" />
</programlisting>
</example>
<note>
@@ -288,13 +295,13 @@
</para>
</note>
<para>
- The <sgmltag><a4j:mediaOutput></sgmltag> component uses the
<classname>MediaBean</classname> and
<classname>MediaData</classname> classes to generate a new image on each page
refresh, which appears as
+ The <sgmltag><a4j:mediaOutput></sgmltag> component uses the
<classname>MediaBean</classname> and
<classname>MediaData</classname> classes to generate a new image on each page
refresh, which appears as
</para>
- <figure
id="figu-Component_Reference-Resources-a4jmediaOutput_example_result">
+ <figure
id="figu-Component_Reference-a4jmediaOutput-a4jmediaOutput_example_result">
<title><sgmltag><a4j:mediaOutput></sgmltag> example
result</title>
<mediaobject>
<imageobject>
- <imagedata
fileref="images/figu-Component_Reference-Resources-a4jmediaOutput_example_result.png"
format="PNG" />
+ <imagedata
fileref="images/figu-Component_Reference-a4jmediaOutput-a4jmediaOutput_example_result.png"
format="PNG" />
</imageobject>
<textobject>
<para>
Modified:
root/docs/trunk/Component_Reference/en-US/chap-Component_Reference-Rich_inputs.xml
===================================================================
---
root/docs/trunk/Component_Reference/en-US/chap-Component_Reference-Rich_inputs.xml 2009-12-21
06:48:31 UTC (rev 16174)
+++
root/docs/trunk/Component_Reference/en-US/chap-Component_Reference-Rich_inputs.xml 2009-12-21
07:03:04 UTC (rev 16175)
@@ -1,9 +1,6 @@
<?xml version='1.0' encoding='utf-8' ?>
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
-<!ENTITY % BOOK_ENTITIES SYSTEM "Component_Reference.ent">
-%BOOK_ENTITIES;
]>
-
<chapter id="chap-Component_Reference-Rich_inputs">
<title>Rich inputs</title>
<para>
@@ -24,7 +21,7 @@
The position at which the pop-up calendar displays relative to the text field and
button can be configured using the <varname>jointPoint</varname> and
<varname>direction</varname> attributes. The
<varname>jointPoint</varname> attribute refers to the corner of the text field
and button with which the calendar will be aligned and the
<varname>direction</varname> specifies which direction the pop-up calendar
will span relative to the joint point. The default settings are
<code>jointPoint="bottom-left"</code> and
<code>direction="bottom-right"</code>, causing the pop-up calendar
to align with the bottom-left corner of the text field and span to the bottom-right,
underneath the text field and button. The diagram shows the joint points and directions
that can be used. Alternatively, both <varname>jointPoint</varname> and
<varname>direction</varname> can be set to <literal>auto</literal>
to allow smart pop-up positioning.
</para>
<para>
- The calendar features a <guibutton>Today</guibutton> button for locating
today's date on the calendar. This can be set to three different values using the
<varname>todayControlMode</varname> attribute:
+ The calendar features a <guibutton>Today</guibutton> button for locating
today's date on the calendar. This can be set to three different values using the
<varname>todayControlMode</varname> attribute:
</para>
<itemizedlist>
<listitem>
@@ -34,12 +31,12 @@
</listitem>
<listitem>
<para>
- <literal>select</literal>, the default setting, which scrolls the
calendar to the current month and selects today's date; and
+ <literal>select</literal>, the default setting, which scrolls the
calendar to the current month and selects today's date; and
</para>
</listitem>
<listitem>
<para>
- <literal>scroll</literal>, which scrolls the calendar to the current
month but does not select today's date.
+ <literal>scroll</literal>, which scrolls the calendar to the current
month but does not select today's date.
</para>
</listitem>
</itemizedlist>
@@ -143,7 +140,7 @@
</listitem>
</itemizedlist>
<para>
- Users can type into the combo-box's text field to enter a value, which also
searches through the suggestion items in the drop-down box. By default, the first
suggestion item is selected as the user types. This behavior can be deactivated by setting
<code>selectFirstOnUpdate="false"</code>. Setting
<code>directInputSuggestions="true"</code> causes the combo-box to
fill the text field box with a matching suggestion as the user types. Alternatively, the
text field can be disabled by setting
<code>enableManualInput="false"</code>, which forces the users to
pick from items in the drop-down box.
+ Users can type into the combo-box's text field to enter a value, which also
searches through the suggestion items in the drop-down box. By default, the first
suggestion item is selected as the user types. This behavior can be deactivated by setting
<code>selectFirstOnUpdate="false"</code>. Setting
<code>directInputSuggestions="true"</code> causes the combo-box to
fill the text field box with a matching suggestion as the user types. Alternatively, the
text field can be disabled by setting
<code>enableManualInput="false"</code>, which forces the users to
pick from items in the drop-down box.
</para>
<para>
The <sgmltag><rich:comboBox></sgmltag> component has two
unique event handlers:
@@ -165,7 +162,7 @@
<section id="sect-Component_Reference-Rich_inputs-richeditor">
<title><rich:editor></title>
<para>
- The <sgmltag><rich:editor></sgmltag> component provides a
fully-featured word processor. It features manageable global configurations, and support
for Seam text, custom plug-ins, and a customized look and feel. The editor is fully based
on the TinyMCE JavaScript editor control, supporting all TinyMCE's parameters, and
is adapted for the <acronym>JSF</acronym> environment with some additional
capabilities.
+ The <sgmltag><rich:editor></sgmltag> component provides a
fully-featured word processor. It features manageable global configurations, and support
for Seam text, custom plug-ins, and a customized look and feel. The editor is fully based
on the TinyMCE JavaScript editor control, supporting all TinyMCE's parameters, and is
adapted for the <acronym>JSF</acronym> environment with some additional
capabilities.
</para>
</section>
@@ -355,7 +352,7 @@
<section
id="sect-Component_Reference-Rich_inputs-richinputNumberSlider">
<title><rich:inputNumberSlider></title>
<para>
- The <sgmltag><rich:inputNumberSlider></sgmltag> component
provides a slider for changing numerical values. Optional features include a tool-tip to
display the value while sliding, and a text field for typing the numerical value which can
then be validated against the slider's range.
+ The <sgmltag><rich:inputNumberSlider></sgmltag> component
provides a slider for changing numerical values. Optional features include a tool-tip to
display the value while sliding, and a text field for typing the numerical value which can
then be validated against the slider's range.
</para>
<para>
Basic use of the component with no attributes specified will render a slider with a
minimum value of 0, a maximum of 100, and a gradient step of 1, together with a text field
for typing the desired numerical value. The text field can be removed by setting
<code>showInput="false"</code>, and the properties of the slider can
be set with the attributes <varname>minValue</varname>,
<varname>maxValue</varname>, and <varname>step</varname>. The
slider is labeled with the minimum and maximum boundary values, and a tool-tip showing the
current value is shown while sliding the slider; these items can be turned off by setting
<code>showBoundaryValues="false"</code> and
<code>showToolTip="false"</code> respectively.
Modified:
root/docs/trunk/Component_Reference/en-US/chap-Component_Reference-Tables_and_grids.xml
===================================================================
---
root/docs/trunk/Component_Reference/en-US/chap-Component_Reference-Tables_and_grids.xml 2009-12-21
06:48:31 UTC (rev 16174)
+++
root/docs/trunk/Component_Reference/en-US/chap-Component_Reference-Tables_and_grids.xml 2009-12-21
07:03:04 UTC (rev 16175)
@@ -1,9 +1,6 @@
<?xml version='1.0' encoding='utf-8' ?>
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
-<!ENTITY % BOOK_ENTITIES SYSTEM "Component_Reference.ent">
-%BOOK_ENTITIES;
]>
-
<chapter id="chap-Component_Reference-Tables_and_grids">
<title>Tables and grids</title>
<para>
Modified: root/docs/trunk/Component_Reference/en-US/chap-Component_Reference-Trees.xml
===================================================================
---
root/docs/trunk/Component_Reference/en-US/chap-Component_Reference-Trees.xml 2009-12-21
06:48:31 UTC (rev 16174)
+++
root/docs/trunk/Component_Reference/en-US/chap-Component_Reference-Trees.xml 2009-12-21
07:03:04 UTC (rev 16175)
@@ -1,9 +1,6 @@
<?xml version='1.0' encoding='utf-8' ?>
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
-<!ENTITY % BOOK_ENTITIES SYSTEM "Component_Reference.ent">
-%BOOK_ENTITIES;
]>
-
<chapter id="chap-Component_Reference-Trees">
<title>Trees</title>
<para>
Modified:
root/docs/trunk/Component_Reference/en-US/chap-Component_Reference-Validation.xml
===================================================================
---
root/docs/trunk/Component_Reference/en-US/chap-Component_Reference-Validation.xml 2009-12-21
06:48:31 UTC (rev 16174)
+++
root/docs/trunk/Component_Reference/en-US/chap-Component_Reference-Validation.xml 2009-12-21
07:03:04 UTC (rev 16175)
@@ -1,9 +1,6 @@
<?xml version='1.0' encoding='utf-8' ?>
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
-<!ENTITY % BOOK_ENTITIES SYSTEM "Component_Reference.ent">
-%BOOK_ENTITIES;
]>
-
<chapter id="chap-Component_Reference-Validation">
<title>Validation</title>
<para>
Deleted:
root/docs/trunk/Component_Reference/en-US/extras/exam-Component_Reference-Resources-a4jloadBundle-0.xml_sample
===================================================================
---
root/docs/trunk/Component_Reference/en-US/extras/exam-Component_Reference-Resources-a4jloadBundle-0.xml_sample 2009-12-21
06:48:31 UTC (rev 16174)
+++
root/docs/trunk/Component_Reference/en-US/extras/exam-Component_Reference-Resources-a4jloadBundle-0.xml_sample 2009-12-21
07:03:04 UTC (rev 16175)
@@ -1,9 +0,0 @@
-<application>
- <locale-config>
- <default-locale>en</default-locale>
- <supported-locale>en</supported-locale>
- <supported-locale>de</supported-locale>
- <supported-locale>it</supported-locale>
- </locale-config>
- <message-bundle>demo.message</message-bundle>
-</application>
Deleted:
root/docs/trunk/Component_Reference/en-US/extras/exam-Component_Reference-Resources-a4jloadBundle-1.js
===================================================================
---
root/docs/trunk/Component_Reference/en-US/extras/exam-Component_Reference-Resources-a4jloadBundle-1.js 2009-12-21
06:48:31 UTC (rev 16174)
+++
root/docs/trunk/Component_Reference/en-US/extras/exam-Component_Reference-Resources-a4jloadBundle-1.js 2009-12-21
07:03:04 UTC (rev 16175)
@@ -1,44 +0,0 @@
-package demo;
-
-
- import java.util.Locale;
-
- import javax.faces.context.FacesContext;
-
-
- public class ChangeLocale {
-
- public String germanAction() {
-
- FacesContext context = FacesContext.getCurrentInstance();
-
- context.getViewRoot().setLocale(Locale.GERMAN);
-
- return null;
-
- }
-
-
- public String englishAction() {
-
- FacesContext context = FacesContext.getCurrentInstance();
-
- context.getViewRoot().setLocale(Locale.ENGLISH);
-
- return null;
-
- }
-
-
-
- public String italianAction() {
-
- FacesContext context = FacesContext.getCurrentInstance();
-
- context.getViewRoot().setLocale(Locale.ITALIAN);
-
- return null;
-
- }
-
-}
Deleted:
root/docs/trunk/Component_Reference/en-US/extras/exam-Component_Reference-Resources-a4jloadBundle-2.xml_sample
===================================================================
---
root/docs/trunk/Component_Reference/en-US/extras/exam-Component_Reference-Resources-a4jloadBundle-2.xml_sample 2009-12-21
06:48:31 UTC (rev 16174)
+++
root/docs/trunk/Component_Reference/en-US/extras/exam-Component_Reference-Resources-a4jloadBundle-2.xml_sample 2009-12-21
07:03:04 UTC (rev 16175)
@@ -1,8 +0,0 @@
-<h:form>
- <a4j:loadBundle var="msg" basename="demo.message"/>
- <h:outputText id="messageBundle" value="#{msg.greeting}"/>
- <a4j:commandLink value="De" action="#{changeLocale.germanAction}"
reRender="messageBundle" />
- <a4j:commandLink value="Eng"
action="#{changeLocale.englishAction}" reRender="messageBundle" />
- <a4j:commandLink value="It"
action="#{changeLocale.italianAction}" reRender="messageBundle" />
-</h:form>
-
Deleted:
root/docs/trunk/Component_Reference/en-US/extras/exam-Component_Reference-Resources-a4jmediaOutput_example-0.js
===================================================================
---
root/docs/trunk/Component_Reference/en-US/extras/exam-Component_Reference-Resources-a4jmediaOutput_example-0.js 2009-12-21
06:48:31 UTC (rev 16174)
+++
root/docs/trunk/Component_Reference/en-US/extras/exam-Component_Reference-Resources-a4jmediaOutput_example-0.js 2009-12-21
07:03:04 UTC (rev 16175)
@@ -1,31 +0,0 @@
-package demo;
-
-import java.awt.Graphics2D;
-import java.awt.image.BufferedImage;
-import java.io.IOException;
-import java.io.OutputStream;
-import java.util.Random;
-import javax.imageio.ImageIO;
-
-public class MediaBean {
-
- public void paint(OutputStream out, Object data) throws IOException {
-
- Integer high = 9999;
- Integer low = 1000;
- Random generator = new Random();
- Integer digits = generator.nextInt(high - low + 1) + low;
-
- if (data instanceof MediaData) {
- MediaData paintData = (MediaData) data;
- BufferedImage img = new
BufferedImage(paintData.getWidth(),paintData.getHeight(),BufferedImage.TYPE_INT_RGB);
- Graphics2D graphics2D = img.createGraphics();
- graphics2D.setBackground(paintData.getBackground());
- graphics2D.setColor(paintData.getDrawColor());
- graphics2D.clearRect(0,0,paintData.getWidth(),paintData.getHeight());
- graphics2D.setFont(paintData.getFont());
- graphics2D.drawString(digits.toString(), 20, 35);
- ImageIO.write(img,"png",out);
- }
- }
-}
Deleted:
root/docs/trunk/Component_Reference/en-US/extras/exam-Component_Reference-Resources-a4jmediaOutput_example-1.js
===================================================================
---
root/docs/trunk/Component_Reference/en-US/extras/exam-Component_Reference-Resources-a4jmediaOutput_example-1.js 2009-12-21
06:48:31 UTC (rev 16174)
+++
root/docs/trunk/Component_Reference/en-US/extras/exam-Component_Reference-Resources-a4jmediaOutput_example-1.js 2009-12-21
07:03:04 UTC (rev 16175)
@@ -1,22 +0,0 @@
-package demo;
-
-import java.awt.Color;
-import java.awt.Font;
-import java.io.Serializable;
-
-public class MediaData implements Serializable {
-
- private static final long serialVersionUID = 1L;
-
- Integer Width=110;
- Integer Height=50;
-
- Color Background=new Color(190, 214, 248);
- Color DrawColor=new Color(0,0,0);
-
- Font font = new Font("Serif", Font.TRUETYPE_FONT, 30);
-
- /* Corresponding getters and setters */
- ...
-
-}
Copied:
root/docs/trunk/Component_Reference/en-US/extras/exam-Component_Reference-a4jactionParam-a4jactionParam_example.xml_sample
(from rev 16173,
root/docs/trunk/Component_Reference/en-US/extras/exam-Component_Reference-a4jactionParam-a4jactionParam_example.xmlt)
===================================================================
---
root/docs/trunk/Component_Reference/en-US/extras/exam-Component_Reference-a4jactionParam-a4jactionParam_example.xml_sample
(rev 0)
+++
root/docs/trunk/Component_Reference/en-US/extras/exam-Component_Reference-a4jactionParam-a4jactionParam_example.xml_sample 2009-12-21
07:03:04 UTC (rev 16175)
@@ -0,0 +1,6 @@
+<h:form id="form">
+ <a4j:commandButton value="Set name to Alex"
reRender="rep">
+ <a4j:actionparam name="username" value="Alex"
assignTo="#{actionparamBean.name}"/>
+ </a4j:commandButton>
+ <h:outputText id="rep" value="Name:
#{actionparamBean.name}"/>
+</h:form>
Deleted:
root/docs/trunk/Component_Reference/en-US/extras/exam-Component_Reference-a4jactionParam-a4jactionParam_example.xmlt
===================================================================
---
root/docs/trunk/Component_Reference/en-US/extras/exam-Component_Reference-a4jactionParam-a4jactionParam_example.xmlt 2009-12-21
06:48:31 UTC (rev 16174)
+++
root/docs/trunk/Component_Reference/en-US/extras/exam-Component_Reference-a4jactionParam-a4jactionParam_example.xmlt 2009-12-21
07:03:04 UTC (rev 16175)
@@ -1,6 +0,0 @@
-<h:form id="form">
- <a4j:commandButton value="Set name to Alex"
reRender="rep">
- <a4j:actionparam name="username" value="Alex"
assignTo="#{actionparamBean.name}"/>
- </a4j:commandButton>
- <h:outputText id="rep" value="Name:
#{actionparamBean.name}"/>
-</h:form>
Copied:
root/docs/trunk/Component_Reference/en-US/extras/exam-Component_Reference-a4jjsFunction-a4jjsFunction_example.xml_sample
(from rev 16173,
root/docs/trunk/Component_Reference/en-US/extras/exam-Component_Reference-a4jjsFunction-a4jjsFunction_example.xmlt)
===================================================================
---
root/docs/trunk/Component_Reference/en-US/extras/exam-Component_Reference-a4jjsFunction-a4jjsFunction_example.xml_sample
(rev 0)
+++
root/docs/trunk/Component_Reference/en-US/extras/exam-Component_Reference-a4jjsFunction-a4jjsFunction_example.xml_sample 2009-12-21
07:03:04 UTC (rev 16175)
@@ -0,0 +1,7 @@
+<h:form>
+ ...
+ <a4j:jsFunction name="callScript" data="#{bean.someProperty1}"
reRender="someComponent" oncomplete="myScript(data.subProperty1,
data.subProperty2)">
+ <a4j:actionParam name="param_name"
assignTo="#{bean.someProperty2}"/>
+ </a4j:jsFunction>
+ ...
+</h:form>
Deleted:
root/docs/trunk/Component_Reference/en-US/extras/exam-Component_Reference-a4jjsFunction-a4jjsFunction_example.xmlt
===================================================================
---
root/docs/trunk/Component_Reference/en-US/extras/exam-Component_Reference-a4jjsFunction-a4jjsFunction_example.xmlt 2009-12-21
06:48:31 UTC (rev 16174)
+++
root/docs/trunk/Component_Reference/en-US/extras/exam-Component_Reference-a4jjsFunction-a4jjsFunction_example.xmlt 2009-12-21
07:03:04 UTC (rev 16175)
@@ -1,7 +0,0 @@
-<h:form>
- ...
- <a4j:jsFunction name="callScript" data="#{bean.someProperty1}"
reRender="someComponent" oncomplete="myScript(data.subProperty1,
data.subProperty2)">
- <a4j:actionParam name="param_name"
assignTo="#{bean.someProperty2}"/>
- </a4j:jsFunction>
- ...
-</h:form>
Copied:
root/docs/trunk/Component_Reference/en-US/extras/exam-Component_Reference-a4jloadBundle-a4jloadBundle_example-0.xml_sample
(from rev 16173,
root/docs/trunk/Component_Reference/en-US/extras/exam-Component_Reference-Resources-a4jloadBundle-0.xml_sample)
===================================================================
---
root/docs/trunk/Component_Reference/en-US/extras/exam-Component_Reference-a4jloadBundle-a4jloadBundle_example-0.xml_sample
(rev 0)
+++
root/docs/trunk/Component_Reference/en-US/extras/exam-Component_Reference-a4jloadBundle-a4jloadBundle_example-0.xml_sample 2009-12-21
07:03:04 UTC (rev 16175)
@@ -0,0 +1,9 @@
+<application>
+ <locale-config>
+ <default-locale>en</default-locale>
+ <supported-locale>en</supported-locale>
+ <supported-locale>de</supported-locale>
+ <supported-locale>it</supported-locale>
+ </locale-config>
+ <message-bundle>demo.message</message-bundle>
+</application>
Copied:
root/docs/trunk/Component_Reference/en-US/extras/exam-Component_Reference-a4jloadBundle-a4jloadBundle_example-1.js
(from rev 16174,
root/docs/trunk/Component_Reference/en-US/extras/exam-Component_Reference-Resources-a4jloadBundle-1.js)
===================================================================
---
root/docs/trunk/Component_Reference/en-US/extras/exam-Component_Reference-a4jloadBundle-a4jloadBundle_example-1.js
(rev 0)
+++
root/docs/trunk/Component_Reference/en-US/extras/exam-Component_Reference-a4jloadBundle-a4jloadBundle_example-1.js 2009-12-21
07:03:04 UTC (rev 16175)
@@ -0,0 +1,44 @@
+package demo;
+
+
+ import java.util.Locale;
+
+ import javax.faces.context.FacesContext;
+
+
+ public class ChangeLocale {
+
+ public String germanAction() {
+
+ FacesContext context = FacesContext.getCurrentInstance();
+
+ context.getViewRoot().setLocale(Locale.GERMAN);
+
+ return null;
+
+ }
+
+
+ public String englishAction() {
+
+ FacesContext context = FacesContext.getCurrentInstance();
+
+ context.getViewRoot().setLocale(Locale.ENGLISH);
+
+ return null;
+
+ }
+
+
+
+ public String italianAction() {
+
+ FacesContext context = FacesContext.getCurrentInstance();
+
+ context.getViewRoot().setLocale(Locale.ITALIAN);
+
+ return null;
+
+ }
+
+}
Copied:
root/docs/trunk/Component_Reference/en-US/extras/exam-Component_Reference-a4jloadBundle-a4jloadBundle_example-2.xml_sample
(from rev 16174,
root/docs/trunk/Component_Reference/en-US/extras/exam-Component_Reference-Resources-a4jloadBundle-2.xml_sample)
===================================================================
---
root/docs/trunk/Component_Reference/en-US/extras/exam-Component_Reference-a4jloadBundle-a4jloadBundle_example-2.xml_sample
(rev 0)
+++
root/docs/trunk/Component_Reference/en-US/extras/exam-Component_Reference-a4jloadBundle-a4jloadBundle_example-2.xml_sample 2009-12-21
07:03:04 UTC (rev 16175)
@@ -0,0 +1,8 @@
+<h:form>
+ <a4j:loadBundle var="msg" basename="demo.message"/>
+ <h:outputText id="messageBundle" value="#{msg.greeting}"/>
+ <a4j:commandLink value="De" action="#{changeLocale.germanAction}"
reRender="messageBundle" />
+ <a4j:commandLink value="Eng"
action="#{changeLocale.englishAction}" reRender="messageBundle" />
+ <a4j:commandLink value="It"
action="#{changeLocale.italianAction}" reRender="messageBundle" />
+</h:form>
+
Copied:
root/docs/trunk/Component_Reference/en-US/extras/exam-Component_Reference-a4jmediaOutput-a4jmediaOutput_example-0.js
(from rev 16174,
root/docs/trunk/Component_Reference/en-US/extras/exam-Component_Reference-Resources-a4jmediaOutput_example-0.js)
===================================================================
---
root/docs/trunk/Component_Reference/en-US/extras/exam-Component_Reference-a4jmediaOutput-a4jmediaOutput_example-0.js
(rev 0)
+++
root/docs/trunk/Component_Reference/en-US/extras/exam-Component_Reference-a4jmediaOutput-a4jmediaOutput_example-0.js 2009-12-21
07:03:04 UTC (rev 16175)
@@ -0,0 +1,31 @@
+package demo;
+
+import java.awt.Graphics2D;
+import java.awt.image.BufferedImage;
+import java.io.IOException;
+import java.io.OutputStream;
+import java.util.Random;
+import javax.imageio.ImageIO;
+
+public class MediaBean {
+
+ public void paint(OutputStream out, Object data) throws IOException {
+
+ Integer high = 9999;
+ Integer low = 1000;
+ Random generator = new Random();
+ Integer digits = generator.nextInt(high - low + 1) + low;
+
+ if (data instanceof MediaData) {
+ MediaData paintData = (MediaData) data;
+ BufferedImage img = new
BufferedImage(paintData.getWidth(),paintData.getHeight(),BufferedImage.TYPE_INT_RGB);
+ Graphics2D graphics2D = img.createGraphics();
+ graphics2D.setBackground(paintData.getBackground());
+ graphics2D.setColor(paintData.getDrawColor());
+ graphics2D.clearRect(0,0,paintData.getWidth(),paintData.getHeight());
+ graphics2D.setFont(paintData.getFont());
+ graphics2D.drawString(digits.toString(), 20, 35);
+ ImageIO.write(img,"png",out);
+ }
+ }
+}
Copied:
root/docs/trunk/Component_Reference/en-US/extras/exam-Component_Reference-a4jmediaOutput-a4jmediaOutput_example-1.js
(from rev 16174,
root/docs/trunk/Component_Reference/en-US/extras/exam-Component_Reference-Resources-a4jmediaOutput_example-1.js)
===================================================================
---
root/docs/trunk/Component_Reference/en-US/extras/exam-Component_Reference-a4jmediaOutput-a4jmediaOutput_example-1.js
(rev 0)
+++
root/docs/trunk/Component_Reference/en-US/extras/exam-Component_Reference-a4jmediaOutput-a4jmediaOutput_example-1.js 2009-12-21
07:03:04 UTC (rev 16175)
@@ -0,0 +1,22 @@
+package demo;
+
+import java.awt.Color;
+import java.awt.Font;
+import java.io.Serializable;
+
+public class MediaData implements Serializable {
+
+ private static final long serialVersionUID = 1L;
+
+ Integer Width=110;
+ Integer Height=50;
+
+ Color Background=new Color(190, 214, 248);
+ Color DrawColor=new Color(0,0,0);
+
+ Font font = new Font("Serif", Font.TRUETYPE_FONT, 30);
+
+ /* Corresponding getters and setters */
+ ...
+
+}
Modified: root/docs/trunk/Component_Reference/en-US/fallback_content/Conventions.xml
===================================================================
--- root/docs/trunk/Component_Reference/en-US/fallback_content/Conventions.xml 2009-12-21
06:48:31 UTC (rev 16174)
+++ root/docs/trunk/Component_Reference/en-US/fallback_content/Conventions.xml 2009-12-21
07:03:04 UTC (rev 16175)
@@ -1,9 +1,6 @@
<?xml version='1.0' encoding='utf-8' ?>
<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
-<!ENTITY % BOOK_ENTITIES SYSTEM "../Component_Reference.ent">
-%BOOK_ENTITIES;
]>
-
<section id="sect-Component_Reference-Document_Conventions">
<title>Document Conventions</title>
<para>
@@ -71,7 +68,7 @@
The above text includes application names; system-wide menu names and items;
application-specific menu names; and buttons and text found within a GUI interface, all
presented in Proportional Bold and all distinguishable by context.
</para>
<para>
- Note the <guimenu>></guimenu> shorthand used to indicate traversal
through a menu and its sub-menus. This is to avoid the difficult-to-follow 'Select
<guimenuitem>Mouse</guimenuitem> from the
<guimenu>Preferences</guimenu> sub-menu in the
<guimenu>System</guimenu> menu of the main menu bar' approach.
+ Note the <guimenu>></guimenu> shorthand used to indicate traversal
through a menu and its sub-menus. This is to avoid the difficult-to-follow 'Select
<guimenuitem>Mouse</guimenuitem> from the
<guimenu>Preferences</guimenu> sub-menu in the
<guimenu>System</guimenu> menu of the main menu bar' approach.
</para>
<para>
<command><replaceable>Mono-spaced Bold
Italic</replaceable></command> or
<application><replaceable>Proportional Bold
Italic</replaceable></application>
@@ -137,7 +134,7 @@
System.out.println("Created Echo");
- System.out.println("Echo.echo('Hello') = " +
echo.echo("Hello"));
+ System.out.println("Echo.echo('Hello') = " +
echo.echo("Hello"));
}
}
@@ -158,7 +155,7 @@
<important>
<title>Important</title>
<para>
- Important boxes detail things that are easily missed: configuration changes that only
apply to the current session, or services that need restarting before an update will
apply. Ignoring Important boxes won't cause data loss but may cause irritation and
frustration.
+ Important boxes detail things that are easily missed: configuration changes that only
apply to the current session, or services that need restarting before an update will
apply. Ignoring Important boxes won't cause data loss but may cause irritation and
frustration.
</para>
</important>
<warning>
Modified: root/docs/trunk/Component_Reference/en-US/fallback_content/Feedback.xml
===================================================================
--- root/docs/trunk/Component_Reference/en-US/fallback_content/Feedback.xml 2009-12-21
06:48:31 UTC (rev 16174)
+++ root/docs/trunk/Component_Reference/en-US/fallback_content/Feedback.xml 2009-12-21
07:03:04 UTC (rev 16175)
@@ -1,9 +1,6 @@
<?xml version='1.0' encoding='utf-8' ?>
<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
-<!ENTITY % BOOK_ENTITIES SYSTEM "../Component_Reference.ent">
-%BOOK_ENTITIES;
]>
-
<section id="sect-Component_Reference-We_Need_Feedback">
<title>We Need Feedback!</title>
<indexterm>
@@ -14,7 +11,7 @@
If you find a typographical error in this manual, or if you have thought of a way to
make this manual better, we would love to hear from you! Please submit a report in
Bugzilla: <ulink
url="http://bugzilla.redhat.com/bugzilla/">http://bugzilla.r...
against the product <application>&PRODUCT;.</application>
</para>
<para>
- When submitting a bug report, be sure to mention the manual's identifier:
<citetitle>&BOOKID;</citetitle>
+ When submitting a bug report, be sure to mention the manual's identifier:
<citetitle>&BOOKID;</citetitle>
</para>
<para>
If you have a suggestion for improving the documentation, try to be as specific as
possible when describing it. If you have found an error, please include the section number
and some of the surrounding text so we can find it easily.
Modified: root/docs/trunk/Component_Reference/en-US/fallback_content/Legal_Notice.xml
===================================================================
--- root/docs/trunk/Component_Reference/en-US/fallback_content/Legal_Notice.xml 2009-12-21
06:48:31 UTC (rev 16174)
+++ root/docs/trunk/Component_Reference/en-US/fallback_content/Legal_Notice.xml 2009-12-21
07:03:04 UTC (rev 16175)
@@ -1,9 +1,6 @@
<?xml version='1.0' encoding='utf-8' ?>
<!DOCTYPE legalnotice PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
-<!ENTITY % BOOK_ENTITIES SYSTEM "../Component_Reference.ent">
-%BOOK_ENTITIES;
]>
-
<legalnotice>
<para>
Copyright <trademark class="copyright"></trademark> &YEAR;
&HOLDER;. This material may only be distributed subject to the terms and conditions
set forth in the Open Publication License, V1.0, (the latest version is presently
available at <ulink
url="http://www.opencontent.org/openpub/">http://www.opencon...>).
Deleted:
root/docs/trunk/Component_Reference/en-US/images/figu-Component_Reference-Resources-a4jmediaOutput_example_result.png
===================================================================
(Binary files differ)
Copied:
root/docs/trunk/Component_Reference/en-US/images/figu-Component_Reference-a4jmediaOutput-a4jmediaOutput_example_result.png
(from rev 16174,
root/docs/trunk/Component_Reference/en-US/images/figu-Component_Reference-Resources-a4jmediaOutput_example_result.png)
===================================================================
(Binary files differ)