[jboss-cvs] jboss-seam/doc/reference/en/modules ...
Peter Muir
peter at bleepbleep.org.uk
Tue Mar 27 15:40:52 EDT 2007
User: pmuir
Date: 07/03/27 15:40:52
Modified: doc/reference/en/modules controls.xml
Log:
Document new s:decorate, remove s:layoutForm
Revision Changes Path
1.32 +8 -104 jboss-seam/doc/reference/en/modules/controls.xml
(In the diff below, changes in quantity of whitespace are not shown.)
Index: controls.xml
===================================================================
RCS file: /cvsroot/jboss/jboss-seam/doc/reference/en/modules/controls.xml,v
retrieving revision 1.31
retrieving revision 1.32
diff -u -b -r1.31 -r1.32
--- controls.xml 25 Mar 2007 13:14:54 -0000 1.31
+++ controls.xml 27 Mar 2007 19:40:52 -0000 1.32
@@ -448,120 +448,24 @@
<para>
<emphasis>Attributes</emphasis>
</para>
- <para>
- None.
- </para>
- <para>
-<emphasis>Usage</emphasis>
-</para>
- <para>
- <programlisting>
-<![CDATA[
-]]></programlisting>
- </para>
- </entry>
- </row>
- <row>
- <entry valign="top">
- <para>
- <literal><s:layoutForm></literal>
- </para>
- </entry>
- <entry valign="top">
- <para>
-<emphasis>Description</emphasis>
-</para>
- <para>
- A layout component for producing a "standard" form layout.
- Each child component will be treated as a row, and if the child is a
- <literal><s:decorate></literal>, additional formatting will be applied:
<itemizedlist>
<listitem>
<para>
- Label — if a <literal>label</literal> facet is on the
- <literal><s:decorate></literal> then it's contents will be used
- as the label for this field. The labels are rendered right-aligned
- in a column
- </para>
- <para>
- Some further decoration facets are supported -
- <literal>beforeLabel</literal>, <literal>afterLabel</literal>,
- <literal>aroundLabel</literal>, <literal>beforeInvalidLabel</literal>,
- <literal>afterInvalidLabel</literal> and <literal>aroundInvalidLabel</literal>.
- </para>
- </listitem>
- <listitem>
- <para>
- Other text — if a <literal>belowLabel</literal> facet or/and a
- <literal>belowField</literal> facet are present on
- <literal><s:decorate></literal> then it's contents will be placed
- below the label or the field
- </para>
- </listitem>
- <listitem>
- <para>
- Required — if <literal>required="true"</literal> is set
- on the field, then the <literal>aroundRequiredField</literal>,
- <literal>beforeRequiredField</literal>, <literal>afterRequiredField</literal>,
- <literal>aroundRequiredLabel</literal>, <literal>beforeRequiredLabel</literal> and
- <literal>afterRequiredLabel</literal> will be applied.
+ <literal>template</literal> — the facelets template to use to decorate the component
</para>
</listitem>
</itemizedlist>
-
- </para>
- <para>
-<emphasis>Attributes</emphasis>
-</para>
- <para>
- None.
- </para>
<para>
<emphasis>Usage</emphasis>
</para>
<para>
<programlisting>
-<![CDATA[<s:layoutForm>
- <f:facet name="aroundInvalidField">
- <s:span styleClass="error"/>
- </f:facet>
- <f:facet name="afterInvalidField">
- <s:message />
- </f:facet>
- <f:facet name="beforeRequiredLabel">
- <s:span>∗</s:span>
- </f:facet>
- <f:facet name="aroundLabel">
- <s:span style="text-align:right;" />
- </f:facet>
- <f:facet name="aroundInvalidLabel">
- <s:span style="text-align:right;" styleClass="error" />
- </f:facet>
- <s:decorate>
- <f:facet name="label">
- <h:outputText value="Name" />
- </f:facet>
- <h:inputText value="#{person.name}" required="true"/>
- <f:facet name="belowField">
- <h:outputText styleClass="help"
- value="Enter your name as it appears
- on your passport" />
- </f:facet>
- </s:decorate>
-</s:layoutForm>]]></programlisting>
+<![CDATA[
+]]></programlisting>
</para>
- <mediaobject>
- <imageobject role="fo">
- <imagedata fileref="images/layoutForm-example.png"/>
- </imageobject>
- <imageobject role="html">
- <imagedata fileref="../shared/images/layoutForm-example.png"/>
- </imageobject>
- </mediaobject>
</entry>
</row>
-
<row>
<entry valign="top">
<para>
More information about the jboss-cvs-commits
mailing list