]> 0.9.0 1.2 x http://myfaces.apache.org/extensions Enhanced standard JSP actions and custom MyFaces actions. commandButton org.apache.myfaces.taglib.html.ext.HtmlCommandButtonTag JSP Extends standard commandButton by user role support. &standard_command_button_attributes; &user_role_attributes; &ext_forceId_attribute; commandLink org.apache.myfaces.taglib.html.ext.HtmlCommandLinkTag JSP Extends standard commandLink by user role support and the HTML target attribute. &standard_command_link_attributes; &user_role_attributes; &ext_forceId_attribute; dataTable org.apache.myfaces.taglib.html.ext.HtmlDataTableTag JSP Extended data_table that adds some additional features to the standard data_table action: see attribute descriptions for preserveDataModel, sortColumn, sortAscending and preserveSort. &standard_data_table_attributes; &ext_forceId_attribute; &user_role_attributes; preserveDataModel false false Indicates whether the state of the whole DataModel should be saved and restored. Default: false sortColumn false false Value reference to a model property that gives the current sort column name. sortAscending false false Value reference to a model property that gives the current sort direction. preserveSort false false Indicates whether the state of the sortColumn and sortAscending attribute should be saved and restored and written back to the model during the update model phase. Default: true renderedIfEmpty false false Indicates whether this table should be rendered if the underlying DataModel is empty. You could as well use rendered="#{not empty bean.list}", but this one causes the getList method of your model bean beeing called up to five times per request, which is not optimal when the list is backed by a DB table. Using renderedIfEmpty="false" solves this problem, because the MyFaces extended HtmlDataTable automatically caches the DataModel and calles the model getter only once per request. Default: true rowIndexVar false false A parameter name, under which the current rowIndex is set in request scope similar to the var parameter. rowCountVar false false A parameter name, under which the rowCount is set in request scope similar to the var parameter. previousRowDataVar false false A parameter name, under which the previous RowData Object is set in request scope similar to the rowIndexVar and rowCountVar parameters. Mind that the value of this request scope attribute is null in the first row or when isRowAvailable returns false for the previous row. inputHidden org.apache.myfaces.taglib.html.HtmlInputHiddenTag JSP Extends standard inputHidden by providing additional MyFaces goodies. &ui_input_attributes; &ext_forceId_attribute; inputText org.apache.myfaces.taglib.html.ext.HtmlInputTextTag JSP Extends standard inputText by user role support. &standard_input_text_attributes; &user_role_attributes; &ext_forceId_attribute; inputTextarea org.apache.myfaces.taglib.html.ext.HtmlInputTextareaTag JSP Extends standard inputTextarea by user role support. &standard_input_textarea_attributes; &user_role_attributes; &ext_forceId_attribute; message org.apache.myfaces.taglib.html.ext.HtmlMessageTag JSP MyFaces extension to the standard messages tag: see summaryDetailSeparator attribute &standard_message_attributes; &user_role_attributes; &ext_forceId_attribute; summaryFormat false false If present, instead of rendering the message summary, a MessageFormat with this attribute as pattern is created. The format method of this MessageFormat is called with the message summary as the first argument and the label of the associated component (if any) as the second argument. Example: "{0}:" detailFormat false false If present, instead of rendering the message detail, a MessageFormat with this attribute as pattern is created. The format method of this MessageFormat is called with the message detail as the first argument and the label of the associated component (if any) as the second argument. Example: "The input in field {1} is wrong: {0}" replaceIdWithLabel false false If present, all occurrences of the id of the component for which the message is rendered will be replaced by the label. Standard is true for the extended message renderer. messages org.apache.myfaces.taglib.html.ext.HtmlMessagesTag JSP MyFaces extension to the standard messages tag: see showInputLabel attribute &standard_messages_attributes; &user_role_attributes; &ext_forceId_attribute; summaryFormat false false If present, instead of rendering the message summary, a MessageFormat with this attribute as pattern is created. The format method of this MessageFormat is called with the message summary as the first argument and the label of the associated component (if any) as the second argument. Example: "{0}:" or "{0} in field {1}" globalSummaryFormat false false Like summaryFormat, but applies to global messages (i.e. messages not associated with a component). If no globalSummaryFormat is given, the summaryFormat is used for global messages. Example: "{0}:" detailFormat false false If present, instead of rendering the message detail, a MessageFormat with this attribute as pattern is created. The format method of this MessageFormat is called with the message detail as the first argument and the label of the associated component (if any) as the second argument. Example: "The input in field {1} is wrong: {0}" replaceIdWithLabel false false If present, all occurrences of the id of the component for which the message is rendered will be replaced by the label. outputLabel org.apache.myfaces.taglib.html.ext.HtmlOutputLabelTag JSP Extends standard outputLabel by user role support. &standard_output_label_attributes; &user_role_attributes; &ext_forceId_attribute; outputText org.apache.myfaces.taglib.html.ext.HtmlOutputTextTag JSP Extends standard outputText by user role support. &standard_output_text_attributes; &user_role_attributes; &ext_forceId_attribute; panelGroup org.apache.myfaces.taglib.html.ext.HtmlPanelGroupTag JSP Extends standard panelGroup by user role support. &standard_panel_group_attributes; &user_role_attributes; &ext_forceId_attribute; selectOneMenu org.apache.myfaces.taglib.html.ext.HtmlSelectOneMenuTag JSP Extends standard selectOneMenu by user role support. &standard_select_one_menu_attributes; &user_role_attributes; &ext_forceId_attribute; selectOneRadio org.apache.myfaces.taglib.html.ext.HtmlSelectOneRadioTag JSP Extends standard selectOneRadio by user role support. Additionally this extended selectOneRadio accepts a layout attribute of value "spread" (see custom radio tag). &standard_select_one_radio_attributes; &user_role_attributes; &ext_forceId_attribute; selectManyCheckbox org.apache.myfaces.taglib.html.ext.HtmlSelectManyCheckboxTag JSP Extends standard selectManyCheckbox by user role support. Additionally this extended selectManyCheckbox accepts a layout attribute of value "spread" (see custom checkbox tag). &standard_select_many_checkbox_attributes; &user_role_attributes; &ext_forceId_attribute; inputCalendar org.apache.myfaces.custom.calendar.HtmlInputCalendarTag JSP Provides a calendar. &ui_input_attributes; &html_event_handler_attributes; &html_universal_attributes; &user_role_attributes; monthYearRowClass false false CSS class to be used for the header-row showing month and year. weekRowClass false false CSS class to be used for the header-row showing the week-days. dayCellClass false false CSS class to be used for the cells showing days. currentDayCellClass false false CSS class to be used for the cell of the currently selected date. renderAsPopup false false Render the input-calendar as a java-script popup on client. addResources false false Automatically add the input-calendar scripts and css files to the header - set that to false to provide the scripts yourself. popupDateFormat false false Defines the date format used by the java-script popup on client. popupButtonString false false Defines the string displayed on the button which leads to the calendar-popup-window (... by default). popupGotoString false false Set the string for "Go To Current Month" popupTodayString false false Set the string for "Today is" popupWeekString false false Set the string for "Wk" popupScrollLeftMessage false false Set the string for scrolling to the left. popupScrollRightMessage false false Set the string for scrolling to the right. popupSelectMonthMessage false false Set the string for "Click to select a month". popupSelectYearMessage false false Set the string for "Click to select a year". popupSelectDateMessage false false Set the string for "Select [date] as date" (do not replace [date], it will be replaced by the current date). jsValueChangeListener org.apache.myfaces.custom.jslistener.JsValueChangeListenerTag empty Value change listener on client side. for false false property false false expressionValue true false jsValueSet org.apache.myfaces.custom.jsvalueset.HtmlJsValueSetTag empty Setting a value from the model in java-script so that it can be used (e.g. by the value change listener) afterwards. name true false value true false checkbox org.apache.myfaces.custom.checkbox.HtmlCheckboxTag JSP Renders a HTML input of type "checkbox". The associated SelectItem comes from an extended selectManyCheckbox component with layout "spread". The selectManyCheckbox is referenced by the "for" attribute. All HTML pass-through attributes for this input are taken from the associated selectManyCheckbox. &ui_component_attributes; &user_role_attributes; for true false id of the referenced extended selectManyCheckbox component index true false n-th SelectItem of referenced UISelectMany starting with 0. commandNavigation org.apache.myfaces.custom.navigation.HtmlCommandNavigationTag JSP Must be nested inside a panel_navigation action and renders a clickable navigation item. This action is derived from the standard command_link action and has equal attributes. (Replaces former "navigation_item" tag.) &ui_command_attributes; &html_universal_attributes; &html_event_handler_attributes; &html_anchor_attributes; &user_role_attributes; onblur false false onfocus false false commandSortHeader org.apache.myfaces.custom.sortheader.HtmlCommandSortHeaderTag JSP Clickable sort column header. Must be nested inside an extended data_table tag. This tag is derived from the standard command_link tag and has the additional attributes columnName and arrow. Note: In contrary to normal command links the default for the "immediate" attribute is "true". &ui_command_attributes; &html_universal_attributes; &html_event_handler_attributes; &html_anchor_attributes; &user_role_attributes; columnName true false The name of this column. This name must uniquely identify this column among all other (sortable) columns in the same data_table. The sortColumn attribute of the embedding data_table reflects the current sort column (see extended data_table). arrow false false Indicates whether an arrow, that shows the sort direction should be rendered. Default: false dataList org.apache.myfaces.custom.datalist.HtmlDataListTag JSP Similar to dataTable, but does not render a table. Instead the layout attribute controls how each dataRow is rendered. &ui_panel_attributes; &html_universal_attributes; &html_event_handler_attributes; value false false Supported types see JSF Spec 4.1.3 var true false rows false false first false false &user_role_attributes; layout false false simple|unorderedList|orderedList simple = for each dataRow all children are simply rendered unorderedList = the list is rendered as HTML unordered list (= bullet list) orderedList = the list is rendered as HTML ordered list Default: simple rowIndexVar false false A parameter name, under which the current rowIndex is set in request scope similar to the var parameter. rowCountVar false false A parameter name, under which the rowCount is set in request scope similar to the var parameter. dataScroller org.apache.myfaces.custom.datascroller.HtmlDataScrollerTag JSP Scroller for UIData components eg. dataTable Must be nested inside footer facet of dataTable OR for attribute must be given so that corresponding uiData can be found &ui_component_attributes; &user_role_attributes; for false false fastStep false false step (pages) used for fastforward and fastrewind pageIndexVar false false A parameter name, under which the actual page index is set in request scope similar to the var parameter. pageCountVar false false A parameter name, under which the actual page count is set in request scope similar to the var parameter. rowsCountVar false false A parameter name, under which the actual rows count is set in request scope similar to the var parameter. displayedRowsCountVar false false A parameter name, under which the actual displayed rows count is set in request scope similar to the var parameter. firstRowIndexVar false false A parameter name, under which the actual first displayed row index is set in request scope similar to the var parameter. lastRowIndexVar false false A parameter name, under which the actual last displayed row index is set in request scope similar to the var parameter. styleClass false false styleClass for scroller table style false false style for scroller table paginator false false If set true, then the paginator gets rendered paginatorMaxPages false false The maximum amount of pages to be displayed in the paginator. paginatorTableClass false false styleclass for pagingator paginatorTableStyle false false style for pagingator paginatorColumnClass false false styleClass for paginator's column paginatorColumnStyle false false style for paginator's column paginatorActiveColumnClass false false styleClass for paginator's column with pageIndex = currentPageIndex paginatorActiveColumnStyle false false style for paginator's column with pageIndex = currentPageIndex inputDate org.apache.myfaces.custom.date.HtmlInputDateTag JSP &ui_input_attributes; &html_universal_attributes; &html_event_handler_attributes; &html_input_attributes; &user_role_attributes; type false false popupCalendar false false inputFileUpload org.apache.myfaces.custom.fileupload.HtmlInputFileUploadTag JSP You must enable the MultiPart Filter to make this component work (see web.xml). Also, don't forget to set the form's attribute "enctype" to "multipart/form-data". See "examples/web/fileupload.jsp" for an example! &ui_input_attributes; &html_universal_attributes; &html_event_handler_attributes; &html_input_attributes; accept false false storage false false inputHtml org.apache.myfaces.custom.inputHtml.InputHtmlTag JSP An inline HTML based word processor based on the Kupu library. See http://kupu.oscom.org Right now, the support is limited to one editor per page (but you can use tabs to have multiple editors, but only one rendered at a time). id false false &ui_input_attributes; &user_role_attributes; style false false styleClass false false fallback false false Use a text area instead of the javascript HTML editor. Default is false. Use with caution. type false false The type of the value. It can be either fragment for an HTML fragment (default) or document for a full HTML document, with head, title, body, ... tags. allowEditSource false false Allows the user to edit the HTML source code. Default is true. allowExternalLinks false false Allows the user to insert external links. Default is true. addKupuLogo false false Show the Kupu Logo in the buttons bar. Default is true. showAllToolBoxes false false Shortcut to avoid setting all the showXXToolBox to true. Default is false. showPropertiesToolBox false false Show the Properties tool box next to the text. Default is false. showLinksToolBox false false Show the Links tool box next to the text. Default is false. showImagesToolBox false false Show the Images tool box next to the text. Default is false. showTablesToolBox false false Show the Tables tool box next to the text. Default is false. showCleanupExpressionsToolBox false false Show the Cleanup Expressions tool box next to the text. Default is false. showDebugToolBox false false Show the Debug tool box next to the text. Default is false. navigationMenuItem org.apache.myfaces.custom.navmenu.HtmlNavigationMenuItemTag JSP &ui_select_item_attributes; &user_role_attributes; icon false false split false false action false false navigationMenuItems org.apache.myfaces.custom.navmenu.HtmlNavigationMenuItemsTag empty &ui_select_items_attributes; jscookMenu org.apache.myfaces.custom.navmenu.jscookmenu.HtmlJSCookMenuTag JSP &ui_component_attributes; &user_role_attributes; layout true false theme true false panelLayout org.apache.myfaces.custom.layout.HtmlPanelLayoutTag JSP &ui_panel_attributes; &html_universal_attributes; &html_event_handler_attributes; &html_table_attributes; layout false false java.lang.String layout | header | navigation | body | footer =================|========|============|=======|======== classic (Default)| top | left | right | bottom navigationRight | top | right | left | bottom upsideDown | bottom | left | right | top headerClass false false CSS class to be used for the table cell. navigationClass false false CSS class to be used for the table cell. bodyClass false false CSS class to be used for the table cell. footerClass false false CSS class to be used for the table cell. headerStyle false false CSS style to be used for the table cell. navigationStyle false false CSS style to be used for the table cell. bodyStyle false false CSS style to be used for the table cell. footerStyle false false CSS style to be used for the table cell. panelNavigation org.apache.myfaces.custom.navigation.HtmlPanelNavigationTag JSP &ui_panel_attributes; &html_universal_attributes; &html_event_handler_attributes; &html_table_attributes; itemClass false false The CSS class of closed navigation items. openItemClass false false The CSS class of open navigation items. activeItemClass false false The CSS class of the active navigation item. separatorClass false false The CSS class for the td element of a separator. itemStyle false false The CSS Style of closed navigation items. openItemStyle false false The CSS Style of open navigation items. activeItemStyle false false The CSS Style of the active navigation item. separatorStyle false false The CSS Style for the td element of a separator. panelTab org.apache.myfaces.custom.tabbedpane.HtmlPanelTabTag JSP &ui_panel_attributes; &html_universal_attributes; &html_event_handler_attributes; &user_role_attributes; label false false Label of this tab. panelTabbedPane org.apache.myfaces.custom.tabbedpane.HtmlPanelTabbedPaneTag JSP &ui_panel_attributes; &html_universal_attributes; &html_event_handler_attributes; &html_table_attributes; &user_role_attributes; selectedIndex false false Index of tab that is selected by default. activeTabStyleClass false false Style class of the active tab cell. inactiveTabStyleClass false false Style class of the inactive tab cells. disabledTabStyleClass false false Style class of the disabled tab cells. activeSubStyleClass false false Style class of the active tab sub cell. inactiveSubStyleClass false false Style class of the inactive tab sub cells. tabContentStyleClass false false Style class of the active tab content cell. tabChangeListener org.apache.myfaces.custom.tabbedpane.TabChangeListenerTag empty type true false collapsiblePanel org.apache.myfaces.custom.collapsiblepanel.HtmlCollapsiblePanelTag JSP &ui_panel_attributes; &html_universal_attributes; &html_event_handler_attributes; &user_role_attributes; collapsed false false Boolean value indicating whether the panel should be collapsed by default. value false false Label for collapsible panel. selectOneCountry org.apache.myfaces.custom.selectOneCountry.SelectOneCountryTag JSP A localized list of countries choose box. The value binds to the country ISO 3166 code. The official codes list is available here : http://www.iso.ch/iso/en/prods-services/iso3166ma/02iso-3166-code-lists/list-en1.html maxLength false false Integer equals to the maximum number of characters in the country name. &standard_select_one_menu_attributes; &user_role_attributes; &ext_forceId_attribute; stylesheet org.apache.myfaces.custom.stylesheet.StylesheetTag JSP a component, which renders the path to a common CSS-file &ui_component_attributes; &user_role_attributes; path true false URL for CSS-file. div org.apache.myfaces.custom.div.DivTag JSP Places a div around its children &ui_component_attributes; &ext_forceId_attribute; style false false The style to use for this div. Either style or styleClass must be specified but not both. styleClass false false The class to use for this div. Either style or styleClass must be specified but not both. radio org.apache.myfaces.custom.radio.HtmlRadioTag JSP Renders a HTML input of type "radio". The associated SelectItem comes from an extended selectOneRadio component with layout "spread". The selectOneRadio is referenced by the "for" attribute. All HTML pass-through attributes for this input are taken from the associated selectOneRadio. &ui_component_attributes; &user_role_attributes; for true false id of the referenced extended selectOneRadio component index true false n-th SelectItem of referenced UISelectOne starting with 0. rssTicker org.apache.myfaces.custom.rssticker.HtmlRssTickerTag JSP Extends standard commandButton by user role support. &html_universal_attributes; rssUrl true false URL on whichs the rss-information are available. tree org.apache.myfaces.custom.tree.taglib.TreeTag JSP id false false value true false var false false styleClass false false nodeClass false false selectedNodeClass false false headerClass false false footerClass false false rowClasses false false columnClasses false false iconClass false false iconLine false false iconNoline false false iconChildFirst false false iconChildMiddle false false iconChildLast false false iconNodeOpen false false iconNodeOpenFirst false false iconNodeOpenMiddle false false iconNodeOpenLast false false iconNodeClose false false iconNodeCloseFirst false false iconNodeCloseMiddle false false iconNodeCloseLast false false expandRoot false false expireListeners false false Time interval the tree will remain registered as a TreeModelListener without being accessed treeSelectionListener org.apache.myfaces.custom.tree.taglib.TreeSelectionListenerTag empty type true false iconProvider org.apache.myfaces.custom.tree.taglib.IconProviderTag empty type true false treeColumn org.apache.myfaces.custom.tree.taglib.TreeColumnTag JSP Renders a HTML input of type "treeColumn". This tag outlines the column where the tree structure will be render as part of the tree table. &ui_component_attributes; treeCheckbox org.apache.myfaces.custom.tree.taglib.TreeCheckboxTag empty Renders a HTML input of type "treeCheckbox". The associated comes from the treeCheckbox itemLabel and itemValue. The selected items come from an extended selectManyCheckbox component with layout "spread". The selectManyCheckbox is referenced by the "for" attribute. All HTML pass-through attributes for this input are taken from the associated selectManyCheckbox. &ui_select_item_attributes; for true false id of the referenced extended selectManyCheckbox component tree2 org.apache.myfaces.custom.tree2.TreeTag JSP id true false value true false var false false varNodeToggler false false showNav false false Show the "plus" and "minus" navigation icons (default is true.) Value is ignored if clientSideToggle is true. showLines false false Show the connecting lines (default is true.) clientSideToggle false false Perform client-side toggling of expand/collapse state via javascript (default is true.) showRootNode false false Include the root node when rendering the tree (default is true.) &alt_location_attributes; &ui_component_attributes; panelStack org.apache.myfaces.custom.panelstack.PanelStackTag JSP id false false selectedPanel true false Id of the child to be rendered. popup org.apache.myfaces.custom.popup.HtmlPopupTag JSP Renders a popup which displays on a mouse event. styleClass false false styleClass for popup. Attention! do not try to overwrite position:absolute; and display:none; Provide a padding for Mozilla-based Browsers style false false style for popup. Attention! do not try to overwrite position:absolute; and display:none; Provide a padding for Mozilla-based Browsers displayAtDistanceX false false Pop the panel up in horizontal distance of x pixels from event. displayAtDistanceY false false Pop the panel up in vertical distance of y pixels from event. closePopupOnExitingElement false false Close the popup when the triggering element is left. closePopupOnExitingPopup false false Close the popup when the popup itself is left. &ui_panel_attributes; &html_universal_attributes; &html_event_handler_attributes; &user_role_attributes; newspaperTable org.apache.myfaces.custom.newspaper.HtmlNewspaperTableTag JSP A data table for rendering long skinny tables as short wide table by wrapping the table over a specified number of columns. &standard_data_table_attributes; newspaperColumns false false The number of columns to wrap the table over. Default: 1 aliasBean org.apache.myfaces.custom.aliasbean.AliasBeanTag JSP A tage that defines a new bean (alias) with a given value. This allows you to design a subform with a fictive bean and to include it in all the pages where you use it. You just need to make an alias to the real bean named after the fictive bean before including the subform. id false false alias true false The name of the bean that will be set to the given value. value true false The value that the alias can be set to. This can be a string (like "toto") or a reference to an existing bean (like "#{myBean.member1}"). buffer org.apache.myfaces.custom.buffer.BufferTag JSP into true false saveState org.apache.myfaces.custom.savestate.SaveStateTag JSP id false false value true false updateActionListener org.apache.myfaces.custom.updateactionlistener.UpdateActionListenerTag JSP Registers a org.apache.myfaces.custom.updateactionlistener.UpdateActionListener at the parent component. property true false value true false converter false false validateCreditCard org.apache.myfaces.custom.creditcardvalidator.ValidateCreditCardTag JSP A custom validator for creditCards, based upons Jakarta Commons. none false false none of the given cardtypes is allowed. amex false false american express cards visa false false validation for visa mastercard false false validation for mastercard discover false false validation for discover validateEmail org.apache.myfaces.custom.emailvalidator.ValidateEmailTag JSP A custom validator for email address format, based upons Jakarta Commons. validateISBN org.apache.myfaces.custom.isbnvalidator.ValidateISBNTag JSP A custom validator for isbn codes, based upons Jakarta Commons. validateRegExpr org.apache.myfaces.custom.regexprvalidator.ValidateRegExprTag JSP A custom validator for reg. expr., based upons Jakarta Commons. pattern true false the pattern, which is the base of the validation validateEqual org.apache.myfaces.custom.equalvalidator.ValidateEqualTag JSP A custom validator for validations against foreign component values. for true false the id of the foreign component, which is needed for the validation swapImage org.apache.myfaces.custom.swapimage.HtmlSwapImageTag JSP swapImageUrl true false the url of the image displayed onmouseover activeImageUrl false false activeImage will be rendered if: swapImage is a direct child of commandNavigation and the commandNavigation.isActive &ui_graphic_attributes; &html_universal_attributes; &html_img_attributes; onclick false false ondblclick false false onkeypress false false onkeydown false false onkeyup false false columns org.apache.myfaces.custom.crosstable.HtmlColumnsTag JSP &ui_component_attributes; &ui_column_attributes; value true false Supported types see JSF Spec 4.1.3 var true false