JSF - h:panelGrid

The h:panel tag renders an HTML "table" element.

JSF Tag

<h:panelGrid id = "panel" columns = "2" border = "1"
      cellpadding = "10" cellspacing = "1">
   
   <f:facet name = "header">
      <h:outputText value = "Login"/>
   </f:facet>
   <h:outputLabel value = "Username" />
   <h:inputText  />
   <h:outputLabel value = "Password" />
   <h:inputSecret />
   
   <f:facet name = "footer">
      <h:panelGroup style = "display:block; text-align:center">
         <h:commandButton id = "submit" value = "Submit" />
      </h:panelGroup>
   </f:facet>
</h:panelGrid>

Rendered Output

<table id = "j_idt10:panel" border = "1" cellpadding = "10" cellspacing = "1">
   <thead>
      <tr><th colspan = "2" scope = "colgroup">Login</th></tr>
   </thead>
   
   <tfoot>
      <tr>
         <td colspan = "2">
            <span style = "display:block; text-align:center">
               <input id = "j_idt10:submit" type = "submit"
                  name = "j_idt10:submit" value = "Submit" />
            </span>
         </td>
      </tr>
   </tfoot>
   
   <tbody>
      <tr>
         <td><label>Username</label></td>
         <td><input type = "text" name = "j_idt10:j_idt17" /></td>
      </tr>
      <tr>
         <td><label>Password</label></td>
         <td><input type = "password" name = "j_idt10:j_idt21" value = "" /></td>
      </tr>
   
   </tbody>
</table>

Tag Attributes

S.No	Attribute & Description
1	id Identifier for a component
2	binding Reference to the component that can be used in a backing bean
3	rendered A boolean; false suppresses rendering
4	styleClass Cascading stylesheet (CSS) class name
5	value A component’s value, typically a value binding
6	bgcolor Background color for the table
7	border Width of the table’s border
8	cellpadding Padding around table cells
9	cellspacing Spacing between table cells
10	columnClasses Comma-separated list of CSS classes for columns
11	columns Number of columns in the table
12	footerClass CSS class for the table footer
13	frame 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
14	headerClass CSS class for the table header
15	rowClasses Comma-separated list of CSS classes for columns
16	rules Specification for lines drawn between cells; valid values: groups, rows, columns, all
17	summary Summary of the table’s purpose and structure used for non-visual feedback such as speech
18	dir Direction for text. Valid values are ltr (left to right) and rtl (right to left)
19	lang Base language of an element’s attributes and text
20	border Pixel value for an element’s border width
21	title A title, used for accessibility, that describes an element. Visual browsers typically create tooltips for the title’s value
22	width Width of an element
23	onblur Element loses focus
24	onchange Element’s value changes
25	onclick Mouse button is clicked over the element
26	ondblclick Mouse button is double-clicked over the element
27	onfocus Element receives focus
28	onkeydown Key is pressed
29	onkeypress Key is pressed and subsequently released
30	onkeyup Key is released
31	onmousedown Mouse button is pressed over the element
32	onmousemove Mouse moves over the element
33	onmouseout Mouse leaves the element’s area
34	onmouseover Mouse moves onto an element
35	onmouseup Mouse button is released

Example Application

Let us create a test JSF application to test the above tag.

Step	Description
1	Create a project with a name helloworld under a package com.tutorialspoint.test as explained in the JSF - First Application chapter.
2	Modify home.xhtml as explained below. Keep rest of the files unchanged.
3	Compile and run the application to make sure business logic is working as per the requirements.
4	Finally, build the application in the form of war file and deploy it in Apache Tomcat Webserver.
5	Launch your web application using appropriate URL as explained below in the last step.

home.xhtml

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
   "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns = "http://www.w3.org/1999/xhtml">
   <head>
      <title>JSF Tutorial!</title>
   </head>
   
   <body>
      <h2>h:panelGrid example</h2>
      <hr />
      
      <h:form>
         <h:panelGrid id = "panel" columns = "2" border = "1"
            cellpadding = "10" cellspacing = "1">
            
            <f:facet name = "header">
               <h:outputText value = "Login"/>
            </f:facet>
            <h:outputLabel value = "Username" />
            <h:inputText  />
            <h:outputLabel value = "Password" />
            <h:inputSecret />
            
            <f:facet name = "footer">
               <h:panelGroup style = "display:block; text-align:center">
                  <h:commandButton id = "submit" value = "Submit" />
               </h:panelGroup>
            </f:facet>
         </h:panelGrid>
      </h:form>
   
   </body>
</html>

Once you are ready with all the changes done, let us compile and run the application as we did in JSF - First Application chapter. If everything is fine with your application, this will produce the following result.

jsf_basic_tags.htm