com.sun.faces.taglib.jsf_core

Class SelectItemTag

java.lang.Object

jakarta.faces.webapp.UIComponentTagBase

jakarta.faces.webapp.UIComponentClassicTagBase

jakarta.faces.webapp.UIComponentELTag

com.sun.faces.taglib.jsf_core.SelectItemTag

All Implemented Interfaces:

jakarta.servlet.jsp.tagext.BodyTag, jakarta.servlet.jsp.tagext.IterationTag, jakarta.servlet.jsp.tagext.JspIdConsumer, jakarta.servlet.jsp.tagext.JspTag, jakarta.servlet.jsp.tagext.Tag

public class SelectItemTag
extends jakarta.faces.webapp.UIComponentELTag

This class is the tag handler that evaluates the selectitem custom tag.

Field Summary

Fields

Modifier and Type	Field and Description
protected jakarta.el.ValueExpression	itemDescription
protected jakarta.el.ValueExpression	itemDisabled
protected jakarta.el.ValueExpression	itemLabel
protected jakarta.el.ValueExpression	itemValue
protected jakarta.el.ValueExpression	noSelectionOption
protected jakarta.el.ValueExpression	value

Fields inherited from class jakarta.faces.webapp.UIComponentClassicTagBase

bodyContent, pageContext, UNIQUE_ID_PREFIX

Fields inherited from class jakarta.faces.webapp.UIComponentTagBase

log

Fields inherited from interface jakarta.servlet.jsp.tagext.Tag

EVAL_BODY_INCLUDE, EVAL_PAGE, SKIP_BODY, SKIP_PAGE

Fields inherited from interface jakarta.servlet.jsp.tagext.BodyTag

EVAL_BODY_BUFFERED, EVAL_BODY_TAG

Fields inherited from interface jakarta.servlet.jsp.tagext.IterationTag

EVAL_BODY_AGAIN

Constructor Summary

Constructors

Constructor and Description
SelectItemTag()

Method Summary

Modifier and Type	Method and Description
String	getComponentType() Return the component type for the component that is or will be bound to this tag.
jakarta.el.ValueExpression	getEscape() Getter for property escape.
String	getRendererType() Return the rendererType property that selects the Renderer to be used for encoding this component, or null to ask the component to render itself directly.
void	setEscape(jakarta.el.ValueExpression escape) Setter for property escape.
void	setItemDescription(jakarta.el.ValueExpression itemDescription)
void	setItemDisabled(jakarta.el.ValueExpression itemDisabled)
void	setItemLabel(jakarta.el.ValueExpression label)
void	setItemValue(jakarta.el.ValueExpression value)
void	setNoSelectionOption(jakarta.el.ValueExpression noSelectionOption)
protected void	setProperties(jakarta.faces.component.UIComponent component) Override properties and attributes of the specified component, if the corresponding properties of this tag handler instance were explicitly set.
void	setValue(jakarta.el.ValueExpression value)

Methods inherited from class jakarta.faces.webapp.UIComponentELTag

createComponent, getELContext, hasBinding, release, setBinding, setRendered

Methods inherited from class jakarta.faces.webapp.UIComponentClassicTagBase

addChild, addFacet, addVerbatimAfterComponent, addVerbatimBeforeComponent, createVerbatimComponent, createVerbatimComponentFromBodyContent, doAfterBody, doEndTag, doInitBody, doStartTag, encodeBegin, encodeChildren, encodeEnd, findComponent, getBodyContent, getComponentInstance, getCreated, getCreatedComponents, getDoAfterBodyValue, getDoEndValue, getDoStartValue, getFacesContext, getFacesJspId, getFacetName, getId, getIndexOfNextChildTag, getJspId, getParent, getParentUIComponentClassicTagBase, getPreviousOut, setBodyContent, setId, setJspId, setPageContext, setParent, setupResponseWriter

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface jakarta.servlet.jsp.tagext.Tag

doEndTag, doStartTag, getParent, setPageContext, setParent

Field Detail

itemValue

protected jakarta.el.ValueExpression itemValue

itemLabel

protected jakarta.el.ValueExpression itemLabel

itemDescription

protected jakarta.el.ValueExpression itemDescription

itemDisabled

protected jakarta.el.ValueExpression itemDisabled

noSelectionOption

protected jakarta.el.ValueExpression noSelectionOption

value

protected jakarta.el.ValueExpression value

Constructor Detail

SelectItemTag

public SelectItemTag()

Method Detail

setItemValue

public void setItemValue(jakarta.el.ValueExpression value)

setItemLabel

public void setItemLabel(jakarta.el.ValueExpression label)

setItemDescription

public void setItemDescription(jakarta.el.ValueExpression itemDescription)

setItemDisabled

public void setItemDisabled(jakarta.el.ValueExpression itemDisabled)

setValue

public void setValue(jakarta.el.ValueExpression value)

setNoSelectionOption

public void setNoSelectionOption(jakarta.el.ValueExpression noSelectionOption)

getRendererType

public String getRendererType()

Description copied from class: jakarta.faces.webapp.UIComponentTagBase

Return the rendererType property that selects the Renderer to be used for encoding this component, or null to ask the component to render itself directly. Subclasses must override this method to return the appropriate value.

Specified by:

getRendererType in class jakarta.faces.webapp.UIComponentTagBase

Returns:

the renderer type

getComponentType

public String getComponentType()

Description copied from class: jakarta.faces.webapp.UIComponentTagBase

Return the component type for the component that is or will be bound to this tag. This value can be passed to Application.createComponent(java.lang.String) to create the UIComponent instance for this tag. Subclasses must override this method to return the appropriate value.

Specified by:

getComponentType in class jakarta.faces.webapp.UIComponentTagBase

Returns:

the component type

setProperties

protected void setProperties(jakarta.faces.component.UIComponent component)

Description copied from class: jakarta.faces.webapp.UIComponentELTag

Override properties and attributes of the specified component, if the corresponding properties of this tag handler instance were explicitly set. This method must be called ONLY if the specified UIComponent was in fact created during the execution of this tag handler instance, and this call will occur BEFORE the UIComponent is added to the view.

Tag subclasses that want to support additional set properties must ensure that the base class setProperties() method is still called. A typical implementation that supports extra properties foo and bar would look something like this:

 protected void setProperties(UIComponent component) {
     super.setProperties(component);
     if (foo != null) {
         component.setAttribute("foo", foo);
     }
     if (bar != null) {
         component.setAttribute("bar", bar);
     }
 }
 

The default implementation overrides the following properties:

• rendered - Set if a value for the rendered property is specified for this tag handler instance.
• rendererType - Set if the getRendererType() method returns a non-null value.

Overrides:

setProperties in class jakarta.faces.webapp.UIComponentELTag

Parameters:

component - UIComponent whose properties are to be overridden

getEscape

public jakarta.el.ValueExpression getEscape()

Getter for property escape.

Returns:

Value of property escape.

setEscape

public void setEscape(jakarta.el.ValueExpression escape)

Setter for property escape.

Parameters:

escape - New value of property escape.