You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@myfaces.apache.org by sk...@apache.org on 2005/11/25 01:29:19 UTC
svn commit: r348838 [2/2] - in /myfaces/impl/trunk:
src/java/org/apache/myfaces/application/
src/java/org/apache/myfaces/application/jsp/
src/java/org/apache/myfaces/lifecycle/ tld/ tld/entities/
tld/entities/html_attributes/
Modified: myfaces/impl/trunk/tld/myfaces_core.tld
URL: http://svn.apache.org/viewcvs/myfaces/impl/trunk/tld/myfaces_core.tld?rev=348838&r1=348837&r2=348838&view=diff
==============================================================================
--- myfaces/impl/trunk/tld/myfaces_core.tld (original)
+++ myfaces/impl/trunk/tld/myfaces_core.tld Thu Nov 24 16:28:55 2005
@@ -34,8 +34,9 @@
<short-name>f</short-name>
<uri>http://java.sun.com/jsf/core</uri>
<description>
- JSF Core Tag Library
+ This tag library implements the standard JSF core tags.
</description>
+ <display-name>JSF core tag library.</display-name>
<!--
======================================================
@@ -56,10 +57,15 @@
<name>actionListener</name>
<tag-class>org.apache.myfaces.taglib.core.ActionListenerTag</tag-class>
<body-content>empty</body-content>
+ <description>This tag creates an instance of the specified ActionListener, and associates it with
+ the nearest parent UIComponent.
+
+ Unless otherwise specified, all attributes accept static values or EL expressions.</description>
<attribute>
<name>type</name>
<required>true</required>
<rtexprvalue>false</rtexprvalue>
+ <description>The fully qualified class name of the ActionListener class.</description>
</attribute>
</tag>
@@ -72,15 +78,21 @@
<name>attribute</name>
<tag-class>javax.faces.webapp.AttributeTag</tag-class>
<body-content>empty</body-content>
+ <description>This tag associates an attribute with
+ the nearest parent UIComponent.
+
+ Unless otherwise specified, all attributes accept static values or EL expressions.</description>
<attribute>
<name>name</name>
<required>true</required>
<rtexprvalue>false</rtexprvalue>
+ <description>The name of the attribute.</description>
</attribute>
<attribute>
<name>value</name>
<required>true</required>
<rtexprvalue>false</rtexprvalue>
+ <description>The attribute's value.</description>
</attribute>
</tag>
@@ -93,41 +105,44 @@
<name>convertDateTime</name>
<tag-class>org.apache.myfaces.taglib.core.ConvertDateTimeTag</tag-class>
<body-content>empty</body-content>
+ <description>This tag associates a date time converter with the nearest parent UIComponent.
+
+ Unless otherwise specified, all attributes accept static values or EL expressions.</description>
<attribute>
<name>dateStyle</name>
<required>false</required>
<rtexprvalue>false</rtexprvalue>
- <description>default|short|medium|long|full</description>
+ <description>The style of the date. Values include: default, short, medium, long, and full.</description>
</attribute>
<attribute>
<name>locale</name>
<required>false</required>
<rtexprvalue>false</rtexprvalue>
- <description>locale</description>
+ <description>The name of the locale to be used, instead of the default.</description>
</attribute>
<attribute>
<name>pattern</name>
<required>false</required>
<rtexprvalue>false</rtexprvalue>
- <description>Custom formatting pattern</description>
+ <description>A custom Date formatting pattern, in the format used by java.text.SimpleDateFormat.</description>
</attribute>
<attribute>
<name>timeStyle</name>
<required>false</required>
<rtexprvalue>false</rtexprvalue>
- <description>default|short|medium|long|full</description>
+ <description>The style of the time. Values include: default, short, medium, long, and full.</description>
</attribute>
<attribute>
<name>timeZone</name>
<required>false</required>
<rtexprvalue>false</rtexprvalue>
- <description>timeZone</description>
+ <description>The time zone to use, instead of the default.</description>
</attribute>
<attribute>
<name>type</name>
<required>false</required>
<rtexprvalue>false</rtexprvalue>
- <description>date|time|both</description>
+ <description>Specifies whether the date, time, or both should be parsed/formatted. Values include: date, time, and both. Default based on setting of timeStyle and dateStyle.</description>
</attribute>
</tag>
@@ -135,11 +150,13 @@
<name>converter</name>
<tag-class>javax.faces.webapp.ConverterTag</tag-class>
<body-content>empty</body-content>
+ <description>This tag creates an instance of the specified Converter, and associates it with
+ the nearest parent UIComponent.</description>
<attribute>
<name>converterId</name>
<required>true</required>
<rtexprvalue>false</rtexprvalue>
- <description>Converter identifier</description>
+ <description>The converter's registered ID.</description>
</attribute>
</tag>
@@ -147,6 +164,10 @@
<name>convertNumber</name>
<tag-class>org.apache.myfaces.taglib.core.ConvertNumberTag</tag-class>
<body-content>empty</body-content>
+ <description>This tag creates a number formatting converter and associates it with the
+ nearest parent UIComponent.
+
+ Unless otherwise specified, all attributes accept static values or EL expressions.</description>
<attribute>
<name>currencyCode</name>
<required>false</required>
@@ -157,61 +178,61 @@
<name>currencySymbol</name>
<required>false</required>
<rtexprvalue>false</rtexprvalue>
- <description>Currency symbol</description>
+ <description>The currency symbol used to format a currency value. Defaults to the currency symbol for locale.</description>
</attribute>
<attribute>
<name>groupingUsed</name>
<required>false</required>
<rtexprvalue>false</rtexprvalue>
- <description>Specifies whether output will contain grouping separators</description>
+ <description>Specifies whether output will contain grouping separators. Default: true.</description>
</attribute>
<attribute>
<name>integerOnly</name>
<required>false</required>
<rtexprvalue>false</rtexprvalue>
- <description>Specifies whether only integer part will be parsed</description>
+ <description>Specifies whether only the integer part of the input will be parsed. Default: false.</description>
</attribute>
<attribute>
<name>locale</name>
<required>false</required>
<rtexprvalue>false</rtexprvalue>
- <description>Locale</description>
+ <description>The name of the locale to be used, instead of the default as specified in the faces configuration file.</description>
</attribute>
<attribute>
<name>maxFractionDigits</name>
<required>false</required>
<rtexprvalue>false</rtexprvalue>
- <description>Maximum number of digits in fractional portion</description>
+ <description>The maximum number of digits in the fractional portion of the number.</description>
</attribute>
<attribute>
<name>maxIntegerDigits</name>
<required>false</required>
<rtexprvalue>false</rtexprvalue>
- <description>Maximum number of digits in integer portion</description>
+ <description>The maximum number of digits in the integer portion of the number.</description>
</attribute>
<attribute>
<name>minFractionDigits</name>
<required>false</required>
<rtexprvalue>false</rtexprvalue>
- <description>Minimum number of digits in fractional portion</description>
+ <description>The minimum number of digits in the fractional portion of the number.</description>
</attribute>
<attribute>
<name>minIntegerDigits</name>
<required>false</required>
<rtexprvalue>false</rtexprvalue>
- <description>Minimum number of digits in integer portion</description>
+ <description>The minimum number of digits in the integer portion of the number.</description>
</attribute>
<attribute>
<name>pattern</name>
<required>false</required>
<rtexprvalue>false</rtexprvalue>
- <description>Custom formatting pattern</description>
+ <description>A custom Date formatting pattern, in the format used by java.text.SimpleDateFormat.</description>
</attribute>
<attribute>
<name>type</name>
<required>false</required>
<rtexprvalue>false</rtexprvalue>
- <description>number|currency|percentage</description>
+ <description>The type of formatting/parsing to be performed. Values include: number, currency, and percentage. Default: number.</description>
</attribute>
</tag>
@@ -225,11 +246,15 @@
<name>facet</name>
<tag-class>javax.faces.webapp.FacetTag</tag-class>
<body-content>JSP</body-content>
+ <description>This tag adds its child as a facet of the nearest parent UIComponent. A child consisting of multiple elements should
+ be nested within a container component (i.e., within an h:panelGroup for HTML library components).
+
+ Unless otherwise specified, all attributes accept static values or EL expressions.</description>
<attribute>
<name>name</name>
<required>true</required>
<rtexprvalue>false</rtexprvalue>
- <description>Name of the facet to be created.</description>
+ <description>The name of the facet to be created. This must be a static value.</description>
</attribute>
</tag>
@@ -242,15 +267,20 @@
<name>loadBundle</name>
<tag-class>org.apache.myfaces.taglib.core.LoadBundleTag</tag-class>
<body-content>empty</body-content>
+ <description>Loads a resource bundle and saves it as a variable in the request scope.
+
+ Unless otherwise specified, all attributes accept static values or EL expressions.</description>
<attribute>
<name>basename</name>
<required>true</required>
<rtexprvalue>false</rtexprvalue>
+ <description>The base name of the resource bundle.</description>
</attribute>
<attribute>
<name>var</name>
<required>true</required>
<rtexprvalue>false</rtexprvalue>
+ <description>The name of the variable in request scope that the resources are saved to. This must be a static value.</description>
</attribute>
</tag>
@@ -263,6 +293,9 @@
<name>param</name>
<tag-class>org.apache.myfaces.taglib.core.ParamTag</tag-class>
<body-content>empty</body-content>
+ <description>This tag associates a parameter name-value pair with the nearest parent UIComponent.
+
+ Unless otherwise specified, all attributes accept static values or EL expressions.</description>
&ui_parameter_attributes;
</tag>
@@ -275,6 +308,9 @@
<name>selectItem</name>
<tag-class>org.apache.myfaces.taglib.core.SelectItemTag</tag-class>
<body-content>empty</body-content>
+ <description>This tag creates a selection list item, and associates it with the nearest parent UIComponent.
+
+ Unless otherwise specified, all attributes accept static values or EL expressions.</description>
&ui_select_item_attributes;
</tag>
@@ -287,6 +323,9 @@
<name>selectItems</name>
<tag-class>org.apache.myfaces.taglib.core.SelectItemsTag</tag-class>
<body-content>empty</body-content>
+ <description>This tag associates a set of selection list items with the nearest parent UIComponent.
+
+ Unless otherwise specified, all attributes accept static values or EL expressions.</description>
&ui_select_items_attributes;
</tag>
@@ -299,27 +338,33 @@
<name>subview</name>
<tag-class>org.apache.myfaces.taglib.core.SubviewTag</tag-class>
<body-content>JSP</body-content>
- <!-- attribute id is required! -->
+ <description>This tag associates a set of UIComponents with the nearest parent UIComponent. It acts as
+ a naming container to make the IDs of its component elements unique.
+
+ Unless otherwise specified, all attributes accept static values or EL expressions.</description>
<attribute>
- <name>id</name>
- <required>true</required>
- <rtexprvalue>false</rtexprvalue>
- <type>java.lang.String</type>
- <description>Every component may have an unique id. Automatically created if omitted.</description>
+ <name>id</name>
+ <required>true</required>
+ <rtexprvalue>false</rtexprvalue>
+ <type>java.lang.String</type>
+ <description>The developer-assigned ID of this component. The ID must be unique within the scope of the tag's
+ enclosing naming container (e.g., h:form or f:subview). This value must be a static value.
+ </description>
</attribute>
<attribute>
- <name>binding</name>
+ <name>rendered</name>
<required>false</required>
<rtexprvalue>false</rtexprvalue>
<type>java.lang.String</type>
- <description>Component binding.</description>
+ <description>A boolean value that indicates whether this component should be rendered. Default: true.</description>
</attribute>
<attribute>
- <name>rendered</name>
- <required>false</required>
- <rtexprvalue>false</rtexprvalue>
- <type>java.lang.String</type>
- <description>If false, this component will not be rendered.</description>
+ <name>binding</name>
+ <required>false</required>
+ <rtexprvalue>false</rtexprvalue>
+ <type>java.lang.String</type>
+ <description>Identifies a backing bean property, of type UIComponent,
+ to bind to this component instance. This value must be a static value.</description>
</attribute>
</tag>
@@ -332,6 +377,12 @@
<name>validateDoubleRange</name>
<tag-class>org.apache.myfaces.taglib.core.ValidateDoubleRangeTag</tag-class>
<body-content>empty</body-content>
+ <description>Creates a validator and associateds it with the nearest parent UIComponent. When invoked,
+ the validator ensures that values are valid doubles that lie within the minimum and maximum values specified.
+
+ Commonly associated with a h:inputText entity.
+
+ Unless otherwise specified, all attributes accept static values or EL expressions.</description>
&validator_min_max_attributes;
</tag>
@@ -339,6 +390,12 @@
<name>validateLength</name>
<tag-class>org.apache.myfaces.taglib.core.ValidateLengthTag</tag-class>
<body-content>empty</body-content>
+ <description>Creates a validator and associateds it with the nearest parent UIComponent. When invoked,
+ the validator ensures that values are valid strings with a length that lies within the minimum and maximum values specified.
+
+ Commonly associated with a h:inputText entity.
+
+ Unless otherwise specified, all attributes accept static values or EL expressions.</description>
&validator_min_max_attributes;
</tag>
@@ -346,6 +403,12 @@
<name>validateLongRange</name>
<tag-class>org.apache.myfaces.taglib.core.ValidateLongRangeTag</tag-class>
<body-content>empty</body-content>
+ <description>Creates a validator and associateds it with the nearest parent UIComponent. When invoked,
+ the validator ensures that values are valid longs that lie within the minimum and maximum values specified.
+
+ Commonly associated with a h:inputText entity.
+
+ Unless otherwise specified, all attributes accept static values or EL expressions.</description>
&validator_min_max_attributes;
</tag>
@@ -353,11 +416,18 @@
<name>validator</name>
<tag-class>javax.faces.webapp.ValidatorTag</tag-class>
<body-content>empty</body-content>
+ <description>Creates a validator and associateds it with the nearest parent UIComponent. The specified
+ custom validator is invoked to test the validity of the UIComponent's value.
+
+ Commonly associated with a h:inputText entity.
+
+ Unless otherwise specified, all attributes accept static values or EL expressions.</description>
<attribute>
<name>validatorId</name>
<required>false</required>
<rtexprvalue>false</rtexprvalue>
<type>java.lang.String</type>
+ <description>The registered ID of the desired Validator.</description>
</attribute>
</tag>
@@ -370,10 +440,14 @@
<name>valueChangeListener</name>
<tag-class>org.apache.myfaces.taglib.core.ValueChangeListenerTag</tag-class>
<body-content>empty</body-content>
+ <description>Adds the specified ValueChangeListener to the nearest parent UIComponent.
+
+ Unless otherwise specified, all attributes accept static values or EL expressions.</description>
<attribute>
<name>type</name>
<required>true</required>
<rtexprvalue>false</rtexprvalue>
+ <description>The name of a Java class that implements ValueChangeListener.</description>
</attribute>
</tag>
@@ -386,11 +460,14 @@
<name>verbatim</name>
<tag-class>org.apache.myfaces.taglib.core.VerbatimTag</tag-class>
<body-content>JSP</body-content>
+ <description>Outputs its body as verbatim text.
+
+ Unless otherwise specified, all attributes accept static values or EL expressions.</description>
<attribute>
<name>escape</name>
<required>false</required>
<rtexprvalue>false</rtexprvalue>
- <description>If true, generated markup is escaped.</description>
+ <description>If true, generated markup is escaped. Default: false.</description>
</attribute>
</tag>
@@ -403,10 +480,14 @@
<name>view</name>
<tag-class>org.apache.myfaces.taglib.core.ViewTag</tag-class>
<body-content>JSP</body-content>
+ <description>Creates a JSF View, which is a container that holds all of the components that are part of the view.
+
+ Unless otherwise specified, all attributes accept static values or EL expressions.</description>
<attribute>
<name>locale</name>
<required>false</required>
<rtexprvalue>false</rtexprvalue>
+ <description>The locale of this view. Default: the default locale from the configuration file.</description>
</attribute>
</tag>
Modified: myfaces/impl/trunk/tld/myfaces_html.tld
URL: http://svn.apache.org/viewcvs/myfaces/impl/trunk/tld/myfaces_html.tld?rev=348838&r1=348837&r2=348838&view=diff
==============================================================================
--- myfaces/impl/trunk/tld/myfaces_html.tld (original)
+++ myfaces/impl/trunk/tld/myfaces_html.tld Thu Nov 24 16:28:55 2005
@@ -33,6 +33,22 @@
<!ENTITY html_table_attributes SYSTEM "entities/html_table_attributes.xml">
<!ENTITY html_textarea_attributes SYSTEM "entities/html_textarea_attributes.xml">
<!ENTITY html_universal_attributes SYSTEM "entities/html_universal_attributes.xml">
+<!ENTITY html_accesskey_attribute SYSTEM "entities/html_attributes/accesskey.xml">
+<!ENTITY html_align_attribute SYSTEM "entities/html_attributes/align.xml">
+<!ENTITY html_alt_attribute SYSTEM "entities/html_attributes/alt.xml">
+<!ENTITY html_bgcolor_attribute SYSTEM "entities/html_attributes/bgcolor.xml">
+<!ENTITY html_border_attribute SYSTEM "entities/html_attributes/border.xml">
+<!ENTITY html_charset_attribute SYSTEM "entities/html_attributes/charset.xml">
+<!ENTITY html_datafld_datasrc_dataformatas_attributes SYSTEM "entities/html_attributes/datafld_datasrc_dataformatas.xml">
+<!ENTITY html_disabled_attribute SYSTEM "entities/html_attributes/disabled.xml">
+<!ENTITY html_focus_blur_attributes SYSTEM "entities/html_attributes/focus_blur.xml">
+<!ENTITY html_onchange_attribute SYSTEM "entities/html_attributes/onchange.xml">
+<!ENTITY html_onselect_attribute SYSTEM "entities/html_attributes/onselect.xml">
+<!ENTITY html_readonly_attribute SYSTEM "entities/html_attributes/readonly.xml">
+<!ENTITY html_tabindex_attribute SYSTEM "entities/html_attributes/tabindex.xml">
+<!ENTITY html_target_attribute SYSTEM "entities/html_attributes/target.xml">
+<!ENTITY html_type_attribute SYSTEM "entities/html_attributes/type.xml">
+
<!ENTITY ui_column_attributes SYSTEM "entities/ui_column_attributes.xml">
<!ENTITY ui_command_attributes SYSTEM "entities/ui_command_attributes.xml">
<!ENTITY ui_component_attributes SYSTEM "entities/ui_component_attributes.xml">
@@ -48,6 +64,7 @@
<!ENTITY ui_select_boolean_attributes SYSTEM "entities/ui_select_boolean_attributes.xml">
<!ENTITY ui_select_many_attributes SYSTEM "entities/ui_select_many_attributes.xml">
<!ENTITY ui_select_one_attributes SYSTEM "entities/ui_select_one_attributes.xml">
+<!ENTITY ui_table_renderer_attributes SYSTEM "entities/ui_table_renderer_attributes.xml">
<!ENTITY standard_command_button_attributes SYSTEM "entities/standard_command_button_attributes.xml">
<!ENTITY standard_command_link_attributes SYSTEM "entities/standard_command_link_attributes.xml">
<!ENTITY standard_data_table_attributes SYSTEM "entities/standard_data_table_attributes.xml">
@@ -75,9 +92,9 @@
<short-name>h</short-name>
<uri>http://java.sun.com/jsf/html</uri>
<description>
- Tag library for the MyFaces basic implementation.
+ This tag library implements the standard JSF HTML tags.
</description>
-
+ <display-name>JSF HTML tag library.</display-name>
<!--
*************************************************************************************
@@ -90,6 +107,11 @@
<name>column</name>
<tag-class>org.apache.myfaces.taglib.html.HtmlColumnTag</tag-class>
<body-content>JSP</body-content>
+ <description>This tag is commonly used as a child of the dataTable tag, to represent a column of data.
+ It can be decorated with "header" and "footer" facets to drive the output of header and footer
+ rows. Row values are specified via its children.
+
+ Unless otherwise specified, all attributes accept static values or EL expressions.</description>
&ui_component_attributes;
</tag>
@@ -98,6 +120,9 @@
<name>commandButton</name>
<tag-class>org.apache.myfaces.taglib.html.HtmlCommandButtonTag</tag-class>
<body-content>JSP</body-content>
+ <description>This tag renders as an HTML input element.
+
+ Unless otherwise specified, all attributes accept static values or EL expressions.</description>
&standard_command_button_attributes;
</tag>
@@ -106,6 +131,11 @@
<name>commandLink</name>
<tag-class>org.apache.myfaces.taglib.html.HtmlCommandLinkTag</tag-class>
<body-content>JSP</body-content>
+ <description>
+ This tag renders as an HTML a element.
+
+ Unless otherwise specified, all attributes accept static values or EL expressions.
+ </description>
&standard_command_link_attributes;
</tag>
@@ -114,6 +144,10 @@
<name>dataTable</name>
<tag-class>org.apache.myfaces.taglib.html.HtmlDataTableTag</tag-class>
<body-content>JSP</body-content>
+ <description>This component renders as an HTML table element. It has as its children h:column entities, which
+ describe the columns of the table. It can be decorated with facets named "header" and "footer" to specify header and footer rows.
+
+ Unless otherwise specified, all attributes accept static values or EL expressions.</description>
&standard_data_table_attributes;
</tag>
@@ -123,7 +157,9 @@
<tag-class>org.apache.myfaces.taglib.html.HtmlFormTag</tag-class>
<body-content>JSP</body-content>
<description>
- Renders a HTML form element.
+ Renders an HTML form element.
+
+ Unless otherwise specified, all attributes accept static values or EL expressions.
</description>
&ui_form_attributes;
&html_universal_attributes;
@@ -136,6 +172,11 @@
<name>graphicImage</name>
<tag-class>org.apache.myfaces.taglib.html.HtmlGraphicImageTag</tag-class>
<body-content>JSP</body-content>
+ <description>
+ Renders an HTML img element.
+
+ Unless otherwise specified, all attributes accept static values or EL expressions.
+ </description>
&ui_graphic_attributes;
&html_universal_attributes;
&html_event_handler_attributes;
@@ -147,6 +188,11 @@
<name>inputHidden</name>
<tag-class>org.apache.myfaces.taglib.html.HtmlInputHiddenTag</tag-class>
<body-content>JSP</body-content>
+ <description>
+ Renders as an HTML input tag with its type set to "hidden".
+
+ Unless otherwise specified, all attributes accept static values or EL expressions.
+ </description>
&ui_input_attributes;
<!-- HiddenRenderer attributes -->
</tag>
@@ -157,6 +203,11 @@
<tag-class>org.apache.myfaces.taglib.html.HtmlInputSecretTag</tag-class>
<body-content>JSP</body-content>
&ui_input_attributes;
+ <description>
+ Renders as an HTML input tag with its type set to "password".
+
+ Unless otherwise specified, all attributes accept static values or EL expressions.
+ </description>
<!-- todo: not all html_input_attributes are used for input_secret
in RI (e.g. datafld, datasrc, ...) -->
&html_input_attributes;
@@ -180,8 +231,9 @@
<tag-class>org.apache.myfaces.taglib.html.HtmlInputTextTag</tag-class>
<body-content>JSP</body-content>
<description>
- Renders a HTML input element that is bound to the value (binding)
- of the associated UIOutput component.
+ Renders a HTML input element.
+
+ Unless otherwise specified, all attributes accept static values or EL expressions.
</description>
&standard_input_text_attributes;
</tag>
@@ -191,6 +243,11 @@
<name>inputTextarea</name>
<tag-class>org.apache.myfaces.taglib.html.HtmlInputTextareaTag</tag-class>
<body-content>JSP</body-content>
+ <description>
+ Renders a HTML textarea element.
+
+ Unless otherwise specified, all attributes accept static values or EL expressions.
+ </description>
&standard_input_textarea_attributes;
</tag>
@@ -202,6 +259,8 @@
<description>
Renders the first FacesMessage that is assigned to the component
referenced by the "for" attribute.
+
+ Unless otherwise specified, all attributes accept static values or EL expressions.
</description>
&standard_message_attributes;
</tag>
@@ -217,6 +276,8 @@
- else if there is a "for" attribute, only messages, that are assigned to the component referenced
by the "for" attribute, are displayed
- else all messages are displayed.
+
+ Unless otherwise specified, all attributes accept static values or EL expressions.
</description>
&standard_messages_attributes;
</tag>
@@ -227,8 +288,12 @@
<tag-class>org.apache.myfaces.taglib.html.HtmlOutputLabelTag</tag-class>
<body-content>JSP</body-content>
<description>
+ Renders a HTML label element.
+
In addition to the JSF specification, MyFaces allows it to directly
give an output text via the "value" attribute.
+
+ Unless otherwise specified, all attributes accept static values or EL expressions.
</description>
&standard_output_label_attributes;
</tag>
@@ -238,6 +303,13 @@
<name>outputLink</name>
<tag-class>org.apache.myfaces.taglib.html.HtmlOutputLinkTag</tag-class>
<body-content>JSP</body-content>
+ <description>
+ Renders a HTML a element. Child f:param elements are added to the href
+ attribute as query parameters. Other children are rendered as the link text or image.
+
+ Unless otherwise specified, all attributes accept static values or EL expressions.
+ </description>
+
&ui_output_attributes;
&html_universal_attributes;
&html_event_handler_attributes;
@@ -250,8 +322,11 @@
<tag-class>org.apache.myfaces.taglib.html.HtmlOutputFormatTag</tag-class>
<body-content>JSP</body-content>
<description>
- Takes the value of the associated UIOutput component as a MessageFormat
- pattern and formats embedded parameters with this pattern.
+ Renders as text, applying the child f:param values to the
+ value attribute as a MessageFormat string. If this element has an ID or CSS style
+ properties, the text is wrapped in a span element.
+
+ Unless otherwise specified, all attributes accept static values or EL expressions.
</description>
&ui_output_attributes;
&html_universal_attributes;
@@ -262,7 +337,7 @@
<required>false</required>
<rtexprvalue>false</rtexprvalue>
<description>
- Indicates whether rendered markup should be escaped.
+ Controls whether HTML entities within the output should be escaped.
Default: true
</description>
</attribute>
@@ -274,7 +349,10 @@
<tag-class>org.apache.myfaces.taglib.html.HtmlOutputTextTag</tag-class>
<body-content>JSP</body-content>
<description>
- Renders the value of the associated UIOutput component.
+ Renders the value of the associated UIOutput component. If this element has an ID or CSS style
+ properties, the text is wrapped in a span element.
+
+ Unless otherwise specified, all attributes accept static values or EL expressions.
</description>
&ui_output_attributes;
&html_universal_attributes;
@@ -285,7 +363,7 @@
<required>false</required>
<rtexprvalue>false</rtexprvalue>
<description>
- Indicates whether rendered markup should be escaped.
+ Controls whether HTML entities within the output should be escaped.
Default: true
</description>
</attribute>
@@ -296,6 +374,11 @@
<name>panelGrid</name>
<tag-class>org.apache.myfaces.taglib.html.HtmlPanelGridTag</tag-class>
<body-content>JSP</body-content>
+ <description>This element renders as an HTML table with specified number of columns. Children of this
+ element are rendered as cells in the table, filling rows from left to right. Facets named "header" and "footer" are
+ optional and specify the content of the thead and tfoot rows, respectively.
+
+ Unless otherwise specified, all attributes accept static values or EL expressions.</description>
&standard_panel_grid_attributes;
</tag>
@@ -304,6 +387,10 @@
<name>panelGroup</name>
<tag-class>org.apache.myfaces.taglib.html.HtmlPanelGroupTag</tag-class>
<body-content>JSP</body-content>
+ <description>This element is used to group other components where the specification requires one child element.
+ If any of the HTML or CSS attributes are set, its content is rendered within a span element.
+
+ Unless otherwise specified, all attributes accept static values or EL expressions.</description>
&standard_panel_group_attributes;
</tag>
@@ -312,6 +399,12 @@
<name>selectBooleanCheckbox</name>
<tag-class>org.apache.myfaces.taglib.html.HtmlSelectBooleanCheckboxTag</tag-class>
<body-content>JSP</body-content>
+ <description>
+ Renders as an HTML input tag with its type set to "checkbox", and its name attribute set to the id.
+ The "checked" attribute is rendered if the value of this component is true.
+
+ Unless otherwise specified, all attributes accept static values or EL expressions.
+ </description>
&standard_select_boolean_checkbox_attributes;
</tag>
@@ -320,6 +413,12 @@
<name>selectManyCheckbox</name>
<tag-class>org.apache.myfaces.taglib.html.HtmlSelectManyCheckboxTag</tag-class>
<body-content>JSP</body-content>
+ <description>
+ Renders as an HTML table element, containing an input element for each child f:selectItem
+ or f:selectItems elements.
+
+ Unless otherwise specified, all attributes accept static values or EL expressions.
+ </description>
&standard_select_many_checkbox_attributes;
</tag>
@@ -328,6 +427,13 @@
<name>selectManyListbox</name>
<tag-class>org.apache.myfaces.taglib.html.HtmlSelectManyListboxTag</tag-class>
<body-content>JSP</body-content>
+ <description>
+ Renders as an HTML select element, with the choices made up of child f:selectItem or f:selectItems elements.
+ The multiple attribute is set and the size attribute is set to the provided value, defaulting to the number of items in the list
+ if no value is provided.
+
+ Unless otherwise specified, all attributes accept static values or EL expressions.
+ </description>
&standard_select_many_listbox_attributes;
</tag>
@@ -336,6 +442,13 @@
<name>selectManyMenu</name>
<tag-class>org.apache.myfaces.taglib.html.HtmlSelectManyMenuTag</tag-class>
<body-content>JSP</body-content>
+ <description>
+ Renders as an HTML select element, with the choices made up of child f:selectItem or f:selectItems elements.
+ The multiple attribute is set and the size attribute is set to 1.
+
+ Unless otherwise specified, all attributes accept static values or EL expressions.
+ </description>
+
&standard_select_many_menu_attributes;
</tag>
@@ -344,6 +457,13 @@
<name>selectOneListbox</name>
<tag-class>org.apache.myfaces.taglib.html.HtmlSelectOneListboxTag</tag-class>
<body-content>JSP</body-content>
+ <description>
+ Renders as an HTML select element, with the choices made up of child f:selectItem or f:selectItems elements.
+ The size attribute is set to the provided value, defaulting to the number of items in the list
+ if no value is provided.
+
+ Unless otherwise specified, all attributes accept static values or EL expressions.
+ </description>
&standard_select_one_listbox_attributes;
</tag>
@@ -352,6 +472,11 @@
<name>selectOneMenu</name>
<tag-class>org.apache.myfaces.taglib.html.HtmlSelectOneMenuTag</tag-class>
<body-content>JSP</body-content>
+ <description>
+ Renders as an HTML select element, with the choices made up of child f:selectItem or f:selectItems elements.
+
+ Unless otherwise specified, all attributes accept static values or EL expressions.
+ </description>
&standard_select_one_menu_attributes;
</tag>
@@ -360,6 +485,13 @@
<name>selectOneRadio</name>
<tag-class>org.apache.myfaces.taglib.html.HtmlSelectOneRadioTag</tag-class>
<body-content>JSP</body-content>
+ <description>
+ Renders as an HTML table element, containing an input element for each child f:selectItem
+ or f:selectItems elements. The input elements are rendered as type radio. If the value of a choice matches the components
+ value, its checked attribute is set.
+
+ Unless otherwise specified, all attributes accept static values or EL expressions.
+ </description>
&standard_select_one_radio_attributes;
</tag>