META-INF.maven-faces-plugin.components.trinidad.html.HtmlTableLayout.xml Maven / Gradle / Ivy
<?xml version="1.0" encoding="utf-8"?>
<!--
Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
distributed with this work for additional information
regarding copyright ownership. The ASF licenses this file
to you under the Apache License, Version 2.0 (the
"License"); you may not use this file except in compliance
with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing,
software distributed under the License is distributed on an
"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
KIND, either express or implied. See the License for the
specific language governing permissions and limitations
under the License.
-->
<faces-config version="2.0" xmlns="http://java.sun.com/xml/ns/javaee"
xmlns:trh="http://myfaces.apache.org/trinidad/html"
xmlns:mfp="http://myfaces.apache.org/maven-faces-plugin"
xmlns:fmd="http://java.sun.com/xml/ns/javaee/faces/design-time-metadata">
<component>
<description><![CDATA[<html>
A TableLayout is a thin wrapper around the HTML <table>
element. It contains a series of row layout elements.</html>]]>
</description>
<icon>
<small-icon>/org/apache/myfaces/trinidadinternal/metadata/icons/tableLayout.gif</small-icon>
</icon>
<component-type>org.apache.myfaces.trinidad.HtmlTableLayout</component-type>
<component-class>org.apache.myfaces.trinidad.component.html.HtmlTableLayout</component-class>
<property>
<description><![CDATA[the preferred total width of the layout.]]></description>
<property-name>width</property-name>
<property-class>java.lang.String</property-class>
<property-extension>
<mfp:alternate-class>int</mfp:alternate-class>
</property-extension>
</property>
<property>
<description><![CDATA[the horizontal alignment of the table.
The acceptable values are "center", "left", "right", "start", and "end".]]>
</description>
<property-name>halign</property-name>
<property-class>java.lang.String</property-class>
<property-extension>
<fmd:property-metadata>
<fmd:property-values>right start left end center</fmd:property-values>
</fmd:property-metadata>
</property-extension>
</property>
<property>
<description><![CDATA[the spacing between cells.]]></description>
<property-name>cellSpacing</property-name>
<property-class>int</property-class>
</property>
<property>
<description><![CDATA[the spacing within cells.]]></description>
<property-name>cellPadding</property-name>
<property-class>int</property-class>
</property>
<property>
<description><![CDATA[the border width around each cell.]]></description>
<property-name>borderWidth</property-name>
<property-class>int</property-class>
</property>
<property>
<description><![CDATA[The summary of the table's purpose and structure
for user agents rendering to non-visual media. This attribute
must be set if this element is being used to implement a data
table (instead of a layout table).]]>
</description>
<property-name>summary</property-name>
<property-class>java.lang.String</property-class>
<property-extension/>
</property>
<property>
<description><![CDATA[the short description of the bean. This text
is commonly used by user agents to display tooltip help text.]]>
</description>
<property-name>shortDesc</property-name>
<property-class>java.lang.String</property-class>
<property-extension>
<mfp:property-metadata/>
<fmd:property-metadata>
<fmd:category-id>GENERAL</fmd:category-id>
</fmd:property-metadata>
</property-extension>
</property>
<property>
<description><![CDATA[the IDs of the components that should trigger a partial update.
This component will listen on the trigger components. If one of the
trigger components receives an event that will cause it to update
in some way, this component will request to be updated too.]]>
</description>
<property-name>partialTriggers</property-name>
<property-class>java.lang.String[]</property-class>
<property-extension>
<mfp:property-metadata>
<mfp:multi-scoped-id-holder>true</mfp:multi-scoped-id-holder>
</mfp:property-metadata>
</property-extension>
</property>
<property>
<description><![CDATA[an onclick Javascript handler.]]></description>
<property-name>onclick</property-name>
<property-class>java.lang.String</property-class>
<property-extension>
<mfp:property-metadata/>
<fmd:property-metadata>
<fmd:category-id>EVENTS</fmd:category-id>
</fmd:property-metadata>
</property-extension>
</property>
<property>
<description><![CDATA[an ondblclick Javascript handler.]]></description>
<property-name>ondblclick</property-name>
<property-class>java.lang.String</property-class>
<property-extension>
<mfp:property-metadata/>
<fmd:property-metadata>
<fmd:category-id>EVENTS</fmd:category-id>
</fmd:property-metadata>
</property-extension>
</property>
<property>
<description><![CDATA[an onmousedown Javascript handler.]]></description>
<property-name>onmousedown</property-name>
<property-class>java.lang.String</property-class>
<property-extension>
<mfp:property-metadata/>
<fmd:property-metadata>
<fmd:category-id>EVENTS</fmd:category-id>
</fmd:property-metadata>
</property-extension>
</property>
<property>
<description><![CDATA[an onmouseup Javascript handler.]]></description>
<property-name>onmouseup</property-name>
<property-class>java.lang.String</property-class>
<property-extension>
<mfp:property-metadata/>
<fmd:property-metadata>
<fmd:category-id>EVENTS</fmd:category-id>
</fmd:property-metadata>
</property-extension>
</property>
<property>
<description><![CDATA[an onmouseover Javascript handler.]]></description>
<property-name>onmouseover</property-name>
<property-class>java.lang.String</property-class>
<property-extension>
<mfp:property-metadata/>
<fmd:property-metadata>
<fmd:category-id>EVENTS</fmd:category-id>
</fmd:property-metadata>
</property-extension>
</property>
<property>
<description><![CDATA[an onmousemove Javascript handler.]]></description>
<property-name>onmousemove</property-name>
<property-class>java.lang.String</property-class>
<property-extension>
<mfp:property-metadata/>
<fmd:property-metadata>
<fmd:category-id>EVENTS</fmd:category-id>
</fmd:property-metadata>
</property-extension>
</property>
<property>
<description><![CDATA[an onmouseout Javascript handler.]]></description>
<property-name>onmouseout</property-name>
<property-class>java.lang.String</property-class>
<property-extension>
<mfp:property-metadata/>
<fmd:property-metadata>
<fmd:category-id>EVENTS</fmd:category-id>
</fmd:property-metadata>
</property-extension>
</property>
<property>
<description><![CDATA[an onkeypress Javascript handler.]]></description>
<property-name>onkeypress</property-name>
<property-class>java.lang.String</property-class>
<property-extension>
<mfp:property-metadata/>
<fmd:property-metadata>
<fmd:category-id>EVENTS</fmd:category-id>
</fmd:property-metadata>
</property-extension>
</property>
<property>
<description><![CDATA[an onkeydown Javascript handler.]]></description>
<property-name>onkeydown</property-name>
<property-class>java.lang.String</property-class>
<property-extension>
<mfp:property-metadata/>
<fmd:property-metadata>
<fmd:category-id>EVENTS</fmd:category-id>
</fmd:property-metadata>
</property-extension>
</property>
<property>
<description><![CDATA[an onkeyup Javascript handler.]]></description>
<property-name>onkeyup</property-name>
<property-class>java.lang.String</property-class>
<property-extension>
<mfp:property-metadata/>
<fmd:property-metadata>
<fmd:category-id>EVENTS</fmd:category-id>
</fmd:property-metadata>
</property-extension>
</property>
<property>
<description><![CDATA[the CSS style class of the bean.]]></description>
<property-name>styleClass</property-name>
<property-class>java.lang.String</property-class>
<property-extension>
<mfp:property-metadata/>
<fmd:property-metadata>
<fmd:category-id>GENERAL</fmd:category-id>
</fmd:property-metadata>
</property-extension>
</property>
<property>
<description><![CDATA[the inline CSS style for this element]]></description>
<property-name>inlineStyle</property-name>
<property-class>java.lang.String</property-class>
<property-extension>
<mfp:property-metadata/>
<fmd:property-metadata>
<fmd:category-id>GENERAL</fmd:category-id>
</fmd:property-metadata>
</property-extension>
</property>
<component-extension>
<mfp:component-family>org.apache.myfaces.trinidad.TableLayout</mfp:component-family>
<mfp:component-supertype>org.apache.myfaces.trinidad.ComponentBase</mfp:component-supertype>
<mfp:renderer-type>org.apache.myfaces.trinidad.TableLayout</mfp:renderer-type>
<mfp:tag-name>trh:tableLayout</mfp:tag-name>
<mfp:tag-class>org.apache.myfaces.trinidadinternal.taglib.html.HtmlTableLayoutTag</mfp:tag-class>
<mfp:long-description><![CDATA[A TableLayout is a thin wrapper around the HTML <table>
element. It contains a series of row layout elements.
<section name="Table Layout">
By default, HTML tables treat cell widths more like suggestions rather than requirements;
cell content sizes contribute more in determining the size of each column.
If you care more for the specified cellFormat widths than content sizes (particularly if your
cellFormat widths are percentage-based and your cells have contents that are
programmatically-resizable based on the cell width), then you will need to use
inlineStyle="table-layout:fixed" to declare that you want your cell widths to be explicitly honored.
Refer to the CSS specification for further details on this style property.
</section>]]>
</mfp:long-description>
<mfp:example>
<mfp:source-code>
<![CDATA[
<trh:tableLayout width="75%"
borderWidth="3"
cellSpacing="10"
halign="center">
<trh:rowLayout>
<!-- First Column -->
<trh:cellFormat valign="bottom" />
<!-- SecondColumn -->
</trh:cellFormat>
<tr:panelGroupLayout layout="horizontal">
<!-- Third Column -->
<tr:spacer height="100" width="1"/>
</tr:panelGroupLayout>
</trh:rowLayout>
<trh:rowLayout>
<tr:panelHeader text="Apache Trinidad Components"/>
<trh:cellFormat columnSpan="2">
<tr:panelHeader text="Faces Servlet"/>
</trh:cellFormat>
</trh:rowLayout>
</trh:tableLayout>
]]>
</mfp:source-code>
</mfp:example>
<mfp:author>Adam Winer</mfp:author>
<mfp:component-metadata/>
<mfp:java-constructor>
<mfp:property-name>width</mfp:property-name>
</mfp:java-constructor>
<fmd:component-metadata>
<fmd:default-event-name>click</fmd:default-event-name>
<fmd:event-names>click dblclick mousedown mouseup mouseover mousemove mouseout
keypress keydown keyup</fmd:event-names>
<fmd:preferred-child-components>org.apache.myfaces.trinidad.HtmlRowLayout</fmd:preferred-child-components>
<fmd:satisfied-contracts>org-apache-myfaces-trinidad-htmlrowlayout-holder</fmd:satisfied-contracts>
</fmd:component-metadata>
</component-extension>
</component>
</faces-config>