Author: atsebro Date: 2008-12-02 06:17:02 -0500 (Tue, 02 Dec 2008) New Revision: 11482 Modified: trunk/docs/userguide/en/src/main/docbook/included/modalPanel.xml Log: RF-5174: modalPanel definition Modified: trunk/docs/userguide/en/src/main/docbook/included/modalPanel.xml =================================================================== --- trunk/docs/userguide/en/src/main/docbook/included/modalPanel.xml 2008-12-02 11:10:53 UTC (rev 11481) +++ trunk/docs/userguide/en/src/main/docbook/included/modalPanel.xml 2008-12-02 11:17:02 UTC (rev 11482) @@ -135,12 +135,17 @@ <important> <title>Important:</title> - <para>In order to avoid a bug in IE, the root node of the dialog is - moved on the top of a DOM tree. However, you should have a - separate form inside the modal panel if you want to perform - submits from this panel (so, no form should be around the - modal panel in this case).</para> - </important> + <para>To work properly the &lt;rich:modalPanel&gt; should always be placed + outside the original &lt;h:form&gt; and must include its own &lt;h:form&gt; for such cases like + performing submissions from within the &lt;rich:modalPanel&gt;. + </para> + </important> + <note> + <title>Note:</title> + <para>In order to avoid a bug in IE, the root node of the dialog is moved on the top of a DOM tree. + </para> + </note> + <para>It&apos;s possible to add a <emphasis> <property>&quot;header&quot;</property> @@ -769,36 +774,46 @@ </section> <section> <title>Relevant Resources Links</title> - <para> - <ulink - url="http://livedemo.exadel.com/richfaces-demo/richfaces/modalPanel.... - >Here</ulink> you can see the example of <emphasis - role="bold"> - <property>&lt;rich:modalPanel&gt;</property> - </emphasis> usage and sources for the given example. </para> - <para>Information about wizards using the <emphasis role="bold"> - <property>&lt;rich:modalPanel&gt;</property> - </emphasis> component could be found in the <ulink - url="http://labs.jboss.com/wiki/ModalPanelWizards">Wiki - article</ulink> and in the <ulink - url="http://www.jboss.org/file-access/default/members/jbossrichfaces... - >FAQ</ulink> chapter of the guide. </para> - <para>Examples of validation in <emphasis role="bold"> - <property>&lt;rich:modalPanel&gt;</property> - </emphasis> could be found in the <ulink - url="http://labs.jboss.com/wiki/ModalPanelValidation">Wiki - article</ulink> and on the <ulink - url="http://www.jboss.com/index.html?module=bb&amp;op=viewtopic&... - >RichFaces Users Forum</ulink>. </para> - <para> - <ulink url="http://wiki.jboss.org/wiki/RichFacesPleaseWaitBox"> Here - </ulink> you can find information on how to show a &quot;Please - Wait&quot; box and block the input while the Ajax request is - processed using combination of <emphasis role="bold"> - <property>&lt;a4j:status&gt;</property> - </emphasis> and <emphasis role="bold"> - <property>&lt;rich:modalPanel&gt;</property> - </emphasis> components . </para> + <para>Vizit <ulink url="http://livedemo.exadel.com/richfaces-demo/richfaces/modalPanel.... + ModalPanel page</ulink> at RichFaces Livedemo for examples of component usage and their sources. + </para> + + <para>Read the &quot;<ulink url="http://eclipse.dzone.com/articles/an-introduction-to-jboss-rich... + An Introduction To JBoss RichFaces</ulink>&quot; tutorial by Max Katz to find out how + the <emphasis role="bold"><property>&lt;rich:modalPanel&gt;</property></emphasis> + helps to edit and save changes for table entries. + </para> + + <para>Some articles at JBoss portal describing different aspects of <emphasis role="bold"><property>&lt;rich:modalPanel&gt;</property></emphasis> usage: + </para> + + <itemizedlist> + <listitem> + <para> + &quot;<ulink url="http://www.jboss.org/community/docs/DOC-11436">ModalPan... article describes + how to create a typical wizard with the help of <emphasis role="bold"><property>&lt;rich:modalPanel&gt;</property></emphasis> component + (the same could also be found in the &quot;<ulink url="http://www.jboss.org/file-access/default/members/jbossrichfaces... + How to organize wizards using the &lt;rich:modalPanel&gt; component?</ulink>&quot; chapter of RichFaces FAQ guide); + </para> + </listitem> + <listitem> + <para> + &quot;<ulink url="http://www.jboss.org/community/docs/DOC-11435">ModalPan... article + gives examples of validation in <emphasis role="bold"><property>&lt;rich:modalPanel&gt;</property></emphasis> + (the same in the <ulink url="http://www.jboss.com/index.html?module=bb&amp;op=viewtopic&... topic</ulink> + at RichFaces Users Forum); + </para> + </listitem> + <listitem> + <para> + &quot;<ulink url="http://www.jboss.org/community/docs/DOC-11863">RichFace... article + describes how to show a &quot;Please wait&quot; box and block the input while the Ajax request is being processed + using combination of <emphasis role="bold"><property>&lt;a4j:status&gt;</property></emphasis> and + <emphasis role="bold"><property>&lt;rich:modalPanel&gt;</property></emphasis> components. + </para> + </listitem> + </itemizedlist> + </section>