Author: SeanRogers
Date: 2009-12-15 01:36:15 -0500 (Tue, 15 Dec 2009)
New Revision: 16129
Modified:
branches/community/3.3.X/docs/userguide/en/src/main/docbook/included/rich_modalPanel.xml
Log:
Updated for RF-2288
Modified:
branches/community/3.3.X/docs/userguide/en/src/main/docbook/included/rich_modalPanel.xml
===================================================================
---
branches/community/3.3.X/docs/userguide/en/src/main/docbook/included/rich_modalPanel.xml 2009-12-14
20:52:53 UTC (rev 16128)
+++
branches/community/3.3.X/docs/userguide/en/src/main/docbook/included/rich_modalPanel.xml 2009-12-15
06:36:15 UTC (rev 16129)
@@ -108,13 +108,17 @@
<para>
- The component can restore it's previous state (including position
on the screen) after submitting and reloading.
+ The component can restore its previous state (including position on the
screen) after submitting and reloading.
Set
<emphasis><property>"keepVisualState"</property></emphasis>
to <code>true</code> to submit and pass <emphasis
role="bold"><property><rich:modalPanel></property></emphasis>
current parameters to a new page.
- The
<emphasis><property>"showWhenRendered"</property></emphasis>
bolean attribute is used in cases when component should be rendered after first page
loading.
+ The
<emphasis><property>"showWhenRendered"</property></emphasis>
boolean attribute is used in cases when component should be rendered after first page
loading.
</para>
<para>
- To understand sence of the
<emphasis><property>"domElementAttachment"</property></emphasis>
attribute it is necessary to understand
+ The
<emphasis><property>"trimOverlayedElements"</property></emphasis>
boolean attribute can be used to determine if the modal panel will expand to show other
components inside it. Set the attribute to <code>false</code> to ensure
components are not cut off.
+ </para>
+
+ <para>
+ To understand sense of the
<emphasis><property>"domElementAttachment"</property></emphasis>
attribute it is necessary to understand
what is <emphasis>stacking context</emphasis> and how it
works in the HTML makeup.
Since each <emphasis>positioned</emphasis> or
<emphasis>z-indexed</emphasis> element (CSS
<code>position:absolute</code> or <code>relative</code> and
<code>z-index:*any integer different from 0*</code>)
form their own stacking context the <emphasis
role="bold"><property><rich:modalPanel></property></emphasis>
rendered as a child of such element may be overlapped with an element
@@ -123,7 +127,7 @@
To make the <emphasis
role="bold"><property><rich:modalPanel></property></emphasis>
rendered in "closest" to an observer layer and avoid such overlapping,
the component was designed in way when it is always being automatically
assimilated with <code><body></code> with a very high rendering
layer (<code>z-index</code>).
But our panel should be assimilated with
<code><body></code> not always, because of some side effects
that take place in this case.
- The
<emphasis><property>"domElementAttachment"</property></emphasis>
attribute helps to reassign the panel to it <emphasis>parent</emphasis> or
<emphasis>form</emphasis> element.
+ The
<emphasis><property>"domElementAttachment"</property></emphasis>
attribute helps to reassign the panel to its <emphasis>parent</emphasis> or
<emphasis>form</emphasis> element.
If <emphasis>form</emphasis> is used and no parent form is
available the panel is functioning as if it is assimilated with
<code><body></code>.
</para>
@@ -516,4 +520,4 @@
</section>
-</section>
\ No newline at end of file
+</section>
Show replies by date