Visualforce 页面中的 <apex:dataTable> 组件

<apex:dataTable> 是 Visualforce 页面上的另一个重要组件。HTML 表格显示关于每行一个数据项的信息。<apex:dataTable> 是通过迭代数据集来定义的。<apex:dataTable> 的主体包含一个或多个列组件。这些组件指定了需要为每个数据项显示的信息。

此组件通过 “html-” 前缀支持 HTML 传递属性。

<apex:dataTable> 组件具有以下属性

1. align

align 是一个字符串类型属性，用于定义渲染的 HTML 表格相对于页面的位置。可能的值包括 left, right，或 center。默认情况下，其值为 left。

语法

2. bgcolor

border 是一个字符串类型属性，用于指定渲染的 HTML 表格的背景颜色。

语法

3. border

id 属性是一个字符串类型属性，用于定义渲染的 HTML 表格周围边框的宽度（以像素为单位）。

语法

4. captionClass

captionClass 属性是一个字符串类型属性，用于定义用于显示渲染的 HTML 表格标题的样式类。当指定了 caption facet 时，将应用外部样式表。

语法

5. captionStyle

captionStyle 属性是一个字符串类型属性，用于定义用于显示渲染的 HTML 表格标题的内联 CSS。当指定了 caption facet 时，将应用内联 CSS。

语法

6. cellpadding

cellpadding 属性是一个字符串类型属性，用于定义每个表格单元格边框与其内容之间的空间量。

语法

7. cellspacing

cellspacing 属性是一个字符串类型属性，用于定义每个表格单元格边框与周围其他单元格边框之间的空间量。其值可以是像素或百分比。

语法

8. columnClasses

columnClasses 属性是一个字符串类型属性，用于定义一个或多个样式类，以逗号分隔的列表形式关联到表格的列。

语法

9. columns

'columns' 是一个整数类型属性，用于定义此表格的列数。

语法

10. columnsWidth

columnsWidth 是一个字符串类型属性，用于定义应用于每个表格列的宽度列表，以逗号分隔。值可以表示为像素

语法

11. dir

dir 是一个字符串类型属性，用于定义生成 HTML 组件的阅读方向。RTL 和 LTR 是此属性的两个可能值。

语法

12. first

first 是一个整数类型属性，指示列表中可见渲染的迭代的第一个元素。由 value 属性指定的数据集中的第一个元素的索引是 0。

语法

13. footerClass

footerClass 是一个字符串类型属性，用于定义用于显示渲染的 HTML 表格页脚的样式类。当指定了 footer facet 时，将应用 footer class。

语法

14. frame

frame 是一个字符串类型属性，用于定义为此表格绘制的边框。可能的取值有 "none", "above", "below", "hsides", "vsides", "lhs", "rhs", "box" 和 "border"。

语法

15. headerClass

headerClass 是一个字符串类型属性，用于定义用于显示渲染的 HTML 表格页眉的样式类。当指定了 header facet 时，将应用 header class。

语法

16. id

id 属性是一个字符串类型属性，用于定义一个唯一的标识符，允许页面上的其他组件引用此组件。

语法

17. lang

lang 是一个字符串类型属性，用于定义生成 HTML 输出的基础语言。

语法

18. onclick

onclick 是一个字符串类型属性，用于在发生 onclick 事件或用户单击数据表时调用 JavaScript 方法。

语法

19. ondblclick

ondblclick 是一个字符串类型属性，用于在发生 ondblclick 事件或用户双击数据表时调用 JavaScript 方法。

语法

20. onkeydown

onkeydown 是一个字符串类型属性，用于在发生 onkeydown 事件或用户按下键盘键时调用 JavaScript 方法。

语法

21. onkeypress

onkeypress 是一个字符串类型属性，用于在发生 onkeypress 事件或用户按住或按下键盘键时调用 JavaScript 方法。

语法

22. onkeyup

onkeyup 是一个字符串类型属性，用于在发生 onkeyup 事件或用户释放键盘键时调用 JavaScript 方法。

语法

23. onmousedown

onmousedown 是一个字符串类型属性，用于在发生 onmousedown 事件或用户按下鼠标按钮时调用 JavaScript 方法。

语法

24. onmousemove

onmousemove 属性是一个字符串类型属性，用于在发生 onmousemove 事件或用户移动鼠标指针时调用 JavaScript 方法。

语法

25. onmouseout

onmouseout 是一个字符串类型属性，用于在发生 onmouseout 事件或用户将鼠标指针移出数据表时调用 JavaScript 方法。

语法

26. onmouseover

onmouseover 是一个字符串类型属性，用于在发生 onmouseover 事件或用户将鼠标指针移到数据表上方时调用 JavaScript 方法。

语法

27. onmouseup

onmouseup 是一个字符串类型属性，用于在发生 onmouseup 事件或用户释放鼠标按钮时调用 JavaScript 方法。

语法

28. onRowClick

onRowClick 是一个字符串类型属性，用于在发生 onRowClick 事件或用户单击表格中的某一行时调用 JavaScript 方法。

语法

29. onRowDblClick

onRowDblClick 是一个字符串类型属性，用于在发生 onRowDblClick 事件或用户双击数据表中的某一行时调用 JavaScript 方法。

语法

30. onRowMouseDown

onRowMouseDown 是一个字符串类型属性，用于在发生 onRowMouseDown 事件或用户在数据表行中单击鼠标按钮时调用 JavaScript 方法。

语法

31. onRowMouseOut

onRowMouseOut 属性是一个字符串类型属性，用于在发生 onRowMouseOut 事件或用户将鼠标指针移出数据表行时调用 JavaScript 方法。

语法

32. onRowMouseMove

onRowMouseMove 属性是一个字符串类型属性，用于在发生 onRowMouseMove 事件或用户将鼠标指针移到数据表行上方时调用 JavaScript 方法。

语法

33. onRowMouseOver

onRowMouseOver 是一个字符串类型属性，用于在发生 onRowMouseMove 事件或用户将鼠标指针移到数据表行上方时调用 JavaScript 方法。

语法

34. rendered

rendered 是一个布尔类型属性，用于指定此组件是否在页面上渲染。默认情况下，布尔值 true 被设置为此属性。

语法

35. onRowMouseUp

onRowMouseUp 是一个字符串类型属性，用于在发生 onRowMouseUp 事件或用户在数据表行上方释放鼠标按钮时调用 JavaScript 方法。

语法

36. rowClasses

rowClasses 是一个字符串类型属性，用于指定与表格行关联的一个或多个类。

语法

37. rows

"rows" 是一个整数类型属性，用于指定列表中要显示的最大项数。此属性的默认值为 0，表示显示所有可能的列表项。

语法

38. rules

"rules" 是一个字符串类型属性，用于指定在表格单元格之间绘制的边框。可能的取值有 "none", "groups", "rows", "cols"，以及 "all"，默认值为 "none"。

语法

39. style

style 是一个字符串类型属性，用于定义应用于数据列表组件的内联 CSS。

语法

40. styleClass

styleClass 是一个字符串类型属性，用于定义应用于数据列表组件的 CSS 类。styleClass 属性指定应用于该组件的外部 CSS 样式表。

语法

41. summary

summary 是一个字符串类型属性，用于指定表格的目的和结构的摘要，以符合 Section 508 标准。

语法

42. title

title 是一个字符串类型属性，用于指定当用户鼠标指针悬停在此组件上时显示的文本。

语法

43. value

value 是一个 Object 类型属性，用于定义列表中显示的数据集合。

语法

44. var

var 是一个字符串类型属性，用于定义变量名，表示 value 属性指定的数据集合中的一个元素。

语法

45. width

width 是一个字符串类型属性，用于定义整个表格的宽度，表示为可用水平空间总量的相对百分比。

语法

<apex:dataTable> 具有以下三个 facet

1. caption

表格标题中显示的组件。

2. footer（页脚）

表格页脚行中显示的组件。

3. header（页眉）

表格页眉行中显示的组件。

让我们通过一个示例来理解如何在 Visualforce 页面上使用 <apex:dataList> 组件。

ApexDataTableExample.vfp

ApexDataListController.apxc

输出