Author: julien(a)jboss.com
Date: 2007-04-29 09:54:48 -0400 (Sun, 29 Apr 2007)
New Revision: 7132
Modified:
docs/trunk/referenceGuide/en/modules/portalapi.xml
Log:
more portal api doc
Modified: docs/trunk/referenceGuide/en/modules/portalapi.xml
===================================================================
--- docs/trunk/referenceGuide/en/modules/portalapi.xml 2007-04-29 13:48:37 UTC (rev 7131)
+++ docs/trunk/referenceGuide/en/modules/portalapi.xml 2007-04-29 13:54:48 UTC (rev 7132)
@@ -226,8 +226,15 @@
<sect2>
<title>Portal node events</title>
<para>Portal node events extends the abstract portal event framework in
order to provide notifications
- about user interface events happening at runtime. For instance when the portal
renders a page, a corresponding
- event will be fired.</para>
+ about user interface events happening at runtime. For instance when the portal
renders a page or a window,
+ a corresponding event will be fired.</para>
+ <sect3>Portal node event propagation model</sect3>
+ <para>
+ A portal node event is fired when an event of interest happens to a portal
node of the portal tree. The
+ notification model is comparable to the <ulink
url="http://en.wikipedia.org/wiki/DOM_Events#Event_flow">bub... propagation
model </ulink>
+ defined by the DOM specification. When an event is fired, the event is
propagated in the hierarchy from the most
+ inner node where the event happens to the root node of the tree.
+ </para>
</sect2>
<sect2>
<title>Portal user events</title>