Added: incubator/adffaces/trunk/trinidad/src/site/xdoc/installation.xml URL: http://svn.apache.org/viewvc/incubator/adffaces/trunk/trinidad/src/site/xdoc/installation.xml?rev=429972&view=auto ============================================================================== --- incubator/adffaces/trunk/trinidad/src/site/xdoc/installation.xml (added) +++ incubator/adffaces/trunk/trinidad/src/site/xdoc/installation.xml Tue Aug 8 22:46:09 2006 @@ -0,0 +1,180 @@ +<?xml version="1.0" encoding="ISO-8859-1" ?> +<document> + <properties> + <title>Installation</title> + </properties> + + <body> + <section name="Installation"> + <p> + <ul> + <li> + <a href="#Dependencies">Dependencies</a> + </li> + <li> + <a href="#Deliverables">Deliverables</a> + </li> + <li> + <a href="#General Installation">General Installation</a> + </li> + <li> + <a href="#Demos">Demos</a> + </li> + <li> + <a href="#Platform Information">Platform Information</a> + </li> + </ul> + </p> + </section> + <section name="Dependencies"> + <p> +Dependencies of Apache Trinidad include: + <ul> + <li>Java 5</li> + <li>Either the JSF 1.1 reference implementation or later or MyFaces 1.0.8 or later, and their respective dependencies.</li> + </ul> + </p> + </section> + <section name="Deliverables"> + <p> +The Apache Trinidad deliverables are: + <ul> + <li>trinidad-api-incubator-m1.jar: public APIs of Apache Trinidad, all in the org.apache.myfaces.trinidad package</li> + <li>trinidad-impl-incubator-m1.jar: private APIs of Apache Trinidad, all in the org.apache.myfaces.trinidadinternal package</li> + </ul> + </p> + <p> +Developers are strongly encouraged to compile against the Trinidad API +JAR only - this will ensure that you are only using public APIs. +</p> + + + +</section> +<section name="General Installation"> +<p> +Apache Trinidad is designed to run on any J2EE-compliant application server. +To install Apache Trinidad outside of a JDeveloper-based environment, take +the following steps: + +<ol> +<li>Install either JSF 1.1.01 reference implementation or MyFaces 1.0.8 or later, and their respective dependencies. Please consult your application +server provider for documentation on this step. </li> +<li>Install the <a href="#Deliverables">Apache Trinidad libraries</a> +and <a href="#Dependencies">dependencies</a> in <code>WEB-INF/lib</code>.</li> +<li>Register the Apache Trinidad filter in your <code>WEB-INF/web.xml</code>: +<source><![CDATA[ + <filter> + <filter-name>trinidad</filter-name> + <filter-class>org.apache.myfaces.trinidad.webapp.TrinidadFilter</filter-class> + </filter> + + <filter-mapping> + <filter-name>trinidad</filter-name> + <!-- This assumes that the FacesServlet has been registered --> + <!-- under the name "faces" --> + <servlet-name>faces</servlet-name> + </filter-mapping> +]]> +</source> +</li> +<li> +Tell JSF to use the Apache Trinidad RenderKit by adding the following to +your faces-config.xml: +<source><![CDATA[ + <application> + <default-render-kit-id> + org.apache.myfaces.trinidad.core + </default-render-kit-id> + </application> +]]> +</source> +</li> +<li> +Register the ResourceServlet that would be used for serving the resources at runtime(images, javascripts and styles): +<source><![CDATA[ + <servlet> + <servlet-name>resources</servlet-name> + <servlet-class>org.apache.myfaces.trinidad.webapp.ResourceServlet</servlet-class> + </servlet> + +<!-- This cannot be configured currently --> +<servlet-mapping> + <servlet-name>resources</servlet-name> + <url-pattern>/adf/*</url-pattern> +</servlet-mapping> + + +]]> +</source> +</li> +</ol> + +</p> +<p> +In addition, it is strongly recommended that you enable client-side +state saving, again in <code>WEB-INF/web.xml</code>. Apache Trinidad offers +a much improved version of client-side state saving that is a +significant improvement over standard server-side state saving. State +is still saved in the <code>HttpSession</code>, but a token is sent to +the client to disambiguate instances of a page, and session-based +state is serializable to support failover. + +<source><![CDATA[ + <context-param> + <param-name>javax.faces.STATE_SAVING_METHOD</param-name> + <param-value>client</param-value> + </context-param> +]]> +</source> +</p> +<p> +Finally, if you plan on using Facelets, you should add the following +items to your <code>WEB-INF/web.xml</code>. + +<source><![CDATA[ + <context-param> + <param-name>org.apache.myfaces.adf.ALTERNATE_VIEW_HANDLER</param-name> + <param-value>com.sun.facelets.FaceletViewHandler</param-value> + </context-param> + + <context-param> + <param-name>facelets.VIEW_MAPPINGS</param-name> + <param-value>*.xhtml</param-value> + </context-param> +]]></source> +</p> +</section> +<section name="Configuration for Development"> + If you are an application developer, there are +</section> + +<section name="Demos"> +<p> +The demos are available in trinidad-demo.war. +</p> +<p> +<a name="emailjars"> +One of the demos allows you to check email. If you are not running in a J2EE 1.3 (or higher) server you will need to add the jars listed below to adf-faces-demo/WEB-INF/lib. +</a> +</p> +<ul> +<li> +<a href="http://java.sun.com/products/javamail/javamail-1_2.html";>JavaMail</a> - go to download button for "Download JavaMail API Implementation Version 1.2 " and download 'javamail-1_2.zip'. Extract the jar: +<ul> +<li>mail.jar</li> +</ul> +</li> +<li> +<a href="http://java.sun.com/products/javabeans/glasgow/jaf.html";>JavaBeans Activation Framework</a> - go to the download button and download 'jaf-1_0_2-upd.zip'. Extract the jar: +<ul> +<li>activation.jar</li> +</ul> +</li> +</ul> +<p> +To access the demos, start at index.jspx. +</p> +</section> +</body> +</document>
Added: incubator/adffaces/trunk/trinidad/src/site/xdoc/past-release-notes.xml URL: http://svn.apache.org/viewvc/incubator/adffaces/trunk/trinidad/src/site/xdoc/past-release-notes.xml?rev=429972&view=auto ============================================================================== --- incubator/adffaces/trunk/trinidad/src/site/xdoc/past-release-notes.xml (added) +++ incubator/adffaces/trunk/trinidad/src/site/xdoc/past-release-notes.xml Tue Aug 8 22:46:09 2006 @@ -0,0 +1,21 @@ +<?xml version="1.0" encoding="ISO-8859-1" ?> +<document> + <properties> + <title>Previous Release Notes</title> + </properties> + + <body> + <section name="Previous Apache Trinidad Release Notes"> + <p> + <ul> + + <li> + Since this is the first Apache Trinidad release, there are no + past release notes. In the future, release notes for previous + versions may be found here. + </li> + </ul> + </p> + </section> + </body> +</document> Added: incubator/adffaces/trunk/trinidad/src/site/xdoc/release-notes.xml URL: http://svn.apache.org/viewvc/incubator/adffaces/trunk/trinidad/src/site/xdoc/release-notes.xml?rev=429972&view=auto ============================================================================== --- incubator/adffaces/trunk/trinidad/src/site/xdoc/release-notes.xml (added) +++ incubator/adffaces/trunk/trinidad/src/site/xdoc/release-notes.xml Tue Aug 8 22:46:09 2006 @@ -0,0 +1,170 @@ +<?xml version="1.0" encoding="ISO-8859-1" ?> +<document> + <properties> + <title>Release Notes</title> + </properties> + + <body> + <section name="Apache Trinidad Release Notes"> + <p> + <ul> + <li> + <a href="#Overview">Overview</a> + </li> + <li> + <a href="#Release Notes">Release Notes</a> + </li> + <li> + <a href="#Supported Platforms">Supported Platforms</a> + </li> + </ul> + </p> + </section> + + <section name="Overview"> + <p>This is the Milestone 1 release of Apache Trinidad. + </p> + </section> + <section name="Release Notes"> +<subsection name="Features"> +</subsection> + +<subsection name="Changes from previous release"> + <ul> + <li><a href="api-changes.html">API Changes from Oracle ADF Faces</a></li> + </ul> +</subsection> +<subsection name="Help"> + <p> +Please see the <a href="FAQ.html" >FAQ</a> for help. + </p> +</subsection> + </section> + +<section name="Supported Platforms"> +Apache Trinidad is currently supported in the following user agents (i.e. browsing platforms): + + +<table summary="" border="1" cellspacing="0" cellpadding="5"> + <tr> + <td colspan="2" rowspan="2"></td> + <td align="center" colspan="6">Operating Systems</td> + + </tr> + <tr> + <td>Windows</td> + + <td>Solaris</td> + + <td>Mac OS X</td> + + <td>Red Hat Linux</td> + + + <td>Windows Mobile</td> + + <td>Palm OS</td> + </tr> + <tr> + <td valign="middle" rowspan="9">User Agents</td> + + <td>Internet Explorer</td> + <td align="center">6.0<span style="vertical-align:super;">*</span></td> + <td align="center">-</td> + + <td align="center">-</td> + <td align="center">-</td> + + <td align="center">2003+</td> + + <td align="center">-</td> + + </tr> + + <tr> + <td>Mozilla</td> + + <td align="center">1.7.x</td> + + <td align="center">-</td> + + + <td align="center">-</td> + + <td align="center">1.7.x</td> + + <td align="center">-</td> + + + <td align="center">-</td> + </tr> + + <tr> + <td>Firefox</td> + + <td align="center">1.0.x</td> + + + <td align="center">-</td> + + <td align="center">-</td> + + <td align="center">1.0.x</td> + + + <td align="center">-</td> + + <td align="center">-</td> + </tr> + + <tr> + <td>Safari</td> + + + <td align="center">-</td> + + <td align="center">-</td> + + <td align="center">1.3, 2.0<span style="vertical-align:super;">**</span></td> + + + <td align="center">-</td> + + <td align="center">-</td> + + <td align="center">-</td> + </tr> + + + <tr> + <td>WebPro (Mobile)</td> + + <td align="center">-</td> + + <td align="center">-</td> + + + <td align="center">-</td> + + <td align="center">-</td> + + <td align="center">-</td> + + <td align="center">3.0</td> + + </tr> +</table> +<p> +<table> +<tr> +<td>*</td><td>Accessibility and BiDi is only supported on IE on Windows.</td> +</tr> +<tr> +<td>**</td><td>Apple bug fixes provided in Safari 1.3 patch 312.2 and Safari 2.0 patch 412.5 required.</td> +</tr> +</table> + + +</section> + </body> +</document> Added: incubator/adffaces/trunk/trinidad/src/site/xdoc/release.xml URL: http://svn.apache.org/viewvc/incubator/adffaces/trunk/trinidad/src/site/xdoc/release.xml?rev=429972&view=auto ============================================================================== --- incubator/adffaces/trunk/trinidad/src/site/xdoc/release.xml (added) +++ incubator/adffaces/trunk/trinidad/src/site/xdoc/release.xml Tue Aug 8 22:46:09 2006 @@ -0,0 +1,79 @@ +<?xml version="1.0" encoding="ISO-8859-1" ?> +<document> + <properties> + <title>Release Information</title> + </properties> + + <body> + <section name="Release Information"> + <p> + <ul> + <li> + <a href="#Release Notes">Release Notes</a> + </li> + <li> + <a href="">Live Demos</a> + </li> + <li> + <a href="#Download">Download</a> + </li> + <li> + <a href="installation.html">Installation</a> + </li> + <li> + <a href="#Documentation">Documentation</a> + </li> + <li> + <a href="#Support">Support</a> + </li> + <li> + <a href="#Filing Bugs">Filing Bugs</a> + </li> + </ul> + </p> + </section> + + <section name="Release Notes"> + <p> + Current <a href="release-notes.html">release notes</a> + </p> + </section> +<!-- + <section name="Download"> + </section> +--> + + <section name="Documentation"> + <p> + <subsection name="API documentation"> + <ul> + <li><a href="trinidad-api/apidocs/index.html">API Javadoc</a></li> + <li><a href="trinidad-api/tagdoc.html">Apache Trinidad Tag documentation</a></li> + </ul> + </subsection> + <subsection name="Further documentation"> + All documentation assumes a familiarity with JavaServer Faces. + <ul> + <li><a href="devguide/index.html">Developer's Guide</a></li> + <li><a href="spec-diff.html">Converting from JavaServer Faces spec tags to Apache Trinidad Tags</a></li> + <li><a href="api-changes.html">Converting from ADF Faces tags to Apache Trinidad Tags</a></li> + </ul> + </subsection> + </p> + </section> + <section name="Support"> + <p> +Please see the <a href="FAQ.html" >FAQ</a> for help. + + </p> + <p> +If the FAQ is insufficient, please send e-mail to the <a href="mailto:[EMAIL PROTECTED]">adffaces_user</a> mailing list. +</p> + </section> + <section name="Filing Bugs"> + <p> +Please file bugs in the <a href="http://issues.apache.org/jira/browse/ADFFACES";>JIRA issue tracker</a>. + </p> + </section> + </body> +</document> Added: incubator/adffaces/trunk/trinidad/src/site/xdoc/spec-diff.xml URL: http://svn.apache.org/viewvc/incubator/adffaces/trunk/trinidad/src/site/xdoc/spec-diff.xml?rev=429972&view=auto ============================================================================== --- incubator/adffaces/trunk/trinidad/src/site/xdoc/spec-diff.xml (added) +++ incubator/adffaces/trunk/trinidad/src/site/xdoc/spec-diff.xml Tue Aug 8 22:46:09 2006 @@ -0,0 +1,370 @@ +<?xml version="1.0" encoding="ISO-8859-1" ?> +<document> + <properties> + <title>Converting From Standard JSF Tags to Apache Trinidad Tags</title> + </properties> + + <body> + <section name="Converting From Standard JSF Tags to Apache Trinidad Tags"> + <p> + <ul> + <li> + <a href="#Overview">Overview</a> + </li> + <li> + <a href="#Getting Started">Getting Started</a> + </li> + <li> + <a href="#Differences">Differences</a> + </li> + <li> + <a href="#Additional features">Additional features</a> + </li> + + </ul> + </p> + </section> + <section name="Overview"> +<p> +Apache Trinidad includes replacements for many of the tags in the JavaServer Faces (JSF) +specification. It is important to emphasize that there is no +requirement whatsoever that you convert from standard JSF tags +to Apache Trinidad tags. Standard JSF tags and Apache Trinidad tags can be +mixed freely within a single page. In general, the Apache Trinidad tags are +more powerful, because they: +<ul> +<li>Often offer more features than the standard tags</li> +<li>Can be used inside of the <code><tr:forEach></code> tag (it is, +unfortunately, not possible to support standard tags inside +<code><tr:forEach></code>)</li> +<li>Provide more efficient implementations of client-side state saving +(reduced per-component size)</li> +</ul> +Some of the enhanced features of Apache Trinidad tags are described <a href="#Table features">below</a>. +</p> + </section> + <section name="Getting Started"> +<p> +If you're using Apache Trinidad for the first time, and you're adding ADF +Faces tags into existing JSF pages, you'll need to know a few tips +to get everything working correctly. +</p> +<p> +First, Apache Trinidad needs its stylesheet in each page to look correct. You +should replace <HTML>, <HEAD>, and <BODY> tag +with our <tr:document> tag which creates these standard root elements as well as +includes our stylesheet in the page. +</p> +<p> +Second, if you call the Javascript <code>form.submit()</code> +function, you'll bypass the Apache Trinidad support for client-side +validation. Use the "autoSubmit" property on our input components or use the +command components. +</p> + + </section> + <section name="Differences"> +<p> +Unless noted, the Apache Trinidad tag name is the same as the standard JSF tag with the exception of the prefix. Apache Trinidad tags use the prefix 'tr'. For example, <code><h:commandButton></code> is <code><tr:commandButton></code> in Apache Trinidad.</p> +<p> +The following list shows some of the common h: attributes and how they map to tr: attributes: +<ul> +<li><code>accesskey</code> - use <code>accessKey</code> </li> +<li><code>readonly</code> - use <code>readOnly</code> </li> +<li><code>alt</code> and/or <code>title</code> - use <code>shortDesc</code> </li> +<li><code>style</code> - use <code>inlineStyle</code> </li> +<li><code>dir</code>, <code>lang</code>, <code>tabindex</code> - n/a</li> +</ul> +The following table shows the standard JSF tags and how they map to Apache Trinidad tags. +</p> +<table> +<tr> +<th>Standard JSF tag</th><th>Apache Trinidad tag</th><th>Attribute Mapping/Notes</th> +</tr> + +<tr><td><code> +<h:column></code></td> +<td><code><tr:column></code></td> +<td>The <code>tr:column</code> must be the immediate child of <code>tr:table</code>. See the +<a href="#Table features">Table features </a>section below. +</td></tr> + +<tr><td><code> +<h:commandButton> </code></td> +<td><code><tr:commandButton> or <tr:resetButton> or <tr:objectImage></code></td> +<td> +<div><code><b>value - use text</b></code></div> +<div><code>type = "reset", use <tr:resetButton> tag</code></div> +<div><code>image - use <tr:objectImage> tag</code></div> +<div><code>onblur, onchange, onfocus, readonly - n/a.</code></div> +</td></tr> + +<tr><td><code> +<h:commandLink> </code></td> +<td><code><tr:commandLink> </code></td> +<td> +<div><code><b>value - use text</b></code></div> +<div><code>charset, coords, hrefrel, rev, shape - n/a.</code></div> +</td></tr> + +<tr><td><code> +<h:dataTable> </code></td> +<td><code><tr:table></code></td> + <td><code><b>see the <a href="#Table features">Table features </a>section below.</b> +</code></td></tr> + +<tr><td><code><h:form></code></td> +<td><code><tr:form></code></td> +<td><code> +<div><code><b>enctype="multipart/form-data", use usesUpload="true"</b></code></div> +<div><code><b><a href="#NotANamingContainer">Not a NamingContainer</a></b></code></div> +<div><code>target - use targetFrame</code></div> +<div><code>accept, acceptcharset, endtype onreset - n/a.</code></div> + +</code></td></tr> + +<tr><td><code> +<h:graphicImage> </code></td> +<td><code><tr:objectImage></code></td> +<td><code> +<div><code><b>value or url - use source</b></code></div> +<div><code>ismap - use imageMapType="server"</code></div> +<div><code>longdesc - use longDescURL </code></div> +<div><code>usemap - n/a.</code></div> +</code></td></tr> + +<tr><td><code><h:inputHidden></code></td> +<td><code><tr:inputHidden></code></td> +<td><code> +<div><code>required - n/a</code></div> +</code></td></tr> + +<tr><td><code> +<h:inputSecret> </code></td> +<td><code><tr:inputText></code></td> +<td><code> +<div><code><b>set tr:inputText's "secret" attribute to true</b></code></div> +<div><code>maxlength - use maximumLength</code></div> +<div><code>size - use columns</code></div> +<div><code>redisplay - n/a.</code></div> +</code></td></tr> + +<tr><td><code> +<h:inputText></code></td> +<td><code><tr:inputText></code></td> +<td><code> +<div><code>maxlength - use maximumLength</code></div> +<div><code>size - use columns</code></div> +</code></td></tr> + +<tr><td><code> +<h:inputTextarea> </code></td> +<td><code><tr:inputText></code></td> +<td><code> +<div><code><b>set the tr:inputText's "rows" attribute to the desired number of rows > 1</b></code></div> +<div><code>cols - use columns</code></div> + +</code></td></tr> + +<tr><td><code> +<h:message></code></td> +<td><code><tr:message></code></td> +<td><code>showDetail, showSummary, xyzClass, xyzStyle, tooltip - n/a +</code></td></tr> + +<tr><td><code> +<h:messages></code></td> +<td><code><tr:messages></code></td> +<td><code>globalOnly, showDetail, showSummary, xyzClass, xyzStyle, layout, tooltip - n/a +</code></td></tr> + +<tr><td><code> +<h:outputFormat> </code></td> +<td><code><i> no tr: equivalent</i> +</code></td><td><br/></td></tr> + +<tr><td><code> +<h:outputLabel> </code></td> +<td><code><tr:outputLabel></code></td> +<td><code> +<div><code>onblur, onfocus - n/a.</code></div> +</code></td></tr> + +<tr><td><code> +<h:outputLink> </code></td> +<td><code><tr:goLink></code></td> +<td><code> +<div><code><b>value - use destination</b></code></div> +<div><code><b>use text for the link's text</b></code></div> +<div><code>target - use targetFrame</code></div> +<div><code>converter, charset, coords,hrefrel, rev, shape, type - n/a.</code></div> +</code></td></tr> + +<tr><td><code> +<h:outputText> </code></td> +<td><code><tr:outputText></code></td> +<td><br/></td></tr> + +<tr><td><code> +<h:panelGrid> </code></td><td><code><i> no tr: equivalent</i> +</code></td><td><br/></td></tr> + +<tr><td><code> +<h:panelGroup></code></td> +<td><code><tr:panelGroup></code></td> +<td><br/></td></tr> + +<tr><td><code> +<h:selectBooleanCheckbox></code></td> +<td><code><tr:selectBooleanCheckbox></code></td> +<td><br/></td></tr> + +<tr><td><code> +<h:selectManyCheckbox></code></td> +<td><code><tr:selectManyCheckbox></code></td> +<td> +<div><code><b>layout - "vertical" and "horizontal" instead of "pageDirection" and "lineDirection"; also, the default is vertical, not horizontal</b></code></div> +</td></tr> + +<tr><td><code> +<h:selectManyListbox></code></td> +<td><code><tr:selectManyListbox></code></td> +<td><br/></td></tr> + +<tr><td><code> +<h:selectManyMenu> </code></td> +<td><code><tr:selectManyListbox></code></td> +<td><br/></td></tr> + +<tr><td><code> +<h:selectOneListbox></code></td> +<td><code><tr:selectOneListbox></code></td> +<td><br/></td></tr> + +<tr><td><code> +<h:selectOneMenu> </code></td> +<td><code><tr:selectOneChoice></code></td> +<td><br/></td></tr> + +<tr><td><code> +<h:selectOneRadio> </code></td> +<td><code><tr:selectOneRadio></code></td> +<td> +<div><code>border, disabledClass, enabledClass, layout - n/a.</code></div> +</td></tr> +</table> +<p> +<a name="NotANamingContainer"></a>The ADF <code><tr:form></code> +component does not implement the JSF <code>NamingContainer</code> API. +When you use the <code><tr:form></code> tag, the ID in the generated HTML does not +include the form's ID as a prefix. For example: +<source> + <h:form id="foo"> + <!-- This inputText will have an id of "foo:bar" --> + <tr:inputText id="bar"/> + </h:form> + + <tr:form id="foo2"> + <!-- This inputText will have an id of just "bar2" --> + <tr:inputText id="bar2"/> + </tr:form> +</source> + +This makes it easier to write JavaScript (and results in smaller, more +concise HTML) - especially in cases where you may not know the ID of +the form - and enables the use of some CSS features on these fields. +On the other hand, this means that pages using multiple forms cannot +reuse IDs among forms. You can use the <code><f:subview></code> tag around +an <code><tr:form></code> if you need to reuse ID values, or you can just +continue using <code><h:form></code>. + +</p> + </section> + <section name="Additional features"> +<p>As mentioned earlier, the Apache Trinidad tags offer some general features +that are not available with the standard JSF tags - such as <code><tr:forEach></code> support +and more efficient (smaller) client-side state saving. There are +many other features supported by the Apache Trinidad tags and components that are +not supported by the standard JSF tags. It'd take too much +space to discuss all of these features, but a couple of the more important +ones are discussed here.</p> +<subsection name="Label and message support"> +<p>Apache Trinidad input components make it much easier to support the +standard label-and-message pattern for laying out forms. Typically, +a JSF page might contain content like:</p> +<source> + <h:panelGrid columns="2"> + <!-- Use outputLabel; outputText doesn't support accessibility --> + <h:outputLabel for="nameInput" value="Name: "> + <h:panelGroup> + <h:inputText id="nameInput" value="Enter a name"/> + <f:verbatim><br></f:verbatim> + <h:message for="nameInput"/> + </h:panelGroup> + </h:panelGrid> +</source> +<p>All the Apache Trinidad input components automate this pattern; the +single entry of:</p> +<source> + <tr:inputText label="Name:" value="Enter a name"/> +</source> +<p>...gives you all the layout of the JSF example above - automatic +label and message layout and accessibility support. +When you use a series of Apache Trinidad input components, you'll +need to line up the labels and fields. For this purpose, Apache Trinidad +provides the <code><tr:panelForm></code> layout panel that will stack +Apache Trinidad input components.</p> +<source> + <tr:panelForm> + <tr:inputText label="First name:" value="/> + <tr:inputText label="Last name:" value="/> + </tr:panelForm> +</source> +<p>If you want to use an Apache Trinidad input component, but do not +want any of these features (because you require a more flexible +layout strategy, for example, or are already providing messaging), +set the "simple" attribute to "true": +</p> +<source> + <!-- No label or messaging --> + <tr:inputText simple="true" value="Enter a name"/> +</source> +</subsection> +<subsection name="Table features"> +<p>The Apache Trinidad <code><tr:table></code> component (a replacement for <code><h:dataTable></code>) +adds many features, including: +<ul> +<li>Built-in support for paging through data sets</li> +<li>Support for identifying rows by key instead of by index</li> +<li>No-code support for partial-page rendering (re-rendering only the table, +not the entire page)</li> +<li>Support for sorting</li> +<li>"Single" and "multiple" selection columns</li> +</ul> +For more information, see <a href="devguide/table.html">Using Apache Trinidad Tables</a> in <em>Development Guidelines for Oracle Apache Trinidad Applications</em>. +</p> +</subsection> +<subsection name="Message customization"> +<p>In Apache Trinidad, for error messages that are reported for cases of invalid input for + editable components, during conversion and validation can be customized for + every converter or validator. This also applies to "required" validation on all input + components.</p> + <source> + <tr:selectInputDate id="mdf6" value="2004/09/06" + label="Date of birth" + tip="1/20/1972 or 1972/20/2"> + + <tr:convertDateTime + secondaryPattern="d/M/yyyy" pattern="yyyy/M/d" + convertDateMessageDetail="&quot;{0}&quot; in &quot;{1}&quot; + is not a valid date. Example: &quot;{4}&quot;/> + + </tr:selectInputDate> + </source> + <p>For a invalid input value say 2004/15/1 - It would result in error message:<br/> + "2004/15/1" in "Date of birth" is not a valid date. Example: "2005/11/29".</p> + +</subsection> + </section> + </body> +</document> Added: incubator/adffaces/trunk/trinidad/trinidad-api/src/site/site.xml URL: http://svn.apache.org/viewvc/incubator/adffaces/trunk/trinidad/trinidad-api/src/site/site.xml?rev=429972&view=auto ============================================================================== --- incubator/adffaces/trunk/trinidad/trinidad-api/src/site/site.xml (added) +++ incubator/adffaces/trunk/trinidad/trinidad-api/src/site/site.xml Tue Aug 8 22:46:09 2006 @@ -0,0 +1,20 @@ +<?xml version="1.0" encoding="ISO-8859-1"?> +<project name="Apache Incubator Trinidad Podling"> + <bannerLeft> + <name>Apache Incubator Trinidad Podling API</name> + </bannerLeft> + <body> + <links> + <item name="MyFaces" href="http://myfaces.apache.org/"/> + </links> + + <menu name=""> + <item name="Javadoc" href="apidocs/index.html" /> + <item name="Tag Documentation" href="tagdoc.html" /> + </menu> + + <menu ref="parent"/> + <menu ref="modules"/> + <menu ref="reports"/> + </body> +</project> Added: incubator/adffaces/trunk/trinidad/trinidad-demo/src/site/site.xml URL: http://svn.apache.org/viewvc/incubator/adffaces/trunk/trinidad/trinidad-demo/src/site/site.xml?rev=429972&view=auto ============================================================================== --- incubator/adffaces/trunk/trinidad/trinidad-demo/src/site/site.xml (added) +++ incubator/adffaces/trunk/trinidad/trinidad-demo/src/site/site.xml Tue Aug 8 22:46:09 2006 @@ -0,0 +1,15 @@ +<?xml version="1.0" encoding="ISO-8859-1"?> +<project name="Apache Incubator Trinidad Podling"> + <bannerLeft> + <name>Apache Incubator Trinidad Podling Demo</name> + </bannerLeft> + <body> + <links> + <item name="MyFaces" href="http://myfaces.apache.org/"/> + </links> + + <menu ref="parent"/> + <menu ref="modules"/> + <menu ref="reports"/> + </body> +</project> Added: incubator/adffaces/trunk/trinidad/trinidad-impl/src/site/site.xml URL: http://svn.apache.org/viewvc/incubator/adffaces/trunk/trinidad/trinidad-impl/src/site/site.xml?rev=429972&view=auto ============================================================================== --- incubator/adffaces/trunk/trinidad/trinidad-impl/src/site/site.xml (added) +++ incubator/adffaces/trunk/trinidad/trinidad-impl/src/site/site.xml Tue Aug 8 22:46:09 2006 @@ -0,0 +1,15 @@ +<?xml version="1.0" encoding="ISO-8859-1"?> +<project name="Apache Incubator Trinidad Podling"> + <bannerLeft> + <name>Apache Incubator Trinidad Podling Implementation</name> + </bannerLeft> + <body> + <links> + <item name="MyFaces" href="http://myfaces.apache.org/"/> + </links> + + <menu ref="parent"/> + <menu ref="modules"/> + <menu ref="reports"/> + </body> +</project>
