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

2025年3月17日 | 阅读 7 分钟

当使用 <apex: dataTable><apex:pageBlockTable> 组件时,<apex: column> 组件是最重要的组件之一。<apex: column> 用于在表格中创建单个列,并且它必须始终是 <apex:dataTable><apex:pageBlockTable> 组件的子组件。

当我们将 <apex: column> 组件的 value 属性绑定到 sObject 字段时,与该字段关联的标签将用作列标题。

注意:如果我们要覆盖标准标签,请使用 headerValue 属性或列的 header facet。

此组件也支持使用 "html-" 前缀的 HTML 直通属性。

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

1. breakBefore

breakBefore 属性是布尔类型,指定列是否应在新行中开始。默认情况下,其值设置为 false。

语法

2. colspan

colspan 属性是整数类型,指定此列在表格中跨越的总列数。

colspan 属性不能用于标题和脚注单元格。

语法

3. dir

dir 属性是字符串类型,指定生成的列文本的方向。LTR 和 RTL 是此属性的两个可能值。

与 colspan 属性一样,我们不能将此属性用于标题和脚注单元格。

语法

4. footerClass

footerClass 属性是字符串类型,用于指定要应用于列脚注以显示它的样式类。当我们想应用外部 CSS 样式表时,我们使用此属性。

语法

5. footercolspan、footerdir、footerlang、footeronclick、footerondbclick、footeronkeydown、footeronkeypress、footeronkeyup、footeronmousemove、footeronmouseout、footeronmouseover、footeronmouseup、footerstyle、footertitle

所有这些属性都在版本 16.0 中已弃用,并且不影响页面。

6. footerValue

footerValue 是字符串类型,用于指定要在列脚注中显示的文本。

如果使用 footerValue 属性,则不能使用列的脚注 facet。

语法

7. headerClass

headerClass 属性是字符串类型,用于指定要应用于表格标题以显示它的样式类。当我们想应用外部 CSS 样式表时,我们使用此属性。

语法

8. headercolspan、headerdir、headerlang、headeronclick、headerondbclick、headeronkeydown、headeronkeypress、headeronkeyup、headeronmousemove、headeronmouseout、headeronmouseover、headeronmouseup、headerstyle、headertitle

所有这些属性都在版本 16.0 中已弃用,并且不影响页面。

9. headerValue

headerValue 是字符串类型,用于指定要在列标题中显示的文本。

如果使用 headerValue 属性,则不能使用列标题 facet。

语法

10. id

id 是字符串类型,用于允许页面上的其他组件引用此组件。

语法

11. lang

lang 是字符串类型,用于指定用于生成的 HTML 输出的基础语言。值可以是“en”或“en-US”等。

语法

12. onclick

onclick 属性是字符串类型,用于在列中发生 onclick 事件时调用 JavaScript 方法。

onclick 属性不能应用于标题和脚注单元格。

语法

13. ondblclick

ondblclick 属性是字符串类型,用于在列中发生 ondblclick 事件时调用 JavaScript 方法,或者简单地在列被点击两次时调用。

ondblclick 属性也不能应用于标题和脚注单元格。

语法

14. onkeydown

onkeydown 属性是字符串类型,用于在列中发生 onkeydown 事件时调用 JavaScript 方法,或者简单地在用户按下键盘键时调用。

onkeydown 属性也不能应用于标题和脚注单元格。

语法

15. onkeypress

onkeypress 属性是字符串类型,用于在列中发生 onkeypress 事件时调用 JavaScript 方法,或者简单地在用户按住或按下键盘键时调用。

onkeypress 属性也不能应用于标题和脚注单元格。

语法

16. onkeyup

onkeyup 属性是字符串类型,用于在列中发生 onkeyup 事件时调用 JavaScript 方法,或者简单地在用户释放键盘键时调用。

onkeyup 属性也不能应用于标题和脚注单元格。

语法

17. onmousedown

onmousedown 属性是字符串类型,用于在列中发生 onmousedown 事件时调用 JavaScript 方法,或者简单地在用户按下鼠标按钮时调用。

onmousedown 属性也不能应用于标题和脚注单元格。

语法

18. onmousemove

onmousemove 属性是字符串类型,用于在列中发生 onmousemove 事件时调用 JavaScript 方法,或者简单地在用户移动鼠标指针时调用。

onmousemove 属性也不能应用于标题和脚注单元格。

语法

19. onmouseout

onmouseout 属性是字符串类型,用于在列中发生 onmouseout 事件时调用 JavaScript 方法,或者简单地在用户将鼠标指针从列上移开时调用。

onmouseout 属性也不能应用于标题和脚注单元格。

语法

20. onmouseover

onmouseover 属性是字符串类型,用于在列中发生 onmouseover 事件时调用 JavaScript 方法,或者简单地在用户将指针移到列上方时调用。

onmousedown 属性也不能应用于标题和脚注单元格。

语法

21. onmouseup

onmouseup 属性是字符串类型,用于在列中发生 onmouseup 事件时调用 JavaScript 方法,或者简单地在用户释放鼠标按钮时调用。

onmouseup 属性也不能应用于标题和脚注单元格。

语法

22. rendered (已渲染)

rendered 属性的类型为布尔值,用于指定此组件是否在页面上呈现。 默认情况下,其值设置为 true。

语法

23. rowspan

rowspan 属性是字符串类型,用于指定此列的每个单元格在表格中占用的行数。

语法

24. style

style 属性是字符串类型,用于指定应用于它的 CSS。内联 CSS 用作此属性的值。

style 属性不应用于标题和脚注单元格。

语法

25. styleClass

styleClass 属性是字符串类型,用于指定应用于它的外部 CSS 样式表以显示列。

语法

26. title

title 属性是字符串类型,用于指定当鼠标悬停在此组件上时将显示为工具提示的文本

语法

27. value

value 属性是字符串类型,用于指定在列的每个单元格中显示的文本。

语法

28. width

width 属性是字符串类型,用于指定列的宽度,单位为 px%

语法

<apex: column> 组件具有以下两个 Facet

1. footer

它是出现在列脚注单元格中的一个组件。使用 footer facet 时,不能使用列的 footerValue 属性。

2. Header

它是出现在列标题单元格中的一个组件。使用 header facet 时,不能使用 列的 headerValue 属性。

我们来看一个例子,了解如何在 VF 页面中使用 <apex: column> 组件

ApexColumnExample.vfp

ApexColumnController.apxc

输出

apex: column component in Visualforce Page