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

<apex: commandButton> 组件是 Visualforce 中最重要的组件之一。它是一个按钮，呈现为 HTML input 元素，其 type 属性设置为 submit、reset 或 image。HTML 的 type 属性值取决于 <apex:commandButton> 标签指定的.*

当用户按下按钮时，控制器定义的 action 会被执行。然后，根据返回的 PageReference 变量，页面会导航到另一个页面或刷新当前页面。

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

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

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

1. accesskey

accesskey 属性是字符串类型，用于指定将命令按钮置于焦点状态的快捷键。

语法

2. action

action 属性是 ApexPages.Action 类型，用于定义通过 AJAX 请求到服务器时调用的 action 方法。如果未指定 action，页面将简单地刷新。

语法

3. alt

alt 属性是 String 类型，用于指定命令按钮的替代文本描述。

语法

4. dir

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

语法

5. disabled

disabled 属性是 Boolean 类型，用于指定此组件是否应显示为禁用状态。默认情况下，其值为 false。

语法

6. id

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

语法

7. image

image 属性是字符串类型，用于指定将作为此按钮显示的图片的绝对或相对 URL。如果指定了此属性，则生成的 HTML input 元素类型将设置为 image。

语法

8. 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. rendered

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

语法

24. reRender

reRender 属性是 Object 类型，用于在客户端接收到 action 方法的结果时重绘一个或多个组件的 ID。

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

语法

25. status

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

语法

26. style

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

语法

27. styleClass

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

语法

28. tabindex

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

语法

29. timeout

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

语法

30. title

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

语法

31. value

value 属性是字符串类型，用于指定显示在 commandButton 上的文本作为其标签。

语法

让我们看一个例子，了解如何在 VF 页面中使用 apex:commandButton 组件。

ApexCommandButtonExample.vfp

ApexCommandButtonController.apxc

输出