The <apex: pageBlockTable> component is another most used component, i.e., a list of data displayed as a table within an <apex: pageBlock> or <apex: pageBlockSection> component.
The <apex: pageBlockTable> is defined by iterating over a data set. The <apex: pageBlockTable> component displays information about one data item per row. The data set can contain up to 1000 items or 10000 items when the page is executed in read-only mode.
We can specify more than one column component inside of the <apex: pageBlockTable> component to specify what information should be displayed for each data item.
The HTML pass-through attributes are supported by this component using the "html-" prefix.
The <apex: pageBlockTable> component has the following attributes:
1. align
The "align" is a string-type attribute used to specify the position of the rendered HTML table for the page. These are the possible values for this attribute:
left
center
right
By default, its value is set to left.
Syntax:
<apex: pageBlockTable aligh="center"></apex: pageBlockTable>
2. bgcolor
The "bgcolor" is a string-type attribute that specifies the background color. However, this attribute is deprecated in Salesforce version 18.0.
Syntax:
<apex: pageBlockTable bgcolor="#FFFFFF"></apex: pageBlockTable>
3. border
The "border" is a string-type attribute used to specify the width of the frame around the rendered HTML table in pixels.
Syntax:
<apex: pageBlockTable border="5px;"></apex: pageBlockTable>
4. captionClass
The "captionClass" is a string-type attribute used to specify the style class for displaying the caption for the rendered HTML table.
AD
Syntax:
<apex: pageBlockTable captionClasss="className"></apex: pageBlockTable>
5. captionStyle
The "captionStyle" is a string-type attribute used to specify the CSS style rule for displaying the caption for the rendered HTML table.
Syntax:
<apex: pageBlockTable captionStyle="display:none;"></apex: pageBlockTable>
6. cellpadding
AD
The "cellpadding" attribute is a string-type attribute used to define the amount of space between the border of each table cell and its contents.
Syntax:
<apex: pageBlockTable cellpadding="5px;"></apex: pageBlockTable>
7. cellspacing
The "cellspacing" attribute is a string-type attribute used to define the amount of space between the border of each table cell and the border of the other cells surrounding it. Its value can be in pixels or percentages.
Syntax:
<apex: pageBlockTable cellspacing="5px;"></apex: pageBlockTable>
8. columnClasses
The "columnClasses" attribute is a string-type attribute that defines one or more style classes as a comma-separated list associated with the table's columns.
Syntax:
<apex: pageBlockTable columnClasses="classNames"></apex: pageBlockTable>
9. columns
The "columns" is an integer-type attribute that defines the number of columns in this table.
Syntax:
<apex: pageBlockTable columns="5"></apex: pageBlockTable>
10. columnsWidth
The "columnsWidth" is a string-type attribute that defines a comma-separated list of the widths applied to each table column. Values can be expressed as pixels
Syntax:
<apex: pageBlockTable columns="100px,100px"></apex: pageBlockTable>
11. dir
The "dir" is a string-type attribute that defines the direction in which the generated HTML component should be read. RTL and LTR are the two possible values for this attribute.
Syntax:
<apex: pageBlockTable dir="LTR"></apex: pageBlockTable>
12. first
The "first" is an integer-type attribute that indicates the first element in the iteration visibly rendered in the list. The index of the first element in the data set specified by the value attribute is 0.
Syntax:
<apex: pageBlockTable first="2"></apex: pageBlockTable>
13. footerClass
The "footerClass" is a string-type attribute that defines the style class used for displaying the footer for the rendered HTML table. The footer class will be applied when the footer facet is specified.
Syntax:
<apex:dataTable footerClass="className"></apex:dataTable>
14. frame
The frame is a string-type attribute that defines the border drawn for this table. The "none", "above", "below", "hsides", "vsides", "lhs", "rhs", "box" and "border" are the possible values for this attribute.
Syntax:
<apex: pageBlockTable frame="box"></apex: pageBlockTable>
15. headerClass
The "headerClass" is a string type attribute that defines the style class used for displaying the header for the rendered HTML table. The header class will be applied when the header facet is specified.
Syntax:
<apex:dataTable headerClass="className"></apex:dataTable>
16. id
The "id" attribute is a string-type attribute that defines a unique identifier that allows this component to be referenced by other components on the page.
Syntax:
<apex:dataTable id="dataListId"></apex:dataTable>
17. lang
The "lang" attribute is a string-type attribute that defines the base language for the generated HTML output.
Syntax:
<apex:dataTable lang="en"></apex:dataTable>
18. onclick
The "onclick" attribute is a string type attribute used to invoke the JavaScript method when the onclick event occurs or when the user clicks the pageBlockTable.
Syntax:
<apex:dataTable onclick="saveRecords();"></apex:dataTable>
19. ondblclick
The "ondblclick" attribute is a string type attribute used to invoke the JavaScript method when the ondblclick event occurs or when the user clicks the pageBlockTable twice.
Syntax:
<apex: pageBlockTable ondblclick="saveRecords();"></apex: pageBlockTable>
20. onkeydown
The "onkeydown" attribute is a string-type attribute used to invoke the JavaScript method when the onkeydown event occurs or when the user presses a keyboard key.
Syntax:
<apex: pageBlockTable onkeydown="saveRecords();"></apex: pageBlockTable>
21. onkeypress
The "onkeypress" attribute is a string type attribute used to invoke the JavaScript method when the onkeypress event occurs or when the user holds down or presses a keyboard key.
Syntax:
<apex: pageBlockTable onkeypress="saveRecords();"></apex: pageBlockTable>
22. onkeyup
The "onkeyup" attribute is a string-type attribute used to invoke the JavaScript method when the onkeyup event occurs or when the user releases a keyboard key.
Syntax:
<apex: pageBlockTable onkeyup="saveRecords();"></apex: pageBlockTable >
23. onmousedown
The "onmousedown" attribute is a string-type attribute used to invoke the JavaScript method when the onmousedown event occurs or when the user presses the mouse button.
Syntax:
<apex: pageBlockTable onmousedown="countKeys();"></apex: pageBlockTable>
24. onmousemove
The "onmousemove" attribute is a string-type attribute used to invoke the JavaScript method when the onmousemove event occurs or when the user moves the mouse pointer.
Syntax:
<apex: pageBlockTable onmousemove="countKeys();"></apex:pageBlockTable >
25. onmouseout
The "onmouseout" attribute is a string-type attribute used to invoke the JavaScript method when the onmouseout event occurs or when the user moves the mouse pointer away from the pageBlockTable.
Syntax:
<apex: pageBlockTable onmouseout="countKeys();"></apex: pageBlockTable>
26. onmouseover
The "onmouseover" attribute is a string-type attribute used to invoke the JavaScript method when the onmouseover event occurs or when the user moves the pointer over the data table.
Syntax:
<apex: pageBlockTable onmouseover="countKeys();"></apex: pageBlockTable>
27. onmouseup
The "onmouseup" attribute is a string-type attribute used to invoke the JavaScript method when the onmouseup event occurs or when the user releases the mouse button.
Syntax:
<apex: pageBlockTable onmouseup="countKeys();"></apex: pageBlockTable >
28. onRowClick
The "onRowClick" attribute is a string type attribute used to invoke the JavaScript method when the onRowClick event occurs or when the user clicks a row in the pageBlockTable.
Syntax:
<apex: pageBlockTable onRowClick="countKeys();"></apex: pageBlockTable >
29. onRowDblClick
The "onRowDblClick" attribute is a string type attribute used to invoke the JavaScript method when the onRowDblClick event occurs or when the user clicks a row in the pageBlockTable twice.
Syntax:
<apex: pageBlockTable onRowDblClick="countKeys();"></apex: pageBlockTable>
30. onRowMouseDown
The "onRowMouseDown" attribute is a string-type attribute used to invoke the JavaScript method when the onRowMouseDown event occurs or when the user clicks a mouse button in a row of the data table.
Syntax:
<apex: pageBlockTable onRowMouseDown="countKeys();"></apex: pageBlockTable >
31. onRowMouseMove
The "onRowMouseMove" attribute is a string type attribute used to invoke the JavaScript method when the onRowMouseMove event occurs or when the user moves the mouse pointer over a row of the pageBlockTable.
Syntax:
<apex: pageBlockTable onRowMouseMove="countKeys();"></apex: pageBlockTable>
32. onRowMouseOut
The "onRowMouseOut" attribute is a string type attribute used to invoke the JavaScript method when the onRowMouseOut event occurs or when the user moves the mouse pointer away from a row in the pageBlockTable.
Syntax:
<apex: pageBlockTable onRowMouseOut="countKeys();"></apex: pageBlockTable>
33. onRowMouseOver
The "onRowMouseOver" attribute is a string type attribute used to invoke the JavaScript method when the onRowMouseMove event occurs or when the user moves the mouse pointer over a row in the pageBlockTable.
Syntax:
<apex: pageBlockTable onRowMouseOver="countKeys();"></apex: pageBlockTable>
34. onRowMouseUp
The "onRowMouseUp" attribute is a string type attribute used to invoke the JavaScript method when the onRowMouseUp event occurs or when the user releases the mouse button over a row in the pageBlockTable.
Syntax:
<apex: pageBlockTable onRowMouseUp="countKeys();"></apex: pageBlockTable>
35. rendered
The "rendered" attribute is a Boolean-type attribute used to specify whether this component is rendered on the page. By default, its value is set to true.
Syntax:
<apex: pageBlockTable rendered="true"></apex: pageBlockTable>
36. rowClasses
The "rowsClasses" attribute is a string-type attribute used for specifying one or more classes associated with the table's rows.
Syntax:
<apex: pageBlockTable rowClasses="className"></apex: pageBlockTable>
37. rows
The "rows" attribute is an integer-type attribute used for specifying the maximum number of items to display in the list. By default, its value is set to 0, resulting in all possible list items.
Syntax:
<apex: pageBlockTable rows="2"></apex: pageBlockTable>
38. rules
The "rules" attribute is a string-type attribute used for specifying the borders drawn between cells in the table. The "none", "groups", "rows", "cols", and "all" are the possible values for this attribute, and by default, its value is set to "none".
Syntax:
<apex: pageBlockTable rules="all"></apex: pageBlockTable>
39. style
The "style" is a string-type attribute that defines the inline CSS to apply the data list component.
Syntax:
<apex: pageBlockTable style="inline css"></apex: pageBlockTable>
40. styleClass
The "styleClass" is a string-type attribute used to define the CSS class to apply the data list component.
Syntax:
<apex: pageBlockTable styleClass="className"></apex: pageBlockTable>
41. summary
The "summary" is a string-type attribute used to specify the summary of the table's purpose and structure for Section 508 compliance.
Syntax:
<apex: pageBlockTable summary="summary content"></apex: pageBlockTable>
42. title
The "title" is a string-type attribute used to specify the text displayed when the user's mouse pointer hovers over this component.
Syntax:
<apex: pageBlockTable title="Data List Example"></apex: pageBlockTable>
43. value
The "value" is an Object type attribute that defines the data collection displayed in the list.
Syntax:
<apex: pageBlockTable value="object"></apex: pageBlockTable >
44. var
The "var" is a string-type attribute that defines the variable's name represented by one element in the collection of the data specified by the value attribute.
Syntax:
<apex: pageBlockTable value="object" var="variableName"></apex: pageBlockTable>
45. width
The "width" is a string-type attribute that defines the entire table's width, expressed as a relative percentage of the total amount of available horizontal space.
Syntax:
<apex: pageBlockTable width="80%"></apex: pageBlockTable>
The <apex: pageBlockTable> component has the following three facets:
1. caption
The components that appear in the caption for the table.
2. footer
The components that appear in the footer row for the table.
3. header
The components that appear in the header row for the table.
Let's take an example to understand how we can use the <apex: pageBlockTable> component on the Visualforce page.
