Class HtmlPanelGrid
- java.lang.Object
-
- jakarta.faces.component.UIComponent
-
- jakarta.faces.component.UIComponentBase
-
- jakarta.faces.component.UIPanel
-
- jakarta.faces.component.html.HtmlPanelGrid
-
- All Implemented Interfaces:
ClientBehaviorHolder,PartialStateHolder,StateHolder,TransientStateHolder,ComponentSystemEventListener,FacesListener,SystemEventListenerHolder,EventListener
public class HtmlPanelGrid extends UIPanel implements ClientBehaviorHolder
Renders child components in a table, starting a new row after the specified number of columns.
By default, the
rendererTypeproperty must be set to "jakarta.faces.Grid". This value can be changed by calling thesetRendererType()method.
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description protected static classHtmlPanelGrid.PropertyKeysProperties used by this component
-
Field Summary
Fields Modifier and Type Field Description static StringCOMPONENT_TYPEThe standard component type for this component.-
Fields inherited from class jakarta.faces.component.UIPanel
COMPONENT_FAMILY
-
Fields inherited from class jakarta.faces.component.UIComponent
ATTRS_WITH_DECLARED_DEFAULT_VALUES, BEANINFO_KEY, bindings, COMPOSITE_COMPONENT_TYPE_KEY, COMPOSITE_FACET_NAME, FACETS_KEY, VIEW_LOCATION_KEY
-
-
Constructor Summary
Constructors Constructor Description HtmlPanelGrid()
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description StringgetBgcolor()Return the value of thebgcolorproperty.StringgetBodyrows()Return the value of thebodyrowsproperty.intgetBorder()Return the value of theborderproperty.StringgetCaptionClass()Return the value of thecaptionClassproperty.StringgetCaptionStyle()Return the value of thecaptionStyleproperty.StringgetCellpadding()Return the value of thecellpaddingproperty.StringgetCellspacing()Return the value of thecellspacingproperty.StringgetColumnClasses()Return the value of thecolumnClassesproperty.intgetColumns()Return the value of thecolumnsproperty.StringgetDefaultEventName()This is a default implementation ofClientBehaviorHolder.getDefaultEventName().StringgetDir()Return the value of thedirproperty.Collection<String>getEventNames()This is a default implementation ofClientBehaviorHolder.getEventNames().StringgetFooterClass()Return the value of thefooterClassproperty.StringgetFrame()Return the value of theframeproperty.StringgetHeaderClass()Return the value of theheaderClassproperty.StringgetLang()Return the value of thelangproperty.StringgetOnclick()Return the value of theonclickproperty.StringgetOndblclick()Return the value of theondblclickproperty.StringgetOnkeydown()Return the value of theonkeydownproperty.StringgetOnkeypress()Return the value of theonkeypressproperty.StringgetOnkeyup()Return the value of theonkeyupproperty.StringgetOnmousedown()Return the value of theonmousedownproperty.StringgetOnmousemove()Return the value of theonmousemoveproperty.StringgetOnmouseout()Return the value of theonmouseoutproperty.StringgetOnmouseover()Return the value of theonmouseoverproperty.StringgetOnmouseup()Return the value of theonmouseupproperty.StringgetRole()Return the value of theroleproperty.StringgetRowClass()Return the value of therowClassproperty.StringgetRowClasses()Return the value of therowClassesproperty.StringgetRules()Return the value of therulesproperty.StringgetStyle()Return the value of thestyleproperty.StringgetStyleClass()Return the value of thestyleClassproperty.StringgetSummary()Return the value of thesummaryproperty.StringgetTitle()Return the value of thetitleproperty.StringgetWidth()Return the value of thewidthproperty.voidsetBgcolor(String bgcolor)Set the value of thebgcolorproperty.voidsetBodyrows(String bodyrows)Set the value of thebodyrowsproperty.voidsetBorder(int border)Set the value of theborderproperty.voidsetCaptionClass(String captionClass)Set the value of thecaptionClassproperty.voidsetCaptionStyle(String captionStyle)Set the value of thecaptionStyleproperty.voidsetCellpadding(String cellpadding)Set the value of thecellpaddingproperty.voidsetCellspacing(String cellspacing)Set the value of thecellspacingproperty.voidsetColumnClasses(String columnClasses)Set the value of thecolumnClassesproperty.voidsetColumns(int columns)Set the value of thecolumnsproperty.voidsetDir(String dir)Set the value of thedirproperty.voidsetFooterClass(String footerClass)Set the value of thefooterClassproperty.voidsetFrame(String frame)Set the value of theframeproperty.voidsetHeaderClass(String headerClass)Set the value of theheaderClassproperty.voidsetLang(String lang)Set the value of thelangproperty.voidsetOnclick(String onclick)Set the value of theonclickproperty.voidsetOndblclick(String ondblclick)Set the value of theondblclickproperty.voidsetOnkeydown(String onkeydown)Set the value of theonkeydownproperty.voidsetOnkeypress(String onkeypress)Set the value of theonkeypressproperty.voidsetOnkeyup(String onkeyup)Set the value of theonkeyupproperty.voidsetOnmousedown(String onmousedown)Set the value of theonmousedownproperty.voidsetOnmousemove(String onmousemove)Set the value of theonmousemoveproperty.voidsetOnmouseout(String onmouseout)Set the value of theonmouseoutproperty.voidsetOnmouseover(String onmouseover)Set the value of theonmouseoverproperty.voidsetOnmouseup(String onmouseup)Set the value of theonmouseupproperty.voidsetRole(String role)Set the value of theroleproperty.voidsetRowClass(String rowClass)Set the value of therowClassproperty.voidsetRowClasses(String rowClasses)Set the value of therowClassesproperty.voidsetRules(String rules)Set the value of therulesproperty.voidsetStyle(String style)Set the value of thestyleproperty.voidsetStyleClass(String styleClass)Set the value of thestyleClassproperty.voidsetSummary(String summary)Set the value of thesummaryproperty.voidsetTitle(String title)Set the value of thetitleproperty.voidsetWidth(String width)Set the value of thewidthproperty.-
Methods inherited from class jakarta.faces.component.UIComponentBase
addClientBehavior, addFacesListener, broadcast, clearInitialState, decode, encodeBegin, encodeChildren, encodeEnd, findComponent, getAttributes, getChildCount, getChildren, getClientBehaviors, getClientId, getFacesContext, getFacesListeners, getFacet, getFacetCount, getFacets, getFacetsAndChildren, getId, getListenersForEventClass, getParent, getPassThroughAttributes, getRenderer, getRendererType, getRendersChildren, invokeOnComponent, isRendered, isTransient, markInitialState, processDecodes, processRestoreState, processSaveState, processUpdates, processValidators, queueEvent, removeFacesListener, restoreAttachedState, restoreState, saveAttachedState, saveState, setId, setParent, setRendered, setRendererType, setTransient, subscribeToEvent, unsubscribeFromEvent
-
Methods inherited from class jakarta.faces.component.UIComponent
encodeAll, getClientId, getCompositeComponentParent, getContainerClientId, getCurrentComponent, getCurrentCompositeComponent, getNamingContainer, getPassThroughAttributes, getResourceBundleMap, getStateHelper, getStateHelper, getTransientStateHelper, getTransientStateHelper, getValueExpression, initialStateMarked, isCompositeComponent, isInView, isVisitable, popComponentFromEL, processEvent, pushComponentToEL, restoreTransientState, saveTransientState, setInView, setValueExpression, visitTree
-
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
-
Methods inherited from interface jakarta.faces.component.behavior.ClientBehaviorHolder
addClientBehavior, getClientBehaviors
-
-
-
-
Field Detail
-
COMPONENT_TYPE
public static final String COMPONENT_TYPE
The standard component type for this component.
- See Also:
- Constant Field Values
-
-
Method Detail
-
getBgcolor
public String getBgcolor()
Return the value of the
bgcolorproperty.- Returns:
- the property value
Contents: Name or code of the background color for this table.
-
setBgcolor
public void setBgcolor(String bgcolor)
Set the value of the
bgcolorproperty.- Parameters:
bgcolor- the new property value
-
getBodyrows
public String getBodyrows()
Return the value of the
bodyrowsproperty.- Returns:
- the property value
Contents: Comma separated list of row indices for which a new "tbody" element should be started (and any previously opened one should be ended).
-
setBodyrows
public void setBodyrows(String bodyrows)
Set the value of the
bodyrowsproperty.- Parameters:
bodyrows- the new property value
-
getBorder
public int getBorder()
Return the value of the
borderproperty.- Returns:
- the property value
Contents: Width (in pixels) of the border to be drawn around this table.
-
setBorder
public void setBorder(int border)
Set the value of the
borderproperty.- Parameters:
border- the new property value
-
getCaptionClass
public String getCaptionClass()
Return the value of the
captionClassproperty.- Returns:
- the property value
Contents: Space-separated list of CSS style class(es) that will be applied to any caption generated for this table.
-
setCaptionClass
public void setCaptionClass(String captionClass)
Set the value of the
captionClassproperty.- Parameters:
captionClass- the new property value
-
getCaptionStyle
public String getCaptionStyle()
Return the value of the
captionStyleproperty.- Returns:
- the property value
Contents: CSS style(s) to be applied when this caption is rendered.
-
setCaptionStyle
public void setCaptionStyle(String captionStyle)
Set the value of the
captionStyleproperty.- Parameters:
captionStyle- the new property value
-
getCellpadding
public String getCellpadding()
Return the value of the
cellpaddingproperty.- Returns:
- the property value
Contents: Definition of how much space the user agent should leave between the border of each cell and its contents.
-
setCellpadding
public void setCellpadding(String cellpadding)
Set the value of the
cellpaddingproperty.- Parameters:
cellpadding- the new property value
-
getCellspacing
public String getCellspacing()
Return the value of the
cellspacingproperty.- Returns:
- the property value
Contents: Definition of how much space the user agent should leave between the left side of the table and the leftmost column, the top of the table and the top of the top side of the topmost row, and so on for the right and bottom of the table. It also specifies the amount of space to leave between cells.
-
setCellspacing
public void setCellspacing(String cellspacing)
Set the value of the
cellspacingproperty.- Parameters:
cellspacing- the new property value
-
getColumnClasses
public String getColumnClasses()
Return the value of the
columnClassesproperty.- Returns:
- the property value
Contents: Comma-delimited list of CSS style classes that will be applied to the columns of this table. A space separated list of classes may also be specified for any individual column. If the number of elements in this list is less than the number of actual column children of the UIData, no "class" attribute is output for each column greater than the number of elements in the list. If the number of elements in the list is greater than the number of actual column children of the UIData, the elements at the posisiton in the list after the last column are ignored.
-
setColumnClasses
public void setColumnClasses(String columnClasses)
Set the value of the
columnClassesproperty.- Parameters:
columnClasses- the new property value
-
getColumns
public int getColumns()
Return the value of the
columnsproperty.- Returns:
- the property value
Contents: The number of columns to render before starting a new row.
-
setColumns
public void setColumns(int columns)
Set the value of the
columnsproperty.- Parameters:
columns- the new property value
-
getDir
public String getDir()
Return the value of the
dirproperty.- Returns:
- the property value
Contents: Direction indication for text that does not inherit directionality. Valid values are "LTR" (left-to-right) and "RTL" (right-to-left). These attributes are case sensitive when rendering to XHTML, so care must be taken to have the correct case.
-
setDir
public void setDir(String dir)
Set the value of the
dirproperty.- Parameters:
dir- the new property value
-
getFooterClass
public String getFooterClass()
Return the value of the
footerClassproperty.- Returns:
- the property value
Contents: Space-separated list of CSS style class(es) that will be applied to any footer generated for this table.
-
setFooterClass
public void setFooterClass(String footerClass)
Set the value of the
footerClassproperty.- Parameters:
footerClass- the new property value
-
getFrame
public String getFrame()
Return the value of the
frameproperty.- Returns:
- the property value
Contents: Code specifying which sides of the frame surrounding this table will be visible. Valid values are: none (no sides, default value); above (top side only); below (bottom side only); hsides (top and bottom sides only); vsides (right and left sides only); lhs (left hand side only); rhs (right hand side only); box (all four sides); and border (all four sides).
-
setFrame
public void setFrame(String frame)
Set the value of the
frameproperty.- Parameters:
frame- the new property value
-
getHeaderClass
public String getHeaderClass()
Return the value of the
headerClassproperty.- Returns:
- the property value
Contents: Space-separated list of CSS style class(es) that will be applied to any header generated for this table.
-
setHeaderClass
public void setHeaderClass(String headerClass)
Set the value of the
headerClassproperty.- Parameters:
headerClass- the new property value
-
getLang
public String getLang()
Return the value of the
langproperty.- Returns:
- the property value
Contents: Code describing the language used in the generated markup for this component.
-
setLang
public void setLang(String lang)
Set the value of the
langproperty.- Parameters:
lang- the new property value
-
getOnclick
public String getOnclick()
Return the value of the
onclickproperty.- Returns:
- the property value
Contents: Javascript code executed when a pointer button is clicked over this element.
-
setOnclick
public void setOnclick(String onclick)
Set the value of the
onclickproperty.- Parameters:
onclick- the new property value
-
getOndblclick
public String getOndblclick()
Return the value of the
ondblclickproperty.- Returns:
- the property value
Contents: Javascript code executed when a pointer button is double clicked over this element.
-
setOndblclick
public void setOndblclick(String ondblclick)
Set the value of the
ondblclickproperty.- Parameters:
ondblclick- the new property value
-
getOnkeydown
public String getOnkeydown()
Return the value of the
onkeydownproperty.- Returns:
- the property value
Contents: Javascript code executed when a key is pressed down over this element.
-
setOnkeydown
public void setOnkeydown(String onkeydown)
Set the value of the
onkeydownproperty.- Parameters:
onkeydown- the new property value
-
getOnkeypress
public String getOnkeypress()
Return the value of the
onkeypressproperty.- Returns:
- the property value
Contents: Javascript code executed when a key is pressed and released over this element.
-
setOnkeypress
public void setOnkeypress(String onkeypress)
Set the value of the
onkeypressproperty.- Parameters:
onkeypress- the new property value
-
getOnkeyup
public String getOnkeyup()
Return the value of the
onkeyupproperty.- Returns:
- the property value
Contents: Javascript code executed when a key is released over this element.
-
setOnkeyup
public void setOnkeyup(String onkeyup)
Set the value of the
onkeyupproperty.- Parameters:
onkeyup- the new property value
-
getOnmousedown
public String getOnmousedown()
Return the value of the
onmousedownproperty.- Returns:
- the property value
Contents: Javascript code executed when a pointer button is pressed down over this element.
-
setOnmousedown
public void setOnmousedown(String onmousedown)
Set the value of the
onmousedownproperty.- Parameters:
onmousedown- the new property value
-
getOnmousemove
public String getOnmousemove()
Return the value of the
onmousemoveproperty.- Returns:
- the property value
Contents: Javascript code executed when a pointer button is moved within this element.
-
setOnmousemove
public void setOnmousemove(String onmousemove)
Set the value of the
onmousemoveproperty.- Parameters:
onmousemove- the new property value
-
getOnmouseout
public String getOnmouseout()
Return the value of the
onmouseoutproperty.- Returns:
- the property value
Contents: Javascript code executed when a pointer button is moved away from this element.
-
setOnmouseout
public void setOnmouseout(String onmouseout)
Set the value of the
onmouseoutproperty.- Parameters:
onmouseout- the new property value
-
getOnmouseover
public String getOnmouseover()
Return the value of the
onmouseoverproperty.- Returns:
- the property value
Contents: Javascript code executed when a pointer button is moved onto this element.
-
setOnmouseover
public void setOnmouseover(String onmouseover)
Set the value of the
onmouseoverproperty.- Parameters:
onmouseover- the new property value
-
getOnmouseup
public String getOnmouseup()
Return the value of the
onmouseupproperty.- Returns:
- the property value
Contents: Javascript code executed when a pointer button is released over this element.
-
setOnmouseup
public void setOnmouseup(String onmouseup)
Set the value of the
onmouseupproperty.- Parameters:
onmouseup- the new property value
-
getRole
public String getRole()
Return the value of the
roleproperty.- Returns:
- the property value
Contents:
Per the WAI-ARIA spec and its relationship to HTML5 (Section title ARIA Role Attriubute), every HTML element may have a "role" attribute whose value must be passed through unmodified on the element on which it is declared in the final rendered markup. The attribute, if specified, must have a value that is a string literal that is, or an EL Expression that evaluates to, a set of space-separated tokens representing the various WAI-ARIA roles that the element belongs to.
It is the page author's responsibility to ensure that the user agent is capable of correctly interpreting the value of this attribute.
-
setRole
public void setRole(String role)
Set the value of the
roleproperty.- Parameters:
role- the new property value
-
getRowClass
public String getRowClass()
Return the value of the
rowClassproperty.- Returns:
- the property value
Contents:
Assigns one or more space-separated CSS class names to each "tr"
-
setRowClass
public void setRowClass(String rowClass)
Set the value of the
rowClassproperty.- Parameters:
rowClass- the new property value
-
getRowClasses
public String getRowClasses()
Return the value of the
rowClassesproperty.- Returns:
- the property value
Contents: Comma-delimited list of CSS style classes that will be applied to the rows of this table. A space separated list of classes may also be specified for any individual row. Thes styles are applied, in turn, to each row in the table. For example, if the list has two elements, the first style class in the list is applied to the first row, the second to the second row, the first to the third row, the second to the fourth row, etc. In other words, we keep iterating through the list until we reach the end, and then we start at the beginning again.
-
setRowClasses
public void setRowClasses(String rowClasses)
Set the value of the
rowClassesproperty.- Parameters:
rowClasses- the new property value
-
getRules
public String getRules()
Return the value of the
rulesproperty.- Returns:
- the property value
Contents: Code specifying which rules will appear between cells within this table. Valid values are: none (no rules, default value); groups (between row groups); rows (between rows only); cols (between columns only); and all (between all rows and columns).
-
setRules
public void setRules(String rules)
Set the value of the
rulesproperty.- Parameters:
rules- the new property value
-
getStyle
public String getStyle()
Return the value of the
styleproperty.- Returns:
- the property value
Contents: CSS style(s) to be applied when this component is rendered.
-
setStyle
public void setStyle(String style)
Set the value of the
styleproperty.- Parameters:
style- the new property value
-
getStyleClass
public String getStyleClass()
Return the value of the
styleClassproperty.- Returns:
- the property value
Contents: 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.
-
setStyleClass
public void setStyleClass(String styleClass)
Set the value of the
styleClassproperty.- Parameters:
styleClass- the new property value
-
getSummary
public String getSummary()
Return the value of the
summaryproperty.- Returns:
- the property value
Contents: Summary of this table's purpose and structure, for user agents rendering to non-visual media such as speech and Braille.
-
setSummary
public void setSummary(String summary)
Set the value of the
summaryproperty.- Parameters:
summary- the new property value
-
getTitle
public String getTitle()
Return the value of the
titleproperty.- Returns:
- the property value
Contents: Advisory title information about markup elements generated for this component.
-
setTitle
public void setTitle(String title)
Set the value of the
titleproperty.- Parameters:
title- the new property value
-
getWidth
public String getWidth()
Return the value of the
widthproperty.- Returns:
- the property value
Contents: Width of the entire table, for visual user agents.
-
setWidth
public void setWidth(String width)
Set the value of the
widthproperty.- Parameters:
width- the new property value
-
getEventNames
public Collection<String> getEventNames()
Description copied from class:UIComponentBaseThis is a default implementation of
ClientBehaviorHolder.getEventNames().UIComponentdoes not implement theClientBehaviorHolderinterface, but provides default implementations for the methods defined byClientBehaviorHolderto simplify subclass implementations. Subclasses that wish to support theClientBehaviorHoldercontract must declare that the subclass implementsClientBehaviorHolder, and must override this method to return a non-EmptyCollectionof the client event names that the component supports.- Specified by:
getEventNamesin interfaceClientBehaviorHolder- Overrides:
getEventNamesin classUIComponentBase- Returns:
- the collection of event names.
-
getDefaultEventName
public String getDefaultEventName()
Description copied from class:UIComponentBaseThis is a default implementation of
ClientBehaviorHolder.getDefaultEventName().UIComponentdoes not implement theClientBehaviorHolderinterface, but provides default implementations for the methods defined byClientBehaviorHolderto simplify subclass implementations. Subclasses that wish to support theClientBehaviorHoldercontract must declare that the subclass implementsClientBehaviorHolder, and must provide an implementation ofClientBehaviorHolder.getEventNames().- Specified by:
getDefaultEventNamein interfaceClientBehaviorHolder- Overrides:
getDefaultEventNamein classUIComponentBase- Returns:
- the default event name.
-
-