[jboss-cvs] JBossAS SVN: r105513 - projects/docs/enterprise/EAP/trunk/5.x/Seam_Reference_Guide/en-US.
jboss-cvs-commits at lists.jboss.org
jboss-cvs-commits at lists.jboss.org
Tue Jun 1 18:34:23 EDT 2010
Author: misty at redhat.com
Date: 2010-06-01 18:34:23 -0400 (Tue, 01 Jun 2010)
New Revision: 105513
Modified:
projects/docs/enterprise/EAP/trunk/5.x/Seam_Reference_Guide/en-US/Controls.xml
Log:
JBPAPP-4387
Modified: projects/docs/enterprise/EAP/trunk/5.x/Seam_Reference_Guide/en-US/Controls.xml
===================================================================
--- projects/docs/enterprise/EAP/trunk/5.x/Seam_Reference_Guide/en-US/Controls.xml 2010-06-01 22:34:13 UTC (rev 105512)
+++ projects/docs/enterprise/EAP/trunk/5.x/Seam_Reference_Guide/en-US/Controls.xml 2010-06-01 22:34:23 UTC (rev 105513)
@@ -16,7 +16,7 @@
To use these tags, define the <literal>s</literal> namespace in your page as follows (Facelets only):
</para>
-<programlisting role="XHTML"><![CDATA[<html xmlns="http://www.w3.org/1999/xhtml"
+<programlisting lanuage="XML" role="XML"><![CDATA[<html xmlns="http://www.w3.org/1999/xhtml"
xmlns:s="http://jboss.com/products/seam/taglib">
]]></programlisting>
<para>
@@ -76,7 +76,7 @@
<emphasis>Usage</emphasis>
</para>
-<programlisting role="XHTML"><![CDATA[<s:button id="cancel" value="Cancel" action="#{hotelBooking.cancel}"/>
+<programlisting language="XML" role="XML"><![CDATA[<s:button id="cancel" value="Cancel" action="#{hotelBooking.cancel}"/>
]]></programlisting>
<para>
You can specify both <literal>view</literal> and <literal>action</literal> on <literal><![CDATA[<s:link />]]></literal>. In this case, the action will be called once the redirect to the specified view has occurred.
@@ -176,7 +176,7 @@
<emphasis>Usage</emphasis>
</para>
-<programlisting role="XHTML"><![CDATA[<s:link id="register" view="/register.xhtml" value="Register New User"/>
+<programlisting language="XML" role="XML"><![CDATA[<s:link id="register" view="/register.xhtml" value="Register New User"/>
]]></programlisting>
<para>
You can specify both <literal>view</literal> and <literal>action</literal> on <literal><![CDATA[<s:link />]]></literal>. In this case, the action will be called once the redirect to the specified view has occurred.
@@ -210,7 +210,7 @@
<emphasis>Usage</emphasis>
</para>
-<programlisting role="XHTML"><![CDATA[<h:commandButton value="Apply" action="#{personHome.update}">
+<programlisting language="XML" role="XML"><![CDATA[<h:commandButton value="Apply" action="#{personHome.update}">
<s:conversationPropagation type="join" />
</h:commandButton>
]]></programlisting>
@@ -240,7 +240,7 @@
<emphasis>Usage</emphasis>
</para>
-<programlisting role="XHTML"><![CDATA[<h:commandButton id="foo" value="Foo" action="#{manager.foo}">
+<programlisting language="XML" role="XML"><![CDATA[<h:commandButton id="foo" value="Foo" action="#{manager.foo}">
<s:defaultAction />
</h:commandButton>
]]></programlisting>
@@ -268,7 +268,7 @@
<emphasis>Usage</emphasis>
</para>
-<programlisting role="XHTML"><![CDATA[<h:outputText value="#{item.orderDate}">
+<programlisting language="XML" role="XML"><![CDATA[<h:outputText value="#{item.orderDate}">
<s:convertDateTime type="both" dateStyle="full"/>
</h:outputText>]]>
</programlisting>
@@ -301,7 +301,7 @@
Your <emphasis>Managed Persistence Context</emphasis> must be named <literal>entityManager</literal> — if it is not, you can change its named in <literal>components.xml</literal>:
</para>
-<programlisting><![CDATA[<components xmlns="http://jboss.com/products/seam/components"
+<programlisting language="XML" role="XML"><![CDATA[<components xmlns="http://jboss.com/products/seam/components"
xmlns:ui="http://jboss.com/products/seam/ui">
<ui:jpa-entity-loader entity-manager="#{em}" />
]]></programlisting>
@@ -309,7 +309,7 @@
If you are using a <emphasis>Managed Hibernate Session</emphasis>, you must also set this in <literal>components.xml</literal>:
</para>
-<programlisting><![CDATA[<components xmlns="http://jboss.com/products/seam/components"
+<programlisting language="XML" role="XML"><![CDATA[<components xmlns="http://jboss.com/products/seam/components"
xmlns:ui="http://jboss.com/products/seam/ui">
<ui:hibernate-entity-loader />
]]></programlisting>
@@ -317,7 +317,7 @@
Your <emphasis>Managed Hibernate Session</emphasis> must be named <literal>session</literal> — if it is not, you can change its named in <filename>components.xml</filename>:
</para>
-<programlisting><![CDATA[<components xmlns="http://jboss.com/products/seam/components"
+<programlisting language="XML" role="XML"><![CDATA[<components xmlns="http://jboss.com/products/seam/components"
xmlns:ui="http://jboss.com/products/seam/ui">
<ui:hibernate-entity-loader session="#{hibernateSession}" />
]]></programlisting>
@@ -325,7 +325,7 @@
To use multiple entity managers with the entity converter, create a copy of the entity converter for each entity manager in <filename>components.xml</filename>. The entity converter delegates to the entity loader to perform persistence operations like so:
</para>
-<programlisting><![CDATA[<components xmlns="http://jboss.com/products/seam/components"
+<programlisting language="XML" role="XML"><![CDATA[<components xmlns="http://jboss.com/products/seam/components"
xmlns:ui="http://jboss.com/products/seam/ui">
<ui:entity-converter name="standardEntityConverter"
entity-loader="#{standardEntityLoader}" />
@@ -337,7 +337,7 @@
entity-manager="#{restrictedEntityManager}" />
]]></programlisting>
-<programlisting><![CDATA[<h:selectOneMenu value="#{person.continent}">
+<programlisting language="XML" role="XML"><![CDATA[<h:selectOneMenu value="#{person.continent}">
<s:selectItems value="#{continents.resultList}"
var="continent" label="#{continent.name}" />
<f:converter converterId="standardEntityConverter" />
@@ -347,7 +347,7 @@
<emphasis>Usage</emphasis>
</para>
-<programlisting role="XHTML"><![CDATA[<h:selectOneMenu value="#{person.continent}" required="true">
+<programlisting language="XML" role="XML"><![CDATA[<h:selectOneMenu value="#{person.continent}" required="true">
<s:selectItems value="#{continents.resultList}" var="continent"
label="#{continent.name}" noSelectionLabel="Please Select..."/>
<s:convertEntity />
@@ -373,7 +373,7 @@
<emphasis>Usage</emphasis>
</para>
-<programlisting role="XHTML"><![CDATA[<h:selectOneMenu value="#{person.honorific}">
+<programlisting language="XML" role="XML"><![CDATA[<h:selectOneMenu value="#{person.honorific}">
<s:selectItems value="#{honorifics}" var="honorific"
label="#{honorific.label}" noSelectionLabel="Please select" />
<s:convertEnum />
@@ -399,7 +399,7 @@
<emphasis>Usage</emphasis>
</para>
-<programlisting><![CDATA[<h:outputText value="#{item.valid}">
+<programlisting language="XML" role="XML"><![CDATA[<h:outputText value="#{item.valid}">
<s:convertAtomicBoolean />
</h:outputText>
]]></programlisting>
@@ -423,7 +423,7 @@
<emphasis>Usage</emphasis>
</para>
-<programlisting><![CDATA[<h:outputText value="#{item.id}">
+<programlisting language="XML" role="XML"><![CDATA[<h:outputText value="#{item.id}">
<s:convertAtomicInteger />
</h:outputText>
]]></programlisting>
@@ -447,7 +447,7 @@
<emphasis>Usage</emphasis>
</para>
-<programlisting><![CDATA[<h:outputText value="#{item.id}">
+<programlisting language="XML" role="XML"><![CDATA[<h:outputText value="#{item.id}">
<s:convertAtomicLong />
</h:outputText>
]]></programlisting>
@@ -527,7 +527,7 @@
<emphasis>Usage</emphasis>
</para>
-<programlisting><![CDATA[<h:inputText id="name" value="#{bean.name}"/>
+<programlisting language="XML" role="XML"><![CDATA[<h:inputText id="name" value="#{bean.name}"/>
<h:inputText id="nameVerification" >
<s:validateEquality for="name" />
</h:inputText>]]>
@@ -552,7 +552,7 @@
<emphasis>Usage</emphasis>
</para>
-<programlisting role="XHTML"><![CDATA[<h:inputText id="userName" required="true" value="#{customer.userName}">
+<programlisting language="XML" role="XML"><![CDATA[<h:inputText id="userName" required="true" value="#{customer.userName}">
<s:validate />
</h:inputText>
<h:message for="userName" styleClass="error" />
@@ -577,7 +577,7 @@
<emphasis>Usage</emphasis>
</para>
-<programlisting role="XHTML"><![CDATA[<s:validateAll>
+<programlisting language="XML" role="XML"><![CDATA[<s:validateAll>
<div class="entry">
<h:outputLabel for="username">Username:</h:outputLabel>
<h:inputText id="username" value="#{user.username}" required="true"/>
@@ -638,13 +638,13 @@
<emphasis>Usage</emphasis>
</para>
-<programlisting role="XHTML"><![CDATA[<s:decorate template="edit.xhtml">
+<programlisting language="XML" role="XML"><![CDATA[<s:decorate template="edit.xhtml">
<ui:define name="label">Country:</ui:define>
<h:inputText value="#{location.country}" required="true"/>
</s:decorate>]]>
</programlisting>
-<programlisting role="XHTML"><![CDATA[<ui:composition xmlns="http://www.w3.org/1999/xhtml"
+<programlisting language="XML" role="XML"><![CDATA[<ui:composition xmlns="http://www.w3.org/1999/xhtml"
xmlns:ui="http://java.sun.com/jsf/facelets"
xmlns:h="http://java.sun.com/jsf/html"
xmlns:f="http://java.sun.com/jsf/core"
@@ -683,7 +683,7 @@
<emphasis>Usage</emphasis>
</para>
-<programlisting role="XHTML"><![CDATA[<s:div rendered="#{selectedMember == null}">
+<programlisting language="XML" role="XML"><![CDATA[<s:div rendered="#{selectedMember == null}">
Sorry, but this member does not exist.
</s:div>
]]></programlisting>
@@ -713,7 +713,7 @@
<emphasis>Usage</emphasis>
</para>
-<programlisting role="XHTML"><![CDATA[<s:span styleClass="required" rendered="#{required}" title="Small tooltip">
+<programlisting language="XML" role="XML"><![CDATA[<s:span styleClass="required" rendered="#{required}" title="Small tooltip">
*
</s:span>
]]></programlisting>
@@ -738,7 +738,7 @@
<emphasis>Usage</emphasis>
</para>
-<programlisting role="XHTML"><![CDATA[<s:fragment rendered="#{auction.highBidder ne null}">
+<programlisting language="XML" role="XML"><![CDATA[<s:fragment rendered="#{auction.highBidder ne null}">
Current bid:
</s:fragment>
]]></programlisting>
@@ -771,7 +771,7 @@
<emphasis>Usage</emphasis>
</para>
-<programlisting role="XHTML"><![CDATA[<s:label styleClass="label"> Country: </s:label>
+<programlisting language="XML" role="XML"><![CDATA[<s:label styleClass="label"> Country: </s:label>
<h:inputText value="#{location.country}" required="true"/>
]]></programlisting>
</section>
@@ -794,7 +794,7 @@
<emphasis>Usage</emphasis>
</para>
-<programlisting role="XHTML"><![CDATA[<f:facet name="afterInvalidField">
+<programlisting language="XML" role="XML"><![CDATA[<f:facet name="afterInvalidField">
<s:span>
Error:
<s:message/>
@@ -845,7 +845,7 @@
<emphasis>Usage</emphasis>
</para>
-<programlisting role="XHTML"><![CDATA[<s:formattedText value="#{blog.text}"/>]]>
+<programlisting language="XML" role="XML"><![CDATA[<s:formattedText value="#{blog.text}"/>]]>
</programlisting>
<para>
<emphasis>Example</emphasis>
@@ -896,7 +896,7 @@
<emphasis>Usage</emphasis>
</para>
-<programlisting role="XHTML"><![CDATA[<h:form>
+<programlisting language="XML" role="XML"><![CDATA[<h:form>
<s:token enableCookieNotice="true" requireSession="false"/>
...
</h:form>
@@ -930,7 +930,7 @@
<emphasis>Usage</emphasis>
</para>
-<programlisting role="XHTML"><![CDATA[<h:selectOneRadio id="radioList"
+<programlisting language="XML" role="XML"><![CDATA[<h:selectOneRadio id="radioList"
layout="lineDirection"
value="#{newPayment.paymentFrequency}">
<s:convertEnum />
@@ -995,7 +995,7 @@
<emphasis>Usage</emphasis>
</para>
-<programlisting role="XHTML"><![CDATA[<h:selectOneMenu value="#{person.age}" converter="ageConverter">
+<programlisting language="XML" role="XML"><![CDATA[<h:selectOneMenu value="#{person.age}" converter="ageConverter">
<s:selectItems value="#{ages}" var="age" label="#{age}" />
</h:selectOneMenu>
]]></programlisting>
@@ -1010,13 +1010,13 @@
Renders a file upload control. This control must be used within a form with an encoding type of <literal>multipart/form-data</literal>:
</para>
-<programlisting role="XHTML"><![CDATA[<h:form enctype="multipart/form-data">
+<programlisting language="XML" role="XML"><![CDATA[<h:form enctype="multipart/form-data">
]]></programlisting>
<para>
For multipart requests, the Seam Multipart servlet filter must also be configured in <filename>web.xml</filename>:
</para>
-<programlisting role="XML"><![CDATA[<filter>
+<programlisting language="XML" role="XML"><![CDATA[<filter>
<filter-name>Seam Filter</filter-name>
<filter-class>org.jboss.seam.servlet.SeamFilter</filter-class>
</filter>
@@ -1047,7 +1047,7 @@
Here's an example:
</para>
-<programlisting role="XML"><![CDATA[<component class="org.jboss.seam.web.MultipartFilter">
+<programlisting language="XML" role="XML"><![CDATA[<component class="org.jboss.seam.web.MultipartFilter">
<property name="createTempFiles">true</property>
<property name="maxRequestSize">1000000</property>
</component>]]>
@@ -1096,7 +1096,7 @@
<emphasis>Usage</emphasis>
</para>
-<programlisting role="XHTML"><![CDATA[<s:fileUpload id="picture"
+<programlisting language="XML" role="XML"><![CDATA[<s:fileUpload id="picture"
data="#{register.picture}" accept="image/png"
contentType="#{register.pictureContentType}" />]]></programlisting>
</section>
@@ -1137,7 +1137,7 @@
<emphasis>Usage</emphasis>
</para>
-<programlisting role="XHTML"><![CDATA[<s:cache key="entry-#{blogEntry.id}" region="pageFragments">
+<programlisting language="XML" role="XML"><![CDATA[<s:cache key="entry-#{blogEntry.id}" region="pageFragments">
<div class="blogEntry">
<h3>#{blogEntry.title}</h3>
<div>
@@ -1167,7 +1167,7 @@
<emphasis>Configuration</emphasis>
</para>
-<programlisting role="XML"><![CDATA[<servlet>
+<programlisting language="XML" role="XML"><![CDATA[<servlet>
<servlet-name>Document Store Servlet</servlet-name>
<servlet-class>
org.jboss.seam.document.DocumentStoreServlet
@@ -1210,7 +1210,7 @@
The tag is used as follows:
</para>
-<programlisting role="XHTML"><![CDATA[<s:resource xmlns="http://www.w3.org/1999/xhtml"
+<programlisting language="XML" role="XML"><![CDATA[<s:resource xmlns="http://www.w3.org/1999/xhtml"
xmlns:s="http://jboss.com/products/seam/taglib"
data="#{resources.data}" contentType="#{resources.contentType}"
fileName="#{resources.fileName}" />
@@ -1239,7 +1239,7 @@
<emphasis>Attributes</emphasis>
</para>
-<programlisting role="XHTML"><![CDATA[<s:download src="/resources.xhtml">
+<programlisting language="XML" role="XML"><![CDATA[<s:download src="/resources.xhtml">
<f:param name="fileId" value="#{someBean.downloadableFileId}"/>
</s:download>
]]></programlisting>
@@ -1340,7 +1340,7 @@
<emphasis>Usage</emphasis>
</para>
-<programlisting role="XHTML"><![CDATA[<s:graphicImage rendered="#{auction.image ne null}"
+<programlisting language="XML" role="XML"><![CDATA[<s:graphicImage rendered="#{auction.image ne null}"
value="#{auction.image.data}">
<s:transformImageSize width="200" maintainRatio="true"/>
</s:graphicImage>]]>
@@ -1369,7 +1369,7 @@
<emphasis>Usage</emphasis>
</para>
-<programlisting role="XHTML"><![CDATA[<s:remote include="customerAction,accountAction,com.acme.MyBean"/>]]>
+<programlisting language="XML" role="XML"><![CDATA[<s:remote include="customerAction,accountAction,com.acme.MyBean"/>]]>
</programlisting>
</section>
@@ -1387,7 +1387,7 @@
<term> <literal>@Converter</literal> </term>
<listitem>
-<programlisting role="JAVA"><![CDATA[@Name("itemConverter")
+<programlisting language="XML" role="JAVA"><![CDATA[@Name("itemConverter")
@BypassInterceptors
@Converter
public class ItemConverter implements Converter {
@@ -1405,7 +1405,7 @@
}
]]></programlisting>
-<programlisting role="XHTML"><![CDATA[<h:inputText value="#{shop.item}" converter="itemConverter" />]]>
+<programlisting language="XML" role="XML"><![CDATA[<h:inputText value="#{shop.item}" converter="itemConverter" />]]>
</programlisting>
<para>
Registers the Seam component as a JSF converter. Here, the converter accesses the JPA EntityManager inside a JTA transaction when converting the value back to its object representation.
@@ -1416,7 +1416,7 @@
<term> <literal>@Validator</literal> </term>
<listitem>
-<programlisting role="JAVA"><![CDATA[@Name("itemValidator")
+<programlisting language="Java" role="JAVA">@Name("itemValidator")
@BypassInterceptors
@org.jboss.seam.annotations.faces.Validator
public class ItemValidator implements javax.faces.validator.Validator {
@@ -1429,10 +1429,9 @@
throw ValidatorException("Invalid value " + value);
}
}
-}
-]]></programlisting>
+}</programlisting>
-<programlisting role="XHTML"><![CDATA[<h:inputText value="#{shop.item}" validator="itemValidator" />
+<programlisting language="XML" role="XML"><![CDATA[<h:inputText value="#{shop.item}" validator="itemValidator" />
]]></programlisting>
<para>
Registers the Seam component as a JSF validator. Here, the validator injects another Seam component; the injected component is used to validate the value.
More information about the jboss-cvs-commits
mailing list