From richfaces-svn-commits at lists.jboss.org Sat Jun 28 10:53:08 2008
Content-Type: multipart/mixed; boundary="===============7272688628578204893=="
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: r9290 -
 trunk/docs/userguide/en/src/main/docbook/included.
Date: Sat, 28 Jun 2008 10:53:08 -0400
Message-ID: <E1KCbnY-0003WP-6C@committer01.frg.pub.inap.atl.jboss.com>

--===============7272688628578204893==
Content-Type: text/plain; charset="utf-8"
MIME-Version: 1.0
Content-Transfer-Encoding: quoted-printable

Author: artdaw
Date: 2008-06-28 10:53:08 -0400 (Sat, 28 Jun 2008)
New Revision: 9290

Modified:
   trunk/docs/userguide/en/src/main/docbook/included/hotKey.xml
Log:
http://jira.jboss.com/jira/browse/RF-3783 - Details of Usage =


Modified: trunk/docs/userguide/en/src/main/docbook/included/hotKey.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
--- trunk/docs/userguide/en/src/main/docbook/included/hotKey.xml	2008-06-28=
 13:10:56 UTC (rev 9289)
+++ trunk/docs/userguide/en/src/main/docbook/included/hotKey.xml	2008-06-28=
 14:53:08 UTC (rev 9290)
@@ -64,8 +64,54 @@
     <section>
 		<title>Details of Usage</title>
 		<para>
-
+			There are two ways to register <emphasis role=3D"bold"><property>&lt;ri=
ch:hotKey&gt;</property></emphasis>:
 		</para>
+		<itemizedlist>
+		    <listitem>
+		        <para>
+		            by attaching it to the whole page (<property>html[0] element=
</property>). This is default scenario.
+		        </para>
+		    </listitem>
+		    <listitem>
+		        <para>
+		            by attaching it with <emphasis><property>&quot;selector&quot=
;</property></emphasis> attribute to all the elements =

+		            defined using this selector. =

+		            This attribute uses defined by <ulink url=3D"http://www.w3.o=
rg">w3c consortium</ulink> syntax for CSS rule selector =

+		            with some jQuery extensions. =

+		        </para>
+		    </listitem>
+		</itemizedlist>
+        <para>
+            The <emphasis><property>&quot;key&quot;</property></emphasis> =
attribute defines the hot key itself =

+            which is processed by the component. =

+        </para>
+        <para>
+            After the hot key has been registered and defined you could se=
t the <emphasis><property>&quot;handler&quot;</property></emphasis> =

+            attribute which determines a JavaScript function to be called =
every time when corresponding keys are pressed.   =

+        </para>
+        =

+        <para>
+            With the help of the <emphasis><property>&quot;timing&quot;</p=
roperty></emphasis> attribute
+            you could manage <emphasis role=3D"bold"><property>&lt;rich:ho=
tKey&gt;</property></emphasis> registration timing. =

+            There are three possible values of this attribute:
+        </para>
+        <itemizedlist>
+            <listitem>
+                <para>
+                    &quot;immediate&quot; - the component is rendered in b=
rowser immediately  =

+                </para>
+            </listitem>
+            <listitem>
+                <para>
+                    &quot;onload&quot; - the component is rendered after t=
he page is fully loaded
+                </para>
+            </listitem>
+            <listitem>
+                <para>
+                    &quot;onregistercall&quot; - the component is rendered=
 only after JavaScript API for the key registration is used.
+                </para>
+            </listitem>
+        </itemizedlist>
 	</section>
     <section>
         <title>JavaScript API</title>


--===============7272688628578204893==--