From richfaces-svn-commits at lists.jboss.org Wed Sep 9 15:16:40 2009 Content-Type: multipart/mixed; boundary="===============5792035099910648803==" MIME-Version: 1.0 From: richfaces-svn-commits at lists.jboss.org To: richfaces-svn-commits at lists.jboss.org Subject: [richfaces-svn-commits] JBoss Rich Faces SVN: r15518 - in branches/community/3.3.X/docs/userguide/en/src/main: resources/images and 1 other directory. Date: Wed, 09 Sep 2009 15:16:39 -0400 Message-ID: <200909091916.n89JGdlp032255@svn01.web.mwc.hst.phx2.redhat.com> --===============5792035099910648803== Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Author: artdaw Date: 2009-09-09 15:16:39 -0400 (Wed, 09 Sep 2009) New Revision: 15518 Added: branches/community/3.3.X/docs/userguide/en/src/main/resources/images/aja= xListener.png Modified: branches/community/3.3.X/docs/userguide/en/src/main/docbook/included/a4j= _ajaxListener.xml Log: https://jira.jboss.org/jira/browse/RF-7275 - a4j:actionListener is fixed Modified: branches/community/3.3.X/docs/userguide/en/src/main/docbook/inclu= ded/a4j_ajaxListener.xml =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D --- branches/community/3.3.X/docs/userguide/en/src/main/docbook/included/a4= j_ajaxListener.xml 2009-09-09 18:10:47 UTC (rev 15517) +++ branches/community/3.3.X/docs/userguide/en/src/main/docbook/included/a4= j_ajaxListener.xml 2009-09-09 19:16:39 UTC (rev 15518) @@ -1,152 +1,185 @@
- - < - a4j:ajaxListener - > - <emphasis role=3D"since"> - <superscript> available since <emphasis role=3D"version">3.0.0</e= mphasis> - </superscript> - </emphasis> - -
- Description - The component adds an action listener to a parent compon= ent to provide possibility of Ajax update. = - It works like the - <f:actionListener> - or - <f:valueChangeListener> - JSF components = - but for the whole Ajax container. - -
-
- Key Features = - - - The listener is invoked for Ajax requests only - - - The listener is always guaranteed to be invoked - = - + + < + a4j:ajaxListener + > + <emphasis role=3D"since"> + <superscript>available since + <emphasis role=3D"version">3.0.0</emphasis> + </superscript> + </emphasis> + +
+ Description + The + + <a4j:ajaxListener> + + component adds an action listener to a parent component and wo= rks like the + + <f:actionListener> + + or + + <f:valueChangeListener> + + JSF components + but for the whole Ajax container. +
-
- Details of Usage - The - <a4j:ajaxListener> - component adds an action listener to a parent compone= nt, which needs to be provided with Ajax support. = - That listener is invoked on each Ajax request during the= "Render Response" JSF phase. = - In comparison with JSF - <f:actionListener> - and - <f:valueChangeListener> - = - the invocation of the - <a4j:ajaxListener> - is not skipped in case when validation of Update Mode= l fails. = - The - <a4j:ajaxListener> - is guarantied to be invoked for each Ajax response. - - = - - - Ajax listener is not invoked for non-Ajax requests and when R= ichFaces works in the "Ajax Request generates Non-Ajax Response" mode. = - - = +
+ Details of Usage + The + + <a4j:ajaxListener> + + component adds an action listener to a parent component. + That listener is invoked on each Ajax request during the "= ;Render Response" JSF phase. + In comparison with standard JSF + + <f:actionListener> + + and + + <f:valueChangeListener> + + components the invocation of the + + <a4j:ajaxListener> + + is not skipped in case when validation of "Update Model&q= uot; fails. + The + + <a4j:ajaxListener> + + is guarantied to be invoked for each Ajax response. + + + The + + "type" + + attribute defines the fully qualified Java class name for the = listener. + This Java class should implement + + + org.ajax4jsf.event.AjaxListener + + + interface which is base interface for all listeners, capable f= or receiving Ajax events. + The object on which the Event initially occurred could be acce= ssed using the + + + java.util.EventObject.getSource() + + + method. + + + The + + <a4j:ajaxListener> + + is not invoked for non-Ajax requests and when RichFaces works = in the "Ajax Request + generates Non-Ajax Response" mode, so + + <a4j:ajaxListener> + + invocation is a good indicator that Ajax + Response is going to be processed. Let's check it in the = following example. + = - - As example of the - <a4j:ajaxListener> - component usage one can cite an updating the list of = re-rendered components. - + + Example: + = - - The - "type" - attribute defines the fully qualified Java class name= for the listener. = - This Java class implements - - org.ajax4jsf.event.AjaxListener - - interface, which is base interface for all listeners, capa= ble for receiving Ajax events. = - The source of the event could be accessed using the - - java.util.EventObject.getSource() - - call. = - + + + + + + +...]]> = + + Example: + = - = - - Example: - + + + There is a result: + +
+ + Usage of the + <emphasis role=3D"bold"> + <property><a4j:ajaxListener></property> + </emphasis> + + + + + + +
= - - - -...]]> = = - - Example: - +
+
+ Reference Data + + Table of + <a4j:ajaxListener> + attributes. + + + Component Identification Parameters + + + + Name + Value + + + = - + listener-class + org.ajax4jsf.event.AjaxListener + + + event-class + org.ajax4jsf.event.AjaxEvent + = -import org.ajax4jsf.event.AjaxEvent; - -public class Bean implements org.ajax4jsf.event.AjaxListener{ - ... = - public void processAjax(AjaxEvent arg){ - //Custom Developer Code = - } - ... -}]]> = - -
- Reference Data - - Table of = - <a4j:ajaxListener> = - attributes. - -
- Component Identification Parameters - - - - Name - Value - - - - = - - listener-class - org.ajax4jsf.event.AjaxListener - - - event-class - org.ajax4jsf.event.AjaxEvent - - = - - tag-class - org.ajax4jsf.taglib.html.jsp.AjaxListenerTag - - - -
-
-
- Relevant Resources Links - - Visit AjaxListener page at R= ichFaces Livedemo for examples of component usage and their sources. = - + + tag-class + org.ajax4jsf.taglib.html.jsp.AjaxListenerTa= g + + + + +
+
+ Relevant Resources Links - Check Sun JSF TLD documentation for more information on <f:valueChangeListener> tag. = + Visit + + AjaxListener + + page at RichFaces Livedemo for examples of component usage and= their sources. -
+ + Check Sun JSF TLD documentation for more information on<f:valueChangeListener> + tag. + +
Added: branches/community/3.3.X/docs/userguide/en/src/main/resources/images= /ajaxListener.png =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D (Binary files differ) Property changes on: branches/community/3.3.X/docs/userguide/en/src/main/re= sources/images/ajaxListener.png ___________________________________________________________________ Name: svn:mime-type + application/octet-stream --===============5792035099910648803==--