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

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

<apex:commandLink> 组件是 Visualforce 最重要的组件之一。当用户按下链接时,控制器定义的动作就会执行。然后,页面会根据返回的 PageReference 变量导航到不同的页面或刷新当前页面。

我们使用嵌套的 <apex:param> 组件将请求参数添加到 <apex:commandLink> 组件中。

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

此组件必须始终是 <apex:form> 组件的子组件。

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

1. accesskey

accesskey 属性是字符串类型,用于指定将命令链接置于焦点位置的快捷键。

语法

2. action

action 属性是 ApexPages.Action 类型,用于定义将由 AJAX 请求调用到服务器的动作方法。如果未指定动作,则页面会简单刷新。

语法

3. charset

charset 属性是 String 类型,用于指定将用于编码指定 URL 的字符集。默认情况下,其值设置为 "ISO-8859"

语法

4. coords

coords 属性是 String 类型,用于指定命令链接所用屏幕上热点的位置和形状。

语法

5. dir

dir 属性是 String 类型,用于指定应读取生成的 HTML 组件的方向。此属性的两个可能值是 LTR 和 RTL。

语法

6. hreflang

hreflang 属性是字符串类型,用于指定将用于此命令链接引用的资源的基语言。值可以是 "en" 或 "en-US" 等。

语法

7. id

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

语法

8. immediate

immediate 属性是布尔类型。如果其值为 true,则与组件关联的动作将立即发生。与页面上的字段关联的验证规则将不会由该函数处理。

语法

9. lang

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

语法

10. onblur

onblur 属性是字符串类型,用于在 onblur 事件发生时或焦点移开命令按钮时调用 JavaScript 方法。

语法

11. onclick

onclick 属性是字符串类型,用于在 onclick 事件发生时或用户单击命令按钮时调用 JavaScript 方法。

语法

12. oncomplete

oncomplete 属性是字符串类型,用于在客户端完成 AJAX 更新请求的结果时调用 JavaScript 方法。

语法

13. ondblclick

ondblclick 属性是字符串类型,用于在 ondblclick 事件发生时或命令按钮被单击两次时调用 JavaScript 方法。

语法

14. onfocus

onfocus 属性是字符串类型,用于在 onfocus 事件发生时或命令按钮获得焦点时调用 JavaScript 方法。

语法

15. onkeydown

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

语法

16. onkeypress

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

语法

17. onkeyup

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

语法

18. onmousedown

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

语法

19. onmousemove

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

语法

20. onmouseout

onmouseout 属性是字符串类型,用于在 onmouseout 事件发生时或用户将鼠标指针移开命令按钮时调用 JavaScript 方法。

语法

21. onmouseover

onmouseover 属性是字符串类型,用于在 onmouseover 事件发生时或用户将鼠标指针移到命令按钮上方时调用 JavaScript 方法。

语法

22. onmouseup

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

语法

23. rel

rel 属性是字符串类型,用于指定从当前文档到此命令链接指定的 URL 的关系。此属性的值是链接类型的空格分隔列表。

语法

24. rev

rev 属性是字符串类型,用于指定从当前文档到此命令链接指定的 URL 的反向链接。此属性的值是链接类型的空格分隔列表。

语法

25. rendered

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

语法

26. reRender

reRender 属性是 Object 类型,它基本上是一个或多个组件的 ID,当客户端收到动作方法的结果时,我们需要重新绘制这些组件。

其值可以是单个 Id、逗号分隔的 Id 或 Id 的集合。

语法

27. status

status 属性是字符串类型,用于指定关联组件的 ID,该组件显示 AJAX 更新请求的状态。

语法

28. style

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

语法

29. styleClass

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

语法

30. tabindex

tabindex 属性是字符串类型,用于指定当用户重复按下 Tab 键时,与其他页面组件相比,此按钮被选中的顺序。

语法

31. timeout

timeout 属性是整数类型,用于指定 AJAX 更新请求应超时的时间量。

语法

32. title

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

语法

33. target

target 属性是字符串类型,用于指定应显示此命令链接检索到的资源的框架名称。

语法

34. type

type 属性是字符串类型,用于指定此命令链接指定的资源的 MIME 内容类型。

语法

35. value

value 属性是字符串类型,用于指定将显示在命令链接上作为其标签的文本。

语法

让我们举一个例子来理解如何在 VF 页面中使用 apex:commandLink 组件

ApexCommandLinkExample.vfp

ApexCommandLinkController.apxc

输出

apex commandLink component in Visualforce Page