1.0 1.2 fc Extentions of JavaServer Faces for Fenix Project htmlEditor net.sourceforge.fenixedu.presentationTier.jsf.components.UIHtmlEditorTag com.sun.faces.taglib.FacesTagExtraInfo empty binding false false Value binding expression to a backing bean property bound to the component instance for the UIComponent created by this custom action. id false false Component identifier of the UISelectItem component to be created. value false false Value binding expression pointing at a SelectItem instance containing the information for this option. rendered false false Flag indicating whether this component (and its children) should be rendered. Expressions must evaluate to a boolean. width true false height true false showButtons false false required false false maxLength false false viewState net.sourceforge.fenixedu.presentationTier.jsf.components.UIViewStateTag com.sun.faces.taglib.FacesTagExtraInfo empty binding false false Value binding expression to a backing bean property bound to the component instance for the UIComponent created by this custom action. id false false Component identifier of the UISelectItem component to be created. value false false Value binding expression pointing at a SelectItem instance containing the information for this option. regexValidator net.sourceforge.fenixedu.presentationTier.jsf.validators.RegexValidatorTag com.sun.faces.taglib.FacesTagExtraInfo empty regex true false commandLink net.sourceforge.fenixedu.presentationTier.jsf.components.UICommandLinkTag com.sun.faces.taglib.FacesTagExtraInfo JSP Render an HTML "a" anchor element that acts like a form submit button when clicked.

General Behaviour

Both the encode and decode behavior require the ability to get the id/name for a hidden field whose value is set by the JavaScript form submit. This name must be constructed as follows:

  • Get the clientId for the form of which this component is a child.

  • AppendNamingContainer.SEPARATOR_CHAR.

  • Append a constant string that is the same for all command link components in the tree.

In the following text, this String is called hiddenFieldName.

Decode Behavior

    Obtain the "clientId" property of the component. Obtain theMap from the "requestParameterMap" property of theExternalContext. Derive hiddenFieldName as above. Get the entry in the Map under the key that is the hiddenFieldName. If the there is no entry, or the entry is the empty String, or the entry is not equal to the value of the "clientId" property, return immediately. If there is an entry, and its value is equal to the value of the "clientId" property, create a new javax.faces.event.ActionEvent instance around the component and call queueActionEvent() on the component, passing the event.

Encode Behavior

    Render "#" as the value of the "href" attribute. Render the current value of the component as the link text if it is specified. Render javascript that is functionally equivalent to the following as the value of the "onclick" attribute:

    document.forms['CLIENT_ID']['hiddenFieldName'].value='CLIENT_ID'; document.forms['CLIENT_ID']['PARAM1_NAME'].value='PARAM1_VALUE'; document.forms['CLIENT_ID']['PARAM2_NAME'].value='PARAM2_VALUE'; return false;

    document.forms['CLIENT_ID'].submit()" where hiddenFieldName isas described above, CLIENT_ID is the clientId of the UICommand component, PARAM*_NAME and PARAM*_VALUE are the names and values, respectively, of any nested UIParameter children. The name and the value must be URLEncoded. If the "styleClass" attribute is specified, render its value as the value of the "class" attribute. Render any non-UIParameter children as normal inside of the "a" element. These will appear as the link text. Allow the form renderer to output a single "input" element (for the entire page, regardless of how many command link components are in the page) of "type" "hidden" whose "name" is the value of hiddenFieldName, and which must not have a "value" attribute. Multiple occurrences of command link components in the tree should not cause multiple hiddenFieldName hidden fields. Allow the form renderer to output an "input" element of "type" "hidden" for each of the nested UIParameter children, taking the name property (but not the value) from each one in turn.

]]> action false false MethodBinding representing the application action to invoke when this component is activated by the user. The expression must evaluate to a public method that takes no parameters, and returns a String (the logical outcome) which is passed to the NavigationHandler for this application. actionListener false false MethodBinding representing an action listener method that will be notified when this component is activated by the user. The expression must evaluate to a public method that takes an ActionEvent parameter, with a return type of void. id false false The component identifier for this component. This value must be unique within the closest parent component that is a naming container. immediate false false Flag indicating that, if this component is activated by the user, notifications should be delivered to interested listeners and actions immediately (that is, during Apply Request Values phase) rather than waiting until Invoke Application phase. rendered false false Flag indicating whether or not this component should be rendered (during Render Response Phase), or processed on any subsequent form submit. value false false The current value of this component. accesskey false false Access key that, when pressed, transfers focus to this element. charset false false The character encoding of the resource designated by this hyperlink. coords false false The position and shape of the hot spot on the screen (for use in client-side image maps). dir false false Direction indication for text that does not inherit directionality. Valid values are "LTR" (left-to-right) and "RTL" (right-to-left). hreflang false false The language code of the resource designated by this hyperlink. lang false false Code describing the language used in the generated markup for this component. onblur false false Javascript code executed when this element loses focus. ondblclick false false Javascript code executed when a pointer button is double clicked over this element. onfocus false false Javascript code executed when this element receives focus. onkeydown false false Javascript code executed when a key is pressed down over this element. onkeypress false false Javascript code executed when a key is pressed and released over this element. onkeyup false false Javascript code executed when a key is released over this element. onmousedown false false Javascript code executed when a pointer button is pressed down over this element. onmousemove false false Javascript code executed when a pointer button is moved within this element. onmouseout false false Javascript code executed when a pointer button is moved away from this element. onmouseover false false Javascript code executed when a pointer button is moved onto this element. onmouseup false false Javascript code executed when a pointer button is released over this element. rel false false The relationship from the current document to the anchor specified by this hyperlink. The value of this attribute is a space-separated list of link types. rev false false A reverse link from the anchor specified by this hyperlink to the current document. The value of this attribute is a space-separated list of link types. shape false false The shape of the hot spot on the screen (for use in client-side image maps). Valid values are: default (entire region); rect (rectangular region); circle (circular region); and poly (polygonal region). style false false CSS style(s) to be applied when this component is rendered. styleClass false false Space-separated list of CSS style class(es) to be applied when this element is rendered. This value must be passed through as the "class" attribute on generated markup. tabindex false false Position of this element in the tabbing order for the current document. This value must be an integer between 0 and 32767. target false false Name of a frame where the resource retrieved via this hyperlink is to be displayed. title false false Advisory title information about markup elements generated for this component. type false false The content type of the resource designated by this hyperlink. binding false false The value binding expression linking this component to a property in a backing bean commandButton net.sourceforge.fenixedu.presentationTier.jsf.components.UICommandButtonTag com.sun.faces.taglib.FacesTagExtraInfo JSP Renders an HTML "input" element.

Decode Behavior

    Obtain the Map from the "requestParameterMap" property of the ExternalContext. If the value in theMap for the value of the "clientId" property of the component is null, create a String by concatenating the value of the "clientId" property of the component with the String ".x" (without the quotes). Create another String in the same manner, but concatenate ".y" (without the quotes). Ifnull is the value in the Map for both Strings, return from decode(). If the value in theMap for the value of the "clientId" property of the component is not null, get the value of the "type" attribute, and convert it to lower case. If the result is equal to the String "reset" (without the quotes), return fromdecode(). Otherwise, create ajavax.faces.event.ActionEvent around the component, and pass it to the queueEvent() method of the component, which must be an instance ofUICommand.

Encode Behavior

    Render the clientId of the component as the value of the "name" attribute. Render the current value of the component as the value of the "value" attribute. If the "styleClass" attribute is specified, render its value as the value of the "class" attribute.

]]> action false false MethodBinding representing the application action to invoke when this component is activated by the user. The expression must evaluate to a public method that takes no parameters, and returns a String (the logical outcome) which is passed to the NavigationHandler for this application. actionListener false false MethodBinding representing an action listener method that will be notified when this component is activated by the user. The expression must evaluate to a public method that takes an ActionEvent parameter, with a return type of void. id false false The component identifier for this component. This value must be unique within the closest parent component that is a naming container. immediate false false Flag indicating that, if this component is activated by the user, notifications should be delivered to interested listeners and actions immediately (that is, during Apply Request Values phase) rather than waiting until Invoke Application phase. rendered false false Flag indicating whether or not this component should be rendered (during Render Response Phase), or processed on any subsequent form submit. value false false The current value of this component. accesskey false false Access key that, when pressed, transfers focus to this element. alt false false Alternate textual description of the element rendered by this component. dir false false Direction indication for text that does not inherit directionality. Valid values are "LTR" (left-to-right) and "RTL" (right-to-left). disabled false false Flag indicating that this element must never receive focus or be included in a subsequent submit. image false false Absolute or relative URL of the image to be displayed for this button. If specified, this "input" element will be of type "image". Otherwise, it will be of the type specified by the "type" property with a label specified by the "value" property. lang false false Code describing the language used in the generated markup for this component. onblur false false Javascript code executed when this element loses focus. onchange false false Javascript code executed when this element loses focus and its value has been modified since gaining focus. onclick false false Javascript code executed when a pointer button is clicked over this element. ondblclick false false Javascript code executed when a pointer button is double clicked over this element. onfocus false false Javascript code executed when this element receives focus. onkeydown false false Javascript code executed when a key is pressed down over this element. onkeypress false false Javascript code executed when a key is pressed and released over this element. onkeyup false false Javascript code executed when a key is released over this element. onmousedown false false Javascript code executed when a pointer button is pressed down over this element. onmousemove false false Javascript code executed when a pointer button is moved within this element. onmouseout false false Javascript code executed when a pointer button is moved away from this element. onmouseover false false Javascript code executed when a pointer button is moved onto this element. onmouseup false false Javascript code executed when a pointer button is released over this element. onselect false false Javascript code executed when text within this element is selected by the user. readonly false false Flag indicating that this component will prohibit changes by the user. The element may receive focus unless it has also been disabled. style false false CSS style(s) to be applied when this component is rendered. styleClass false false Space-separated list of CSS style class(es) to be applied when this element is rendered. This value must be passed through as the "class" attribute on generated markup. tabindex false false Position of this element in the tabbing order for the current document. This value must be an integer between 0 and 32767. title false false Advisory title information about markup elements generated for this component. type false false Type of button to create. Valid values are "submit" and "reset". If not specified, or not a valid value, the default value is "submit". binding false false The value binding expression linking this component to a property in a backing bean selectOneMenu net.sourceforge.fenixedu.presentationTier.jsf.components.UISelectOneTag com.sun.faces.taglib.FacesTagExtraInfo JSP Render an HTML option list.

Decode Behavior

Encode Behavior

    Render an HTML "select" element. Render the clientId of the component as the value of the "name" attribute. If the "styleClass" attribute is specified, render its value as the value of the "class" attribute on the "select" element. If the component to be rendered is a UISelectMany, render "true" as the value of the "multiple" attribute. Use the number of items as the value of the "size" attribute. See the "Rendering the option elements" specification forListboxRenderer for more detail on how to render the "option" elements in this renderer.

]]> converter false false Converter instance registered with this component. id false false The component identifier for this component. This value must be unique within the closest parent component that is a naming container. immediate false false Flag indicating that this component's value must be converted and validated immediately (that is, during Apply Request Values phase), rather than waiting until Process Validations phase. rendered false false Flag indicating whether or not this component should be rendered (during Render Response Phase), or processed on any subsequent form submit. required false false Flag indicating that the user is required to provide a submitted value for this input component. validator false false MethodBinding representing a validator method that will be called during Process Validations to perform correctness checks on the value of this component. The expression must evaluate to a public method that takes FacesContext, UIComponent, and Object parameters, with a return type of void. value false false The current value of this component. valueChangeListener false false MethodBinding representing a value change listener method that will be notified when a new value has been set for this input component. The expression must evaluate to a public method that takes a ValueChangeEvent parameter, with a return type of void. accesskey false false Access key that, when pressed, transfers focus to this element. dir false false Direction indication for text that does not inherit directionality. Valid values are "LTR" (left-to-right) and "RTL" (right-to-left). disabled false false Flag indicating that this element must never receive focus or be included in a subsequent submit. disabledClass false false CSS style class to apply to the rendered label on disabled options. enabledClass false false CSS style class to apply to the rendered label on enabled options. lang false false Code describing the language used in the generated markup for this component. onblur false false Javascript code executed when this element loses focus. onchange false false Javascript code executed when this element loses focus and its value has been modified since gaining focus. onclick false false Javascript code executed when a pointer button is clicked over this element. ondblclick false false Javascript code executed when a pointer button is double clicked over this element. onfocus false false Javascript code executed when this element receives focus. onkeydown false false Javascript code executed when a key is pressed down over this element. onkeypress false false Javascript code executed when a key is pressed and released over this element. onkeyup false false Javascript code executed when a key is released over this element. onmousedown false false Javascript code executed when a pointer button is pressed down over this element. onmousemove false false Javascript code executed when a pointer button is moved within this element. onmouseout false false Javascript code executed when a pointer button is moved away from this element. onmouseover false false Javascript code executed when a pointer button is moved onto this element. onmouseup false false Javascript code executed when a pointer button is released over this element. onselect false false Javascript code executed when text within this element is selected by the user. readonly false false Flag indicating that this component will prohibit changes by the user. The element may receive focus unless it has also been disabled. style false false CSS style(s) to be applied when this component is rendered. styleClass false false Space-separated list of CSS style class(es) to be applied when this element is rendered. This value must be passed through as the "class" attribute on generated markup. tabindex false false Position of this element in the tabbing order for the current document. This value must be an integer between 0 and 32767. title false false Advisory title information about markup elements generated for this component. binding false false The value binding expression linking this component to a property in a backing bean fenixCalendar net.sourceforge.fenixedu.presentationTier.jsf.components.FenixCalendarTag Fenix Generic Calendar id false false rendered false false begin true false Begin date of the Evaluation Calendar. Type: java.util.Calendar end true false End date of the Evaluation Calendar. Type: java.util.Calendar createLink false false Full link to set on every date of the calendar, forwarding to the create object interface. Type: String editLinkPage true false Page link to set on a edit link of a certain object in the a given date of the calendar. Type: String editLinkParameters true false List of CalendarLinks of objects to print on specific dates of the calendar. Type: List extraLines false false Include extra empty lines in calendar entries degreeCurricularPlanRender net.sourceforge.fenixedu.presentationTier.jsf.components.degreeStructure.DegreeCurricularPlanTag Fenix Degree Curricular Plan Render id false false rendered false false dcp true false Degree Curricular Plan to be rendered. Type: net.sourceforge.fenixedu.domain.DegreeCurricularPlan toEdit false false Indicates if edit options are to be available. Type: java.lang.Boolean. Default: false showRules false true Render rules and corresponding options. Type: java.lang.Boolean. Default: false organizeBy false true Groups or Years. Type: java.lang.String. Default: groups onlyStructure false false Indicates if only course groups should be rendered. Type: java.lang.Boolean. Default: false toOrder false true Indicates if order options are to be available. Valid if onlyStructure is true. Type: java.lang.Boolean. Default: false hideCourses false true Indicates if curricular courses are to be displayed or not. Valid if onlyStructure is false. Type: java.lang.Boolean. Default: false executionYear false true If present, contexts are filtered accordingly. Type: net.sourceforge.fenixedu.domain.ExecutionYear. Default: false reportsAvailable false true Indicates if course group reports links are to be available. Type: java.lang.Boolean. Default: false breadCrumbs net.sourceforge.fenixedu.presentationTier.jsf.components.BreadCrumbsTag Public page bread crumbs rendered false false degree true false trailingCrumb true false dataRepeater net.sourceforge.fenixedu.presentationTier.jsf.components.UIDataRepeaterTag com.sun.faces.taglib.FacesTagExtraInfo JSP first false false Zero-relative row number of the first row to be displayed. If this property is set to zero, rendering will begin with the first row of the underlying data. id false false The component identifier for this component. This value must be unique within the closest parent component that is a naming container. rendered false false Flag indicating whether or not this component should be rendered (during Render Response Phase), or processed on any subsequent form submit. rows false false The number of rows to display, starting with the one identified by the "first" property. If this value is set to zero, all available rows in the underlying data model will be displayed. value false false The current value of this component. var false false Name of a request-scope attribute under which the model data for the row selected by the current value of the "rowIndex" property (i.e. also the current value of the "rowData" property) will be exposed. bgcolor false false Name or code of the background color for this table. border false false Width (in pixels) of the border to be drawn around this table. binding false false The value binding expression linking this component to a property in a backing bean rowIndexVar false false rowCountVar false false dateValidator net.sourceforge.fenixedu.presentationTier.jsf.validators.DateValidatorTag com.sun.faces.taglib.FacesTagExtraInfo empty format true false strict true false autoComplete net.sourceforge.fenixedu.presentationTier.jsf.components.UIAutoCompleteTag com.sun.faces.taglib.FacesTagExtraInfo empty id false false Component identifier of the UISelectItem component to be created. binding false false binding for component rendered false false Flag indicating whether this component (and its children) should be rendered. Expressions must evaluate to a boolean. inputTextArgName true false labelField true false valueField true false serviceName true false serviceArgs true false autoCompleteStyleClass true false autoCompleteItemsStyleClass true false textFieldStyleClass false false value false false className true false required true false size false false extendedOutputText net.sourceforge.fenixedu.presentationTier.jsf.components.UIExtendedOutputTextTag com.sun.faces.taglib.FacesTagExtraInfo JSP If the "styleClass" or "style" attributes are present, render a "span" element. If the "styleClass" attribute is present, render its value as the value of the "class" attribute. If the "style" attribute is present, pass it thru. If the "escape" attribute is not present, or it is present and its value is "true" all angle brackets should be converted to the ampersand xx semicolon syntax when rendering the value of the "value" attribute as the value of the component. If the "escape" attribute is present and is "false" the value of the component should be rendered as text without escaping. converter false false Converter instance registered with this component. id false false The component identifier for this component. This value must be unique within the closest parent component that is a naming container. rendered false false Flag indicating whether or not this component should be rendered (during Render Response Phase), or processed on any subsequent form submit. value false false The current value of this component. escape false false Flag indicating that characters that are sensitive in HTML and XML markup must be escaped. This flag is set to "true" by default. style false false CSS style(s) to be applied when this component is rendered. styleClass false false Space-separated list of CSS style class(es) to be applied when this element is rendered. This value must be passed through as the "class" attribute on generated markup. title false false Advisory title information about markup elements generated for this component. binding false false The value binding expression linking this component to a property in a backing bean linebreak false false The linebreak attribute, when true, replace all string line breaks for html line breaks. Default value is false.