Author: vkorluzhenko
Date: 2007-10-15 09:37:35 -0400 (Mon, 15 Oct 2007)
New Revision: 3372
Modified:
trunk/docs/userguide/en/src/main/docbook/included/calendar.xml
Log:
http://jira.jboss.com/jira/browse/RF-1086 - added infor about ondataselect and
ondataselected attributes
Modified: trunk/docs/userguide/en/src/main/docbook/included/calendar.xml
===================================================================
--- trunk/docs/userguide/en/src/main/docbook/included/calendar.xml 2007-10-15 12:53:14 UTC
(rev 3371)
+++ trunk/docs/userguide/en/src/main/docbook/included/calendar.xml 2007-10-15 13:37:35 UTC
(rev 3372)
@@ -130,13 +130,45 @@
<note>
<title>Note:</title><emphasis>
- <property>"preloadDateRangeBegin"</property>
- </emphasis> and
- <emphasis>
- <property>"preloadDateRangeEnd"</property>
+ <property>"preloadDateRangeBegin"</property>
+ </emphasis> and <emphasis>
+ <property>"preloadDateRangeEnd"</property>
</emphasis> attributes was designed only for the
<property>"client"</property> mode to load some data
initially.</note>
+ <para><emphasis>
+ <property>"ondataselect"</property>
+ </emphasis> attribute is used to define an event that is triggered
+ before date selection.</para>
+ <para><emphasis>
+ <property>"ondateselected"</property>
+ </emphasis> attribute is used to define an event that is triggered
+ after date selection. </para>
+ <para>For example, to fire some event after date selection you should use
<emphasis role="bold">
+ <property><a4j:support></property>
+ </emphasis>. And it should be bound to <emphasis>
+ <property>"ondateselected"</property>
+ </emphasis> event as
+ it's shown in the example below:</para>
+
+ <programlisting role="XML"><![CDATA[...
+ <rich:calendar id="date" value="#{bean.dateTest}">
+ <a:support event="ondateselected"
reRender="mainTable"/>
+ </rich:calendar>
+...]]></programlisting>
+
+ <para><emphasis>
+ <property>"ondataselect"</property>
+ </emphasis> could be used for possibility of date selection canceling. See an
example below:</para>
+
+ <programlisting role="XML"><![CDATA[...
+ <rich:calendar id="date" value="#{bean.dateTest}"
ondateselect="if (!confirm('Are you sure to change date?')){return
false;}"/>
+...]]></programlisting>
+
+ <para>How to use these attributes see also on the <ulink
+
url="http://www.jboss.com/index.html?module=bb&op=viewtopic&...
+ >RichFaces Users Forum</ulink>.</para>
+
<para>There are three button-related attributes:</para>
<itemizedlist>
<listitem>
@@ -950,7 +982,7 @@
<tbody>
<row>
<entry>rich-calendar-popup</entry>
-
+
<entry>Defines styles for a popup element</entry>
</row>
<row>