Parent Directory
| 
Revision Log
| 
Patch
--- myfaces/impl/trunk/tld/myfaces_html.tld 2005/11/25 00:03:17 348837
+++ myfaces/impl/trunk/tld/myfaces_html.tld 2005/11/25 00:28:55 348838
@@ -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 @@ Start of revised 1.0 conforming tags (in
<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 @@ Start of revised 1.0 conforming tags (in
<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 @@ Start of revised 1.0 conforming tags (in
<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 @@ Start of revised 1.0 conforming tags (in
<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 @@ Start of revised 1.0 conforming tags (in
<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 @@ Start of revised 1.0 conforming tags (in
<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 @@ Start of revised 1.0 conforming tags (in
<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 @@ Start of revised 1.0 conforming tags (in
<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 @@ Start of revised 1.0 conforming tags (in
<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 @@ Start of revised 1.0 conforming tags (in
<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 @@ Start of revised 1.0 conforming tags (in
<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 @@ Start of revised 1.0 conforming tags (in
- 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 @@ Start of revised 1.0 conforming tags (in
<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 @@ Start of revised 1.0 conforming tags (in
<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 @@ Start of revised 1.0 conforming tags (in
<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 @@ Start of revised 1.0 conforming tags (in
<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 @@ Start of revised 1.0 conforming tags (in
<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 @@ Start of revised 1.0 conforming tags (in
<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 @@ Start of revised 1.0 conforming tags (in
<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 @@ Start of revised 1.0 conforming tags (in
<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 @@ Start of revised 1.0 conforming tags (in
<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 @@ Start of revised 1.0 conforming tags (in
<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 @@ Start of revised 1.0 conforming tags (in
<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 @@ Start of revised 1.0 conforming tags (in
<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 @@ Start of revised 1.0 conforming tags (in
<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 @@ Start of revised 1.0 conforming tags (in
<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 @@ Start of revised 1.0 conforming tags (in
<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>
| infrastructure at apache.org | ViewVC Help |
| Powered by ViewVC 1.1.26 |