Author: smukhina
Date: 2007-08-10 05:30:23 -0400 (Fri, 10 Aug 2007)
New Revision: 2191
Added:
trunk/samples/richfaces-demo/src/main/webapp/richfaces/ajaxListener/usage.html
trunk/samples/richfaces-demo/src/main/webapp/richfaces/bundle/usage.html
Modified:
trunk/samples/richfaces-demo/src/main/webapp/richfaces/actionparam/source/usage.html
trunk/samples/richfaces-demo/src/main/webapp/richfaces/dataTable/source/usage.html
trunk/samples/richfaces-demo/src/main/webapp/richfaces/form/source/usage.html
trunk/samples/richfaces-demo/src/main/webapp/richfaces/poll/source/usage.html
trunk/samples/richfaces-demo/src/main/webapp/richfaces/region/source/usage.html
trunk/samples/richfaces-demo/src/main/webapp/richfaces/script/source/usage.html
trunk/samples/richfaces-demo/src/main/webapp/richfaces/style/source/usage.html
trunk/samples/richfaces-demo/src/main/webapp/richfaces/support/source/usage.html
trunk/samples/richfaces-demo/src/main/webapp/richfaces/support/usage.xhtml
Log:
http://jira.jboss.com/jira/browse/RF-525
highlighted htmls
Modified:
trunk/samples/richfaces-demo/src/main/webapp/richfaces/actionparam/source/usage.html
===================================================================
---
trunk/samples/richfaces-demo/src/main/webapp/richfaces/actionparam/source/usage.html 2007-08-10
09:29:40 UTC (rev 2190)
+++
trunk/samples/richfaces-demo/src/main/webapp/richfaces/actionparam/source/usage.html 2007-08-10
09:30:23 UTC (rev 2191)
@@ -8,8 +8,8 @@
by Lorenzo Bettini
http://www.lorenzobettini.it
http://www.gnu.org/software/src-highlite">
-<title>E:\projects\eclipse-worspaces\workspace\RFtrunk\samples\richfaces-demo\src\main\webapp\richfaces\actionparam\source\usage.xhtml</title>
-<link rel="stylesheet" href="css\xhtml-source.css"
type="text/css">
+<title>usage.xhtml</title>
+<link rel="stylesheet" href="../../../css\xhtml-source.css"
type="text/css">
</head>
<body>
<pre><tt><span
class="keyword"><div</span><span class="normal">
</span><span class="type">class</span><span
class="symbol">=</span><span
class="string">"</span><span
class="string">sample-container</span><span
class="string">"</span><span class="normal">
</span><span class="keyword">></span>
Added: trunk/samples/richfaces-demo/src/main/webapp/richfaces/ajaxListener/usage.html
===================================================================
--- trunk/samples/richfaces-demo/src/main/webapp/richfaces/ajaxListener/usage.html
(rev 0)
+++
trunk/samples/richfaces-demo/src/main/webapp/richfaces/ajaxListener/usage.html 2007-08-10
09:30:23 UTC (rev 2191)
@@ -0,0 +1,52 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN"
+ "http://www.w3.org/TR/REC-html40/strict.dtd">
+<html>
+<head>
+<meta http-equiv="Content-Type"
+content="text/html; charset=iso-8859-1">
+<meta name="GENERATOR" content="GNU source-highlight 2.1.2
+by Lorenzo Bettini
+http://www.lorenzobettini.it
+http://www.gnu.org/software/src-highlite">
+<title>usage.xhtml</title>
+<link rel="stylesheet" href="../../../css\xhtml-source.css"
type="text/css">
+</head>
+<body>
+<pre><tt><span class="normal"><!DOCTYPE html PUBLIC
"-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"></span>
+<span class="keyword"><html</span><span
class="normal"> </span><span
class="type">xmlns</span><span
class="symbol">=</span><span
class="string">"</span><span
class="string">http://www.w3.org/1999/xhtml</span><...
class="string">"</span>
+<span class="normal"> </span><span
class="type">xmlns:ui</span><span
class="symbol">=</span><span
class="string">"</span><span
class="string">http://java.sun.com/jsf/facelets</span>...
class="string">"</span>
+<span class="normal"> </span><span
class="type">xmlns:h</span><span
class="symbol">=</span><span
class="string">"</span><span
class="string">http://java.sun.com/jsf/html</span><...
class="string">"</span>
+<span class="normal"> </span><span
class="type">xmlns:f</span><span
class="symbol">=</span><span
class="string">"</span><span
class="string">http://java.sun.com/jsf/core</span><...
class="string">"</span>
+<span class="normal"> </span><span
class="type">xmlns:a4j</span><span
class="symbol">=</span><span
class="string">"</span><span
class="string">http://richfaces.org/a4j</span><span
class="string">"</span>
+<span class="normal"> </span><span
class="type">xmlns:rich</span><span
class="symbol">=</span><span
class="string">"</span><span
class="string">http://richfaces.ajax4jsf.org/rich</span&g...
class="string">"</span><span
class="keyword">></span>
+<span class="normal"> </span><span
class="keyword"><ui:composition</span><span
class="normal"> </span><span
class="type">template</span><span
class="symbol">=</span><span
class="string">"</span><span
class="string">/templates/component-sample.xhtml</span><span
class="string">"</span><span
class="keyword">></span>
+<span class="normal"> </span><span
class="keyword"><ui:define</span><span
class="normal"> </span><span
class="type">name</span><span
class="symbol">=</span><span
class="string">"</span><span
class="string">sample</span><span
class="string">"</span><span
class="keyword">></span>
+<span class="normal"> </span><span
class="keyword"><p></span>
+<span class="normal"> Additionally to the listeners provided by JSF
specification, RichFaces add one more:</span>
+<span class="normal"> Ajax Listener (a4j:ajaxListener). Ajax Listener
is invoked before the Render Response</span>
+<span class="normal"> phase. Instead of Action Listener of Value
Change Listener which are not invoked when</span>
+<span class="normal"> Validation of Update Model phases failed, Ajax
Listener is guarantied to be invoked</span>
+<span class="normal"> for each Ajax response. Hence, it is a good
place to update the list of re-rendered</span>
+<span class="normal"> components, for example.</span>
+<span class="normal"> </span><span
class="keyword"></p></span>
+<span class="normal"> </span><span
class="keyword"><p></span>
+<span class="normal"> Ajax Listener is not invoked for a non-Ajax
request and when RichFaces works in</span>
+<span class="normal"> "Ajax Request generates Non-Ajax
Response" mode. Therefore, Ajax Listener invocation</span>
+<span class="normal"> is a good indicator that Ajax response is going
to be processed.</span>
+<span class="normal"> </span><span
class="keyword"></p></span>
+<span class="normal"> </span>
+<span class="normal"> </span><span
class="keyword"><p></span>
+<span class="normal"> </span><span
class="keyword"><b></span><span
class="normal">type</span><span
class="keyword"></b></span><span
class="normal"> attribute defines the fully qualified Java class name for
listener. This</span>
+<span class="normal"> class should implement
org.ajax4jsf.events.AjaxListener interface. You can access to</span>
+<span class="normal"> the source of the event (Ajax component) using
event.getSource() call.</span>
+<span class="normal"> </span><span
class="keyword"></p></span>
+<span class="normal"> </span>
+
+<span class="normal"> </span>
+<span class="normal"> </span><span
class="keyword"></ui:define></span>
+
+<span class="normal"> </span><span
class="keyword"></ui:composition></span>
+<span class="keyword"></html></span>
+</tt></pre>
+</body>
+</html>
Added: trunk/samples/richfaces-demo/src/main/webapp/richfaces/bundle/usage.html
===================================================================
--- trunk/samples/richfaces-demo/src/main/webapp/richfaces/bundle/usage.html
(rev 0)
+++ trunk/samples/richfaces-demo/src/main/webapp/richfaces/bundle/usage.html 2007-08-10
09:30:23 UTC (rev 2191)
@@ -0,0 +1,47 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN"
+ "http://www.w3.org/TR/REC-html40/strict.dtd">
+<html>
+<head>
+<meta http-equiv="Content-Type"
+content="text/html; charset=iso-8859-1">
+<meta name="GENERATOR" content="GNU source-highlight 2.1.2
+by Lorenzo Bettini
+http://www.lorenzobettini.it
+http://www.gnu.org/software/src-highlite">
+<title>usage.xhtml</title>
+<link rel="stylesheet" href="../../../css\xhtml-source.css"
type="text/css">
+</head>
+<body>
+<pre><tt><span class="normal"><!DOCTYPE html PUBLIC
"-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"></span>
+<span class="keyword"><html</span><span
class="normal"> </span><span
class="type">xmlns</span><span
class="symbol">=</span><span
class="string">"</span><span
class="string">http://www.w3.org/1999/xhtml</span><...
class="string">"</span>
+<span class="normal"> </span><span
class="type">xmlns:ui</span><span
class="symbol">=</span><span
class="string">"</span><span
class="string">http://java.sun.com/jsf/facelets</span>...
class="string">"</span>
+<span class="normal"> </span><span
class="type">xmlns:h</span><span
class="symbol">=</span><span
class="string">"</span><span
class="string">http://java.sun.com/jsf/html</span><...
class="string">"</span>
+<span class="normal"> </span><span
class="type">xmlns:f</span><span
class="symbol">=</span><span
class="string">"</span><span
class="string">http://java.sun.com/jsf/core</span><...
class="string">"</span>
+<span class="normal"> </span><span
class="type">xmlns:a4j</span><span
class="symbol">=</span><span
class="string">"</span><span
class="string">http://richfaces.org/a4j</span><span
class="string">"</span>
+<span class="normal"> </span><span
class="type">xmlns:rich</span><span
class="symbol">=</span><span
class="string">"</span><span
class="string">http://richfaces.ajax4jsf.org/rich</span&g...
class="string">"</span><span
class="keyword">></span>
+<span class="normal"> </span><span
class="keyword"><ui:composition</span><span
class="normal"> </span><span
class="type">template</span><span
class="symbol">=</span><span
class="string">"</span><span
class="string">/templates/component-sample.xhtml</span><span
class="string">"</span><span
class="keyword">></span>
+<span class="normal"> </span><span
class="keyword"><ui:define</span><span
class="normal"> </span><span
class="type">name</span><span
class="symbol">=</span><span
class="string">"</span><span
class="string">sample</span><span
class="string">"</span><span
class="keyword">></span>
+<span class="normal"> </span>
+<span class="normal"> </span><span
class="keyword"><p></span><span
class="normal">a4j:loadBundle allows to use reference to bundle messages
during the Ajax re-rendering.</span>
+<span class="normal"> a4j:loadBundle is a substitute for the
f:loadBundle in JSF 1.1 which is not a JSF component originally.</span>
+<span class="normal"> f:loadBundle is a jsp tag that load the bundle
messages into the request scope when page is</span>
+<span class="normal"> rendered. As soon as each Ajax request works in
own request scope, the bundles loaded with</span>
+<span class="normal"> f:loadBundle are unavailable.</span>
+<span class="normal"> </span><span
class="keyword"></p></span>
+<span class="normal"> </span><span
class="keyword"><p></span><span
class="normal">Instead of f:loadBundle that might be located anywhere on the
page, the a4j:loadBundle </span>
+<span class="normal"> should be declared inside the f:view (this does
not matter in case on using Facelets)</span>
+<span class="normal"> </span><span
class="keyword"></p></span>
+
+<span class="normal"> </span><span
class="keyword"><p></span><span
class="normal">JSF 1.2 introduces the bundle registered in the
faces-config.xml. This fixed the problem</span>
+<span class="normal"> with f:loadBundle. Therefore, you can use this
JSF 1.2 way to declare your bundles.</span>
+<span class="normal"> </span><span
class="keyword"></p></span>
+<span class="normal"> </span>
+<span class="normal"> </span><span
class="keyword"></ui:define></span>
+<span class="normal"> </span><span
class="keyword"><ui:define</span><span
class="normal"> </span><span
class="type">name</span><span
class="symbol">=</span><span
class="string">"</span><span
class="string">sources</span><span
class="string">"</span><span
class="keyword">></span>
+<span class="normal"> </span><span
class="keyword"><h:panelGroup</span><span
class="normal"> </span><span
class="keyword">/></span>
+<span class="normal"> </span><span
class="keyword"></ui:define></span>
+<span class="normal"> </span><span
class="keyword"></ui:composition></span>
+<span class="keyword"></html></span>
+</tt></pre>
+</body>
+</html>
Modified:
trunk/samples/richfaces-demo/src/main/webapp/richfaces/dataTable/source/usage.html
===================================================================
---
trunk/samples/richfaces-demo/src/main/webapp/richfaces/dataTable/source/usage.html 2007-08-10
09:29:40 UTC (rev 2190)
+++
trunk/samples/richfaces-demo/src/main/webapp/richfaces/dataTable/source/usage.html 2007-08-10
09:30:23 UTC (rev 2191)
@@ -9,7 +9,7 @@
http://www.lorenzobettini.it
http://www.gnu.org/software/src-highlite">
<title>usage.xhtml</title>
-<link rel="stylesheet" href="../../../css/xhtml-source.css"
type="text/css">
+<link rel="stylesheet" href="../../../css\xhtml-source.css"
type="text/css">
</head>
<body>
<pre><tt><span
class="keyword"><rich:dataTable</span><span
class="normal"> </span>
Modified: trunk/samples/richfaces-demo/src/main/webapp/richfaces/form/source/usage.html
===================================================================
---
trunk/samples/richfaces-demo/src/main/webapp/richfaces/form/source/usage.html 2007-08-10
09:29:40 UTC (rev 2190)
+++
trunk/samples/richfaces-demo/src/main/webapp/richfaces/form/source/usage.html 2007-08-10
09:30:23 UTC (rev 2191)
@@ -9,7 +9,7 @@
http://www.lorenzobettini.it
http://www.gnu.org/software/src-highlite">
<title>usage.xhtml</title>
-<link rel="stylesheet" href="..\..\..\css\xhtml-source.css"
type="text/css">
+<link rel="stylesheet" href="../../../css/xhtml-source.css"
type="text/css">
</head>
<body>
<pre><tt><span
class="keyword"><a4j:form</span><span
class="normal"> </span><span
class="type">ajaxSubmit</span><span
class="symbol">=</span><span
class="string">"</span><span
class="string">true</span><span
class="string">"</span><span class="normal">
</span><span class="type">reRender</span><span
class="symbol">=</span><span
class="string">"</span><span
class="string">name</span><span
class="string">"</span><span
class="keyword">></span>
Modified: trunk/samples/richfaces-demo/src/main/webapp/richfaces/poll/source/usage.html
===================================================================
---
trunk/samples/richfaces-demo/src/main/webapp/richfaces/poll/source/usage.html 2007-08-10
09:29:40 UTC (rev 2190)
+++
trunk/samples/richfaces-demo/src/main/webapp/richfaces/poll/source/usage.html 2007-08-10
09:30:23 UTC (rev 2191)
@@ -9,7 +9,7 @@
http://www.lorenzobettini.it
http://www.gnu.org/software/src-highlite">
<title>usage.xhtml</title>
-<link rel="stylesheet" href="..\..\..\css\xhtml-source.css"
type="text/css">
+<link rel="stylesheet" href="../../../css\xhtml-source.css"
type="text/css">
</head>
<body>
<pre><tt><span
class="keyword"><a4j:region></span>
Modified: trunk/samples/richfaces-demo/src/main/webapp/richfaces/region/source/usage.html
===================================================================
---
trunk/samples/richfaces-demo/src/main/webapp/richfaces/region/source/usage.html 2007-08-10
09:29:40 UTC (rev 2190)
+++
trunk/samples/richfaces-demo/src/main/webapp/richfaces/region/source/usage.html 2007-08-10
09:30:23 UTC (rev 2191)
@@ -9,7 +9,7 @@
http://www.lorenzobettini.it
http://www.gnu.org/software/src-highlite">
<title>usage.xhtml</title>
-<link rel="stylesheet" href="..\..\..\css\xhtml-source.css"
type="text/css">
+<link rel="stylesheet" href="../../../css\xhtml-source.css"
type="text/css">
</head>
<body>
<pre><tt><span
class="keyword"><div</span><span class="normal">
</span><span class="type">class</span><span
class="symbol">=</span><span
class="string">"</span><span
class="string">sample-container</span><span
class="string">"</span><span class="normal">
</span><span class="keyword">></span>
Modified: trunk/samples/richfaces-demo/src/main/webapp/richfaces/script/source/usage.html
===================================================================
---
trunk/samples/richfaces-demo/src/main/webapp/richfaces/script/source/usage.html 2007-08-10
09:29:40 UTC (rev 2190)
+++
trunk/samples/richfaces-demo/src/main/webapp/richfaces/script/source/usage.html 2007-08-10
09:30:23 UTC (rev 2191)
@@ -9,7 +9,7 @@
http://www.lorenzobettini.it
http://www.gnu.org/software/src-highlite">
<title>usage.xhtml</title>
-<link rel="stylesheet" href="..\..\..\css\xhtml-source.css"
type="text/css">
+<link rel="stylesheet" href="../../../css\xhtml-source.css"
type="text/css">
</head>
<body>
<pre><tt><span
class="keyword"><a4j:loadScript</span><span
class="normal"> </span><span
class="type">src</span><span
class="symbol">=</span><span
class="string">"</span><span
class="string">resource://org/richfaces/renderkit/html/scripts/scriptaculous-js-1.6.5/src/scriptaculous.js</span><span
class="string">"</span><span
class="keyword">/></span>
Modified: trunk/samples/richfaces-demo/src/main/webapp/richfaces/style/source/usage.html
===================================================================
---
trunk/samples/richfaces-demo/src/main/webapp/richfaces/style/source/usage.html 2007-08-10
09:29:40 UTC (rev 2190)
+++
trunk/samples/richfaces-demo/src/main/webapp/richfaces/style/source/usage.html 2007-08-10
09:30:23 UTC (rev 2191)
@@ -1 +1,17 @@
-TODO: source should be added
\ No newline at end of file
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN"
+ "http://www.w3.org/TR/REC-html40/strict.dtd">
+<html>
+<head>
+<meta http-equiv="Content-Type"
+content="text/html; charset=iso-8859-1">
+<meta name="GENERATOR" content="GNU source-highlight 2.1.2
+by Lorenzo Bettini
+http://www.lorenzobettini.it
+http://www.gnu.org/software/src-highlite">
+<title>usage.xhtml</title>
+<link rel="stylesheet" href="../../../css\xhtml-source.css"
type="text/css">
+</head>
+<body>
+<pre><tt><span
class="normal">x</span></tt></pre>
+</body>
+</html>
Modified:
trunk/samples/richfaces-demo/src/main/webapp/richfaces/support/source/usage.html
===================================================================
---
trunk/samples/richfaces-demo/src/main/webapp/richfaces/support/source/usage.html 2007-08-10
09:29:40 UTC (rev 2190)
+++
trunk/samples/richfaces-demo/src/main/webapp/richfaces/support/source/usage.html 2007-08-10
09:30:23 UTC (rev 2191)
@@ -9,7 +9,7 @@
http://www.lorenzobettini.it
http://www.gnu.org/software/src-highlite">
<title>usage.xhtml</title>
-<link rel="stylesheet" href="..\..\..\css\xhtml-source.css"
type="text/css">
+<link rel="stylesheet" href="../../../css\xhtml-source.css"
type="text/css">
</head>
<body>
<pre><tt><span
class="keyword"><h:form></span>
Modified: trunk/samples/richfaces-demo/src/main/webapp/richfaces/support/usage.xhtml
===================================================================
--- trunk/samples/richfaces-demo/src/main/webapp/richfaces/support/usage.xhtml 2007-08-10
09:29:40 UTC (rev 2190)
+++ trunk/samples/richfaces-demo/src/main/webapp/richfaces/support/usage.xhtml 2007-08-10
09:30:23 UTC (rev 2191)
@@ -10,10 +10,10 @@
<p>
a4j:support is a most important core component in the RichFaces library. It allows
- to add an Ajax capability to the existing non-ajax components. All other Ajax
component
+ to add an Ajax capability to the existing non-ajax components. All other Ajax
components
are based on the same principles a4j:support has.
</p>
- <p> a4j:support should be attached a direct child of the JSF component that has
to be ajaxified.
+ <p> a4j:support should be attached to a direct child of the JSF component that
has to be ajaxified.
The key attributes are 'event' and 'reRender'.
</p>
<p>
@@ -21,10 +21,10 @@
</p>
<p>
'reRender' attribute points to the JSF component(s) that should be
re-rendered on the server side
- and updated on the client when ajax response come back.
+ and updated on the client when ajax response comes back.
</p>
<p>
- The following example shows how the outputText component value is changed while user
is
+ The following example shows how the outputText component value is changed while a
user is
typing in the input field:
</p>
@@ -48,8 +48,8 @@
<p>
a4j:support is wired with the event of the parent component during the Render
Response
- phase on the server side. So, the number of possible events is limited to the ones
- defined with particular component attributs. The wiring with events dynamically
attached
+ phase on the server side. Hence, the number of possible events is limited to the
ones
+ defined with particular component attributes. The wiring with events dynamically
attached
on the client side is not supported.
</p>