incubator-adffaces-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From awi...@apache.org
Subject svn commit: r429972 [4/4] - in /incubator/adffaces/trunk/trinidad: src/ src/site/ src/site/xdoc/ src/site/xdoc/devguide/ trinidad-api/src/site/ trinidad-demo/src/site/ trinidad-impl/src/site/
Date Wed, 09 Aug 2006 05:46:10 GMT
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:adffaces_user@incubator.apache.org">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>&lt;tr:forEach&gt;</code> tag
(it is,
+unfortunately, not possible to support standard tags inside
+<code>&lt;tr:forEach&gt;</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 &lt;HTML&gt;, &lt;HEAD&gt;, and &lt;BODY&gt; tag 
+with our &lt;tr:document&gt; 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>&lt;h:commandButton&gt;</code>
is <code>&lt;tr:commandButton&gt;</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>
+&lt;h:column&gt;</code></td>
+<td><code>&lt;tr:column&gt;</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>
+&lt;h:commandButton&gt; </code></td>
+<td><code>&lt;tr:commandButton&gt; or &lt;tr:resetButton&gt;
or &lt;tr:objectImage&gt;</code></td>
+<td>
+<div><code><b>value - use text</b></code></div>
+<div><code>type = "reset", use &lt;tr:resetButton&gt; tag</code></div>
+<div><code>image - use &lt;tr:objectImage&gt; tag</code></div>
+<div><code>onblur, onchange, onfocus, readonly - n/a.</code></div>
+</td></tr>
+
+<tr><td><code>
+&lt;h:commandLink&gt;  </code></td>
+<td><code>&lt;tr:commandLink&gt;  </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>
+&lt;h:dataTable&gt; </code></td>
+<td><code>&lt;tr:table&gt;</code></td>
+  <td><code><b>see the <a href="#Table features">Table features </a>section
below.</b>
+</code></td></tr>
+
+<tr><td><code>&lt;h:form&gt;</code></td>
+<td><code>&lt;tr:form&gt;</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>
+&lt;h:graphicImage&gt; </code></td>
+<td><code>&lt;tr:objectImage&gt;</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>&lt;h:inputHidden&gt;</code></td>
+<td><code>&lt;tr:inputHidden&gt;</code></td>
+<td><code>
+<div><code>required - n/a</code></div>
+</code></td></tr>
+
+<tr><td><code>
+&lt;h:inputSecret&gt; </code></td>
+<td><code>&lt;tr:inputText&gt;</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>
+&lt;h:inputText&gt;</code></td>
+<td><code>&lt;tr:inputText&gt;</code></td>
+<td><code>
+<div><code>maxlength - use maximumLength</code></div>
+<div><code>size - use columns</code></div>
+</code></td></tr>
+
+<tr><td><code>
+&lt;h:inputTextarea&gt; </code></td>
+<td><code>&lt;tr:inputText&gt;</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>
+&lt;h:message&gt;</code></td>
+<td><code>&lt;tr:message&gt;</code></td>
+<td><code>showDetail, showSummary, xyzClass, xyzStyle, tooltip - n/a
+</code></td></tr>
+
+<tr><td><code>
+&lt;h:messages&gt;</code></td>
+<td><code>&lt;tr:messages&gt;</code></td>
+<td><code>globalOnly, showDetail, showSummary, xyzClass, xyzStyle, layout, tooltip
- n/a
+</code></td></tr>
+
+<tr><td><code>
+&lt;h:outputFormat&gt; </code></td>
+<td><code><i> no tr: equivalent</i>
+</code></td><td><br/></td></tr>
+
+<tr><td><code>
+&lt;h:outputLabel&gt; </code></td>
+<td><code>&lt;tr:outputLabel&gt;</code></td>
+<td><code>
+<div><code>onblur, onfocus - n/a.</code></div>
+</code></td></tr>
+
+<tr><td><code>
+&lt;h:outputLink&gt; </code></td>
+<td><code>&lt;tr:goLink&gt;</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>
+&lt;h:outputText&gt; </code></td>
+<td><code>&lt;tr:outputText&gt;</code></td>
+<td><br/></td></tr>
+
+<tr><td><code>
+&lt;h:panelGrid&gt; </code></td><td><code><i> no tr:
equivalent</i>
+</code></td><td><br/></td></tr> 
+
+<tr><td><code>
+&lt;h:panelGroup&gt;</code></td>
+<td><code>&lt;tr:panelGroup&gt;</code></td>
+<td><br/></td></tr>
+
+<tr><td><code>
+&lt;h:selectBooleanCheckbox&gt;</code></td>
+<td><code>&lt;tr:selectBooleanCheckbox&gt;</code></td>
+<td><br/></td></tr>
+
+<tr><td><code>
+&lt;h:selectManyCheckbox&gt;</code></td>
+<td><code>&lt;tr:selectManyCheckbox&gt;</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>
+&lt;h:selectManyListbox&gt;</code></td>
+<td><code>&lt;tr:selectManyListbox&gt;</code></td>
+<td><br/></td></tr>
+
+<tr><td><code>
+&lt;h:selectManyMenu&gt; </code></td>
+<td><code>&lt;tr:selectManyListbox&gt;</code></td>
+<td><br/></td></tr>
+
+<tr><td><code>
+&lt;h:selectOneListbox&gt;</code></td>
+<td><code>&lt;tr:selectOneListbox&gt;</code></td>
+<td><br/></td></tr>
+
+<tr><td><code>
+&lt;h:selectOneMenu&gt; </code></td>
+<td><code>&lt;tr:selectOneChoice&gt;</code></td>
+<td><br/></td></tr>
+
+<tr><td><code>
+&lt;h:selectOneRadio&gt; </code></td>
+<td><code>&lt;tr:selectOneRadio&gt;</code></td>
+<td>
+<div><code>border, disabledClass, enabledClass, layout - n/a.</code></div>
+</td></tr>
+</table>
+<p>
+<a name="NotANamingContainer"></a>The ADF <code>&lt;tr:form&gt;</code>
+component does not implement the JSF <code>NamingContainer</code> API.
+When you use the <code>&lt;tr:form&gt;</code> tag, the ID in the generated
HTML does not
+include the form's ID as a prefix.  For example:
+<source>
+  &lt;h:form id="foo"&gt;
+   &lt;!-- This inputText will have an id of "foo:bar" --&gt;
+   &lt;tr:inputText id="bar"/&gt;
+  &lt;/h:form&gt;
+
+  &lt;tr:form id="foo2"&gt;
+   &lt;!-- This inputText will have an id of just "bar2" --&gt;
+   &lt;tr:inputText id="bar2"/&gt;
+  &lt;/tr:form&gt;
+</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>&lt;f:subview&gt;</code>
tag around
+an <code>&lt;tr:form&gt;</code> if you need to reuse ID values, or you
can just
+continue using <code>&lt;h:form&gt;</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>&lt;tr:forEach&gt;</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>
+  &lt;h:panelGrid columns="2"&gt;
+   &lt;!-- Use outputLabel; outputText doesn't support accessibility --&gt;
+   &lt;h:outputLabel for="nameInput" value="Name:  "&gt;
+   &lt;h:panelGroup&gt;
+     &lt;h:inputText id="nameInput" value="Enter a name"/&gt;
+     &lt;f:verbatim&gt;&lt;br&gt;&lt;/f:verbatim&gt;
+     &lt;h:message for="nameInput"/&gt;
+   &lt;/h:panelGroup&gt;
+ &lt;/h:panelGrid&gt;
+</source>
+<p>All the Apache Trinidad input components automate this pattern; the
+single entry of:</p>
+<source>
+  &lt;tr:inputText label="Name:" value="Enter a name"/&gt;
+</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>&lt;tr:panelForm&gt;</code> layout panel that will
stack
+Apache Trinidad input components.</p>
+<source>
+  &lt;tr:panelForm&gt;
+    &lt;tr:inputText label="First name:" value="/&gt;
+    &lt;tr:inputText label="Last name:" value="/&gt;
+  &lt;/tr:panelForm&gt; 
+</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>
+  &lt;!-- No label or messaging --&gt;
+  &lt;tr:inputText simple="true" value="Enter a name"/&gt;
+</source>
+</subsection>
+<subsection name="Table features">
+<p>The Apache Trinidad <code>&lt;tr:table&gt;</code> component
(a replacement for <code>&lt;h:dataTable&gt;</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>
+   &lt;tr:selectInputDate id="mdf6" value="2004/09/06"
+                    label="Date of birth"
+                    tip="1/20/1972 or 1972/20/2"&gt;
+
+    &lt;tr:convertDateTime 
+           secondaryPattern="d/M/yyyy" pattern="yyyy/M/d" 
+           convertDateMessageDetail="&amp;quot;{0}&amp;quot; in &amp;quot;{1}&amp;quot;
+                                  is not a valid date. Example: &amp;quot;{4}&amp;quot;/&gt;
+                                      
+   &lt;/tr:selectInputDate&gt;
+ </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>



Mime
View raw message