These tables are from the book Core JavaServer Faces by David Geary and Cay Horstmann, Sun Microsystems Press 2004.

Transcription

1 These tables are from the book Core JavaServer Faces by David Geary and Cay Horstmann, Sun Microsystems Press Table 4 1 JSF Core Tags Tag f:view f:subview f:facet f:attribute f:param f:actionlistener f:valuechangelistener f:setpropertychangelistener (JSF 1.2) f:converter f:convertdatetime f:convertnumber f:validator f:validatedoublerange f:validatelength f:validatelongrange f:loadbundle f:selectitems f:selectitem f:verbatim Creates the top-level view Creates a subview of a view Adds a facet to a component Adds an attribute (key/value) to a component Constructs a parameter component Adds an action listener to a component Adds a valuechange listener to a component Adds an action listener to a component that sets a bean property to a given value. Adds an arbitrary converter to a component Adds a datetime converter to a component Adds a number converter to a component Adds a validator to a component Validates a double range for a component s value Validates the length of a component s value Validates a long range for a component s value Loads a resource bundle, stores properties as a Map Specifies items for a select one or select many component Specifies an item for a select one or select many component Adds markup to a JSF page Table 4 3 JSF HTML Tags Tag h:form h:inputtext h:inputtextarea h:inputsecret h:inputhidden h:outputlabel h:outputlink h:outputformat h:outputtext HTML form Single-line text input control. Examples Multiline text input control. Examples Password input control. Examples Hidden field Label for another component for accessibility HTML anchor. Examples Like outputtext, but formats compound messages Single-line text output. Examples (1 of 16)4/16/ :19:32 PM

2 h:commandbutton h:commandlink h:message h:messages h:grapicimage h:selectonelistbox h:selectonemenu h:selectoneradio h:selectbooleancheckbox h:selectmanycheckbox h:selectmanylistbox h:selectmanymenu h:panelgrid h:panelgroup h:datatable h:column Button: submit, reset, or pushbutton. Examples Link that acts like a pushbutton. Examples Displays the most recent message for a component Displays all messages Displays an image. Examples Single-select listbox. Examples Single-select menu. Examples Set of radio buttons. Examples Checkbox. Examples Set of checkboxes. Examples Multiselect listbox. Examples Multiselect menu. Examples HTML table Two or more components that are laid out as one A feature-rich table control Column in a datatable Table 4 4 Basic s Component Types id A (25) Identifier for a component binding A (25) Reference to the component that can be used in a backing bean rendered A (25) A boolean; false suppresses rendering styleclass A (23) Cascading stylesheet (CSS) class name value I, O, C (19) A component s value, typically a value binding valuechangelistener I (11) A method binding to a method that responds to value changes converter I, O (15) Converter class name validator I (11) Class name of a validator that s created and attached to a component required I (11) A boolean; if true, requires a value to be entered in the associated field A = all, I = input, O = output, C = commands, (n) = number of tags with attribute Table 4 5 HTML 4.0 Pass-through s accesskey (14) A key, typically combined with a system-defined metakey, that gives focus to an element (2 of 16)4/16/ :19:32 PM

3 accept (1) accept-charset (1) alt (4) border (4) charset (3) coords (2) dir (18) disabled (11) hreflang (2) lang (20) maxlength (2) readonly (11) rel (2) rev (2) rows (1) shape (2) size (4) style (23) tabindex (14) target (3) title (22) type (4) width (3) Comma-separated list of content types for a form Comma- or space-separated list of character encodings for a form. The accept-charset attribute is specified with the JSF HTML attribute named acceptcharset. Alternative text for nontextual elements such as images or applets Pixel value for an element s border width Character encoding for a linked resource Coordinates for an element whose shape is a rectangle, circle, or polygon Direction for text. Valid values are ltr (left to right) and rtl (right to left). Disabled state of an input element or button Base language of a resource specified with the href attribute; hreflang may only be used with href. Base language of an element s attributes and text Maximum number of characters for text fields Read-only state of an input field; text can be selected in a readonly field but not edited Relationship between the current document and a link specified with the href attribute Reverse link from the anchor specified with href to the current document. The value of the attribute is a space-separated list of link types. Number of visible rows in a text area. h:datatable has a rows attribute, but it s not an HTML pass-through attribute. Shape of a region. Valid values: default, rect, circle, poly. (default signifies the entire region) Size of an input field Inline style information Numerical value specifying a tab index The name of a frame in which a document is opened A title, used for accessibility, that describes an element. Visual browsers typically create tooltips for the title s value Type of a link; for example, "stylesheet" Width of an element (n) = number of tags with attribute Table 4 6 DHTML Event s onblur (14) onchange (11) onclick (17) ondblclick (18) onfocus (14) onkeydown (18) Element loses focus Element s value changes Mouse button is clicked over the element Mouse button is double-clicked over the element Element receives focus Key is pressed (3 of 16)4/16/ :19:32 PM

4 onkeypress (18) onkeyup (18) onmousedown (18) onmousemove (18) onmouseout (18) onmouseover (18) onmouseup (18) onreset (1) onselect (11) onsubmit (1) Key is pressed and subsequently released Key is released Mouse button is pressed over the element Mouse moves over the element Mouse leaves the element s area Mouse moves onto an element Mouse button is released Form is reset Text is selected in an input field Form is submitted (n) = number of tags with attribute Table 4 7 s for h:form binding, id, rendered, styleclass accept, acceptcharset, dir, enctype, lang, style, target, title onblur, onchange, onclick, ondblclick, onfocus, onkeydown, onkeypress, onkeyup, onmousedown, onmousemove, onmouseout, onmouseover, onreset, onsubmit HTML 4.0 attributes DHTML events Table 4 8 s for h:inputtext, h:inputsecret, h:inputtextarea,and h:inputhidden cols immediate redisplay required rows valuechangelistener binding, converter, id, rendered, required, styleclass, value, validator accesskey, alt, dir, disabled, lang, maxlength, readonly, size, style, tabindex, title For h:inputtextarea only number of columns Process validation early in the life cycle For h:inputsecret only when true, the input field s value is redisplayed when the web page is reloaded Require input in the component when the form is submitted For h:inputtextarea only number of rows A specified listener that s notified of value changes HTML 4.0 pass-through attributes alt, maxlength, and size do not apply to h:inputtextarea. None apply to h: inputhidden. (4 of 16)4/16/ :19:32 PM

5 onblur, onchange, onclick, ondblclick, onfocus, onkeydown, onkeypress, onkeyup, onmousedown, onmousemove, onmouseout, onmouseover, onselect DHTML events. None apply to h: inputhidden. Table 4 9 h:inputtext and h:inputsecret Examples Example <h:inputtext value="#{form.teststring}" readonly="true"/> <h:inputsecret value="#{form.passwd}" redisplay="true"/> <h:inputsecret value="#{form.passwd}" redisplay="false"/> <h:inputtext value="inputtext" style="color: Yellow; background: Teal;"/> Result <h:inputtext value=" " size="5"/> <h:inputtext value=" " maxlength="6" size="10"/> Table 4 10 h:inputtextarea Examples Example Result <h:inputtextarea rows="5"/> <h:inputtextarea cols="5"/> <h:inputtextarea value=" " rows="3" cols="10"/> <h:inputtextarea value="#{form.datainrows}" rows="2" cols="15"/> Table 4 11 s for h:outputtext and h:outputformat escape binding, converter, id, rendered, styleclass, value If set to true, escapes <, >, and & characters. Default value is true. (5 of 16)4/16/ :19:32 PM

6 style, title HTML 4.0 s for h:outputlabel for binding, converter, id, rendered, value The ID of the component to be labeled. Table 4 12 s for h:graphicimage binding, id, rendered, styleclass, value alt, dir, height, ismap, lang, longdesc, style, title, url, usemap, width onblur, onchange, onclick, ondblclick, onfocus, onkeydown, onkeypress, onkeyup, onmousedown, onmousemove, onmouseout, onmouseover, onmouseup HTML 4.0 DHTML events Table 4 13 h:outputtext and h:graphicimage Examples Example <h:outputtext value="#{form. teststring}"/> <h:outputtext value="number #{form. number}"/> <h:outputtext value="<input type= text value= hello />"/> <h:outputtext escape="true" value="<input type= text value= hello />"/> Result <h:graphicimage value="/tjefferson. jpg"/> <h:graphicimage value="/tjefferson. jpg" style="border: thin solid black"/ > Table 4 14 h:commandbutton and h:commandlink action If specified as a string: Directly specifies an outcome used by the navigation handler to determine the JSF page to load next as a result of activating the button or link If specified as a method binding: The method has this signature: String methodname(); the string represents the outcome (6 of 16)4/16/ :19:32 PM

7 actionlistener charset image immediate type value accesskey, alt, binding, id, lang, rendered, styleclass, value coords (h:commandlink only), dir, disabled (h:commandbutton only), hreflang (h:commandlink only), lang, readonly, rel (h:commandlink only), rev (h:commandlink only), shape (h: commandlink only), style, tabindex, target (h:commandlink only), title, type onblur, onchange, onclick, ondblclick, onfocus, onkeydown, onkeypress, onkeyup, onmousedown, onmousemove, onmouseout, onmouseover, onmouseup, onselect A method binding that refers to a method with this signature: void methodname (ActionEvent) For h:commandlink only The character encoding of the linked reference For h:commandbutton only A contextrelative path to an image displayed in a button. If you specify this attribute, the HTML input s type will be image. A boolean. If false (the default), actions and action listeners are invoked at the end of the request life cycle; if true, actions and action listeners are invoked at the beginning of the life cycle. See Chapter 6 for more information about the immediate attribute. For h:commandbutton: The type of the generated input element: button, submit, or reset. The default, unless you specify the image attribute, is submit. For h:commandlink: The content type of the linked resource; for example, text/html, image/gif, or audio/basic The label displayed by the button or link. You can specify a string or a value reference expression. HTML 4.0 DHTML events Table 4 15 h:commandbutton Examples Example Result <h:commandbutton value="submit" type="submit"/> <h:commandbutton value="reset" type="reset"/> <h:commandbutton value="click this button..." onclick="alert('button clicked')" type="button"/> (7 of 16)4/16/ :19:32 PM

8 <h:commandbutton value="disabled" disabled="#{not form.buttonenabled}"/> <h:commandbutton value="#{form. buttontext}" type="reset"/> Table 4 16 h:commandlink Examples Example <h:commandlink> <h:outputtext value="register"/> </h:commandlink> <h:commandlink style="font-style: italic"> <h:outputtext value="#{msgs.linktext}"/> </h: commandlink> Result <h:commandlink> <h:outputtext value="#{msgs. linktext}"/> <h:graphicimage value="/ registration.jpg"/> </h:commandlink> <h:commandlink value="welcome" actionlistener="#{form.uselinkvalue}" action="#{form.followlink}"> <h:commandlink> <h:outputtext value="welcome"/> <f:param name="outcome" value="welcome"/> </h:commandlink> Table 4 17 s for h:outputlink accesskey, binding, converter, id, lang, rendered, styleclass, value charset, coords, dir, hreflang, lang, rel, rev, shape, style, HTML 4.0 tabindex, target, title, type onblur, onchange, onclick, ondblclick, onfocus, onkeydown, onkeypress, onkeyup, onmousedown, onmousemove, onmouseout, onmouseover, onmouseup DHTML events Table 4 18 h:outputlink Examples Example Result (8 of 16)4/16/ :19:32 PM

9 <h:outputlink value=" <h: graphicimage value="java-dot-net.jpg"/> <h: outputtext value="java.net"/> </h: outputlink> <h:outputlink value="#{form.welcomeurl}"> <h:outputtext value="#{form. welcomelinktext}"/> </h:outputlink> <h:outputlink value="#introduction"> <h: outputtext value="introduction" style="font-style: italic"/> </h: outputlink> <h:outputlink value="#conclusion" title="go to the conclusion"> <h: outputtext value="conclusion"/> </h: outputlink> <h:outputlink value="#toc" title="go to the table of contents"> <f:verbatim> <h2>table of Contents</h2> </f:verbatim> </ h:outputlink> Table 4 19 Selection Tag Examples Tag Generated HTML Examples h: selectbooleancheckbox h:selectmanycheckbox h:selectoneradio h:selectonelistbox h:selectmanylistbox <input type="checkbox"> <table>... <label> <input type="checkbox"/ > </label>... </table> <table>... <label> <input type="radio"/> </label>... </ table> <select> <option value="cheese"> Cheese </ option>... </ select> <select multiple> <option value="cheese"> Cheese </ option>... </ select> (9 of 16)4/16/ :19:32 PM

10 h:selectonemenu h:selectmanymenu <select size="1"> <option value="cheese"> Cheese </ option>... </ select> <select multiple size="1"> <option value="sunday"> Sunday </ option>... </ select> Table 4 20 s for h:selectbooleancheckbox, h:selectmanycheckbox, h:selectoneradio, h: selectonelistbox, h:selectmanylistbox, h:selectonemenu, h:selectmanymenu disabledclass enabledclass layout binding, converter, id, immediate, styleclass, required, rendered, validator, value, valuechangelistener accesskey, border, dir, disabled, lang, readonly, style, size, tabindex, title onblur, onchange, onclick, ondblclick, onfocus, onkeydown, onkeypress, onkeyup, onmousedown, onmousemove, onmouseout, onmouseover, onmouseup, onselect CSS class for disabled elements for h: selectoneradio and h: selectmanycheckbox only CSS class for enabled elements for h: selectoneradio and h: selectmanycheckbox only Specification for how elements are laid out: linedirection (horizontal) or pagedirection (vertical) for h: selectoneradio and h: selectmanycheckbox only HTML 4.0 border is applicable to h: selectoneradio and h: selectmanycheckbox only. size is applicable to h:selectonelistbox and h: selectmanylistbox only. DHTML events Table 4 21 s for f:selectitem binding, id item itemdisabled used by tools only Boolean value that sets the item s disabled property (10 of 16)4/16/ :19:32 PM

11 itemlabel itemvalue value Text shown by the item Item s value, which is passed to the server as a request parameter Value binding expression that points to a SelectItem instance s for f:selectitems binding, id value Value binding expression that points to a SelectItem, an array or Collection of SelectItem objects, or a Map mapping labels to values. Table 4 22 s for h:message and h:messages for The ID of the component whose message is displayed applicable only to h:message errorclass CSS class applied to error messages errorstyle CSS style applied to error messages fatalclass CSS class applied to fatal messages fatalstyle CSS style applied to fatal messages globalonly Instruction to display only global messages applicable only to h:messages. Default: false infoclass CSS class applied to information messages infostyle CSS style applied to information messages layout Specification for message layout: table or list applicable only to h:messages A boolean that determines whether message details are showdetail shown. Defaults are false for h:messages, true for h: message. A boolean that determines whether message summaries are showsummary shown. Defaults are true for h:messages, false for h: message. A boolean that determines whether message details are tooltip rendered in a tooltip; the tooltip is only rendered if showdetail and showsummary are true warnclass CSS class for warning messages warnstyle CSS style for warning messages binding, id, rendered, styleclass style, title HTML 4.0 Table 4 23 s for h:panelgrid bgcolor Background color for the table (11 of 16)4/16/ :19:32 PM

12 border cellpadding cellspacing columnclasses columns footerclass frame headerclass rowclasses rules summary binding, id, rendered, styleclass, value dir, lang, style, title, width HTML 4.0 onclick, ondblclick, onkeydown, onkeypress, onkeyup, onmousedown, onmousemove, onmouseout, onmouseover, onmouseup Width of the table s border Padding around table cells Spacing between table cells Comma-separated list of CSS classes for columns Number of columns in the table CSS class for the table footer frame Specification for sides of the frame surrounding the table that are to be drawn; valid values: none, above, below, hsides, vsides, lhs, rhs, box, border CSS class for the table header Comma-separated list of CSS classes for columns Specification for lines drawn between cells; valid values: groups, rows, columns, all Summary of the table s purpose and structure used for non-visual feedback such as speech DHTML events Table 4 24 s for h:panelgroup binding, id, rendered, styleclass style HTML 4.0 Table 5 1 s for h:datatable bgcolor border cellpadding cellspacing columnclasses first footerclass Background color for the table width of the table's border Padding around table cells Spacing between table cells comma-separated list of CSS classes for columns index of the first row shown in the table CSS class for the table footer (12 of 16)4/16/ :19:32 PM

13 frame headerclass rowclasses rules summary var binding, id, rendered, styleclass, value dir, lang, style, title, width HTML 4.0 onclick, ondblclick, onkeydown, onkeypress, onkeyup, onmousedown, onmousemove, onmouseout, onmouseover, onmouseup Specification for sides of the frame surrounding the table should be drawn; valid values: none, above, below, hsides, vsides, lhs, rhs, box, border CSS class for the table header comma-separated list of CSS classes for rows Specification for lines drawn between cells; valid values: groups, rows, columns, all summary of the table's purpose and structure used for non-visual feedback such as speech The name of the variable created by the data table that represents the current item in the value DHTML events s for h:column headerclass (JSF 1.2) footerclass (JSF 1.2) binding, id, rendered CSS class for the column's header CSS class for the column's footer Table 6 1 s for f:convertnumber Type Value type String number (default), currency, or percent pattern String Formatting pattern, as defined in java.text. DecimalFormat maxfractiondigits int Maximum number of digits in the fractional part minfractiondigits int Minimum number of digits in the fractional part maxintegerdigits int Maximum number of digits in the integer part minintegerdigits int Minimum number of digits in the integer part integeronly boolean True if only the integer part is parsed (default: false) groupingused boolean True if grouping separators are used (default: true) locale currencycode java.util. Locale String Locale whose preferences are to be used for parsing and formatting ISO 4217 currency code to use when converting currency values (13 of 16)4/16/ :19:32 PM

14 currencysymbol String Currency symbol to use when converting currency values Table 6 2 s for f:convertdatetime Type Value type String date (default), time, or both datestyle String default, short, medium, long, or full timestyle String default, short, medium, long, or full pattern String Formatting pattern, as defined in java.text. SimpleDateFormat locale java.util.locale Locale whose preferences are to be used for parsing and formatting timezone java.util. TimeZone Time zone to use for parsing and formatting Table 6 3 Standard Validators JSP Tag Validator Class s Validates f: validatedoublerange f:validatelongrange f:validatelength DoubleRangeValidator minimum, maximum LongRangeValidator LengthValidator minimum, maximum minimum, maximum a double value within an optional range a long value within an optional range a String with a minimum and maximum number of characters s for f:view locale renderkitid (JSF 1.2) beforephase, afterphase The locale for this view. The render kit ID for this view Phase listeners that are called in every phase except "restore view" s for f:subview binding, id, rendered s for f:facet name The name of this facet. (14 of 16)4/16/ :19:32 PM

15 s for f:attribute name value The name of the attribute to set. The value of the attribute. s for f:param name value binding, id An optional name for this parameter component. The value stored in this component. s for f:actionlistener, f:valuechangelistener type The name of the listener class s for f:propertychangelistener target The bean property to set when the action event occurs value The value to set it to s for f:converter converterid The ID of the converter s for f:validator validatorid The ID of the validator s for f:loadbundle basename value The resource bundle name The name of the variable that is bound to the bundle map s for f:verbatim (15 of 16)4/16/ :19:32 PM

16 escape rendered (JSF 1.2) If set to true, escapes <, >, and & characters. Default value is false. (16 of 16)4/16/ :19:32 PM