Author: SeanRogers
Date: 2011-04-05 23:34:41 -0400 (Tue, 05 Apr 2011)
New Revision: 22378
Added:
modules/docs/trunk/Component_Reference/src/main/docbook/en-US/extras/exam-Component_Reference-richmessages-In-line_messages.css
modules/docs/trunk/Component_Reference/src/main/docbook/en-US/extras/exam-Component_Reference-richmessages-Messages_in_a_list.css
modules/docs/trunk/Component_Reference/src/main/docbook/en-US/images/figu-Component_Reference-richmessages-In-line_messages.png
modules/docs/trunk/Component_Reference/src/main/docbook/en-US/images/figu-Component_Reference-richmessages-Messages_in_a_block.png
modules/docs/trunk/Component_Reference/src/main/docbook/en-US/images/figu-Component_Reference-richmessages-Messages_in_a_list.png
Modified:
modules/docs/trunk/Component_Reference/src/main/docbook/en-US/chap-Component_Reference-Output_and_messages.xml
Log:
Documented messages layout support: RFPL-1136
Modified:
modules/docs/trunk/Component_Reference/src/main/docbook/en-US/chap-Component_Reference-Output_and_messages.xml
===================================================================
---
modules/docs/trunk/Component_Reference/src/main/docbook/en-US/chap-Component_Reference-Output_and_messages.xml 2011-04-06
01:36:02 UTC (rev 22377)
+++
modules/docs/trunk/Component_Reference/src/main/docbook/en-US/chap-Component_Reference-Output_and_messages.xml 2011-04-06
03:34:41 UTC (rev 22378)
@@ -145,6 +145,71 @@
<para>
The <sgmltag><rich:messages></sgmltag> component can be
further styled through CSS, the same as for the
<sgmltag><rich:message></sgmltag> component. Refer to <xref
linkend="sect-Component_Reference-richmessage-Appearance" /> for an example
of message styling, and refer to <xref
linkend="sect-Component_Reference-richmessages-Style_classes_and_skin_parameters"
/> for a complete list of style classes for the
<sgmltag><rich:message></sgmltag> component.
</para>
+ <para>
+ The layout of the messages can also be customized through CSS. By default, the
messages are arranged in a block as shown in <xref
linkend="figu-Component_Reference-richmessages-Messages_in_a_block" />.
+ </para>
+ <figure
id="figu-Component_Reference-richmessages-Messages_in_a_block">
+ <title>Messages in a block</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/figu-Component_Reference-richmessages-Messages_in_a_block.png"
format="PNG" />
+ </imageobject>
+ <textobject>
+ <para>
+ Messages are displayed in a block arrangement.
+ </para>
+ </textobject>
+ </mediaobject>
+ </figure>
+ <para>
+ Override the <property>display</property> property for all CSS message
classes to customize the layout as follows:
+ </para>
+ <variablelist>
+ <varlistentry>
+ <term>Display messages in a list with no icons</term>
+ <listitem>
+ <para>
+ To display the messages in a list format without the default icons, override the
message styles as follows:
+ </para>
+ <programlisting><xi:include
href="extras/exam-Component_Reference-richmessages-Messages_in_a_list.css"
parse="text"
xmlns:xi="http://www.w3.org/2001/XInclude"
/></programlisting>
+ <figure
id="figu-Component_Reference-richmessages-Messages_in_a_list">
+ <title>Messages in a list</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/figu-Component_Reference-richmessages-Messages_in_a_list.png"
format="PNG" />
+ </imageobject>
+ <textobject>
+ <para>
+ Messages are displayed in a list with bullet points and no icons.
+ </para>
+ </textobject>
+ </mediaobject>
+ </figure>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Display in-line messages</term>
+ <listitem>
+ <para>
+ To display the messages in line with text, override the message styles as
follows:
+ </para>
+ <programlisting><xi:include
href="extras/exam-Component_Reference-richmessages-In-line_messages.css"
parse="text"
xmlns:xi="http://www.w3.org/2001/XInclude"
/></programlisting>
+ <figure
id="figu-Component_Reference-richmessages-In-line_messages">
+ <title>In-line messages</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/figu-Component_Reference-richmessages-In-line_messages.png"
format="PNG" />
+ </imageobject>
+ <textobject>
+ <para>
+ Messages are displayed in a list with bullet points and no icons.
+ </para>
+ </textobject>
+ </mediaobject>
+ </figure>
+ </listitem>
+ </varlistentry>
+ </variablelist>
</section>
<section id="sect-Component_Reference-richmessages-Reference_data">
Added:
modules/docs/trunk/Component_Reference/src/main/docbook/en-US/extras/exam-Component_Reference-richmessages-In-line_messages.css
===================================================================
---
modules/docs/trunk/Component_Reference/src/main/docbook/en-US/extras/exam-Component_Reference-richmessages-In-line_messages.css
(rev 0)
+++
modules/docs/trunk/Component_Reference/src/main/docbook/en-US/extras/exam-Component_Reference-richmessages-In-line_messages.css 2011-04-06
03:34:41 UTC (rev 22378)
@@ -0,0 +1,2 @@
+.rf-msg-err, .rf-msgs-err, .rf-msg-ftl, .rf-msgs-ftl, .rf-msg-inf,
+.rf-msgs-inf, .rf-msg-wrn, .rf-msgs-wrn, .rf-msg-ok, .rf-msgs-ok { display:inline; }
Added:
modules/docs/trunk/Component_Reference/src/main/docbook/en-US/extras/exam-Component_Reference-richmessages-Messages_in_a_list.css
===================================================================
---
modules/docs/trunk/Component_Reference/src/main/docbook/en-US/extras/exam-Component_Reference-richmessages-Messages_in_a_list.css
(rev 0)
+++
modules/docs/trunk/Component_Reference/src/main/docbook/en-US/extras/exam-Component_Reference-richmessages-Messages_in_a_list.css 2011-04-06
03:34:41 UTC (rev 22378)
@@ -0,0 +1,7 @@
+.rf-msg-err, .rf-msgs-err, .rf-msg-ftl, .rf-msgs-ftl, .rf-msg-inf,
+.rf-msgs-inf, .rf-msg-wrn, .rf-msgs-wrn, .rf-msg-ok, .rf-msgs-ok {
+ display: list-item;
+ margin-left: 20px;
+ padding-left: 0px; }
+
+.rf-msg-err, .rf-msgs-err{ background-image:none; }
Added:
modules/docs/trunk/Component_Reference/src/main/docbook/en-US/images/figu-Component_Reference-richmessages-In-line_messages.png
===================================================================
(Binary files differ)
Property changes on:
modules/docs/trunk/Component_Reference/src/main/docbook/en-US/images/figu-Component_Reference-richmessages-In-line_messages.png
___________________________________________________________________
Added: svn:mime-type
+ application/octet-stream
Added:
modules/docs/trunk/Component_Reference/src/main/docbook/en-US/images/figu-Component_Reference-richmessages-Messages_in_a_block.png
===================================================================
(Binary files differ)
Property changes on:
modules/docs/trunk/Component_Reference/src/main/docbook/en-US/images/figu-Component_Reference-richmessages-Messages_in_a_block.png
___________________________________________________________________
Added: svn:mime-type
+ application/octet-stream
Added:
modules/docs/trunk/Component_Reference/src/main/docbook/en-US/images/figu-Component_Reference-richmessages-Messages_in_a_list.png
===================================================================
(Binary files differ)
Property changes on:
modules/docs/trunk/Component_Reference/src/main/docbook/en-US/images/figu-Component_Reference-richmessages-Messages_in_a_list.png
___________________________________________________________________
Added: svn:mime-type
+ application/octet-stream