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

17 Mar 2025 | 5 分钟阅读

<apex:form> 组件是 Visualforce 页面上最重要的组件之一。<apex:form> 组件定义了一个区域,允许用户输入信息并通过 <apex:commandButton><apex:commandLink> 组件提交。表单中需要显示的数据由 <apex:form> 的主体内容决定。它还定义了数据处理的方式。我们可以使用多个 <apex:form>,但为了最佳实践,我们在一个页面或自定义组件中只使用一个 <apex:form>

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

1. accept

"accept" 是一个字符串类型属性,即以逗号分隔的内容类型列表。该列表包含服务器可以处理的内容类型。以下是一些 "accept" 属性的可能值:

  1. text/html
  2. image/png
  3. image/gif
  4. video/mpeg
  5. text/css
  6. audio/basic

语法

2. acceptcharset

"acceptcharset" 是一个字符串类型属性,即以逗号分隔的字符编码类型列表。该列表包含服务器可以处理的字符编码类型。UNKNOWN 是此属性的默认值。

语法

3. enctype

"enctype" 是一个字符串类型属性,用于定义将表单提交到服务器时使用的内容类型。application/x-www-form-urlencoded 是此属性的默认值。

语法

4. dir

"dir" 是一个字符串类型属性,用于指定生成的 HTML 组件的读取方向。此属性的可能值包括:

  1. LTR
  2. RTL

语法

5. forceSSL

forceSSL 是一个布尔类型属性,指定表单是否使用 SSL 提交,而无论页面本身是否通过 SSL 提供。

6. id

id 是一个字符串类型属性,即一个唯一标识符,用于页面上其他组件引用此组件。

语法

7. lang (语言)

lang 是一个字符串类型属性,用于定义生成的 HTML 输出的基础语言。"en""en-US" 是此属性的两个可能值。

语法

8. onclick

onclick 是一个字符串类型属性,用于在发生 onclick 事件时调用 JavaScript 方法,或者简单地当用户单击 apex 表单时调用。

语法

9. ondblclick

ondblclick 是一个字符串类型属性,用于在发生 ondblclick 事件时调用 JavaScript 方法,或者简单地当用户双击表单时调用。

语法

10. onkeydown

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

语法

11. onkeypress

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

语法

12. onkeyup

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

语法

13. onmousedown

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

语法

14. onmousemove

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

语法

15. onmouseout

onmouseout 是一个字符串类型属性,用于在发生 onmouseout 事件时调用 JavaScript 方法,或者当用户将鼠标指针移出表单区域时调用。

语法

16. onmouseover

onmouseover 是一个字符串类型属性,用于在发生 onmouseover 事件时调用 JavaScript 方法,或者当用户将鼠标指针移到表单区域上时调用。

语法

17. onmouseup

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

语法

18. onreset

onreset 是一个字符串类型属性,用于在发生 onreset 事件时调用 JavaScript 方法,或者当用户单击表单上的重置按钮时调用。

语法

19. onsubmit

onsubmit 是一个字符串类型属性,用于在发生 onsubmit 事件时调用 JavaScript 方法,或者当用户单击表单上的提交按钮时调用。

语法

20. prependId

prependId 是一个布尔类型属性,用于指定在此组件的客户端 ID 生成过程中,此表单是否应该在其子组件的 ID 前面加上自己的 ID。

语法

21. rendered

rendered 是一个布尔类型属性,用于指定此组件是否在页面上呈现。布尔值 true 是此属性的默认值。

语法

22. style

style 是一个字符串类型属性,用于指定需要应用于它的内联 CSS。

语法

23. styleClass

styleClass 也是一个字符串类型属性,用于指定需要应用于显示表单的外部 CSS 样式表。

语法

24. target

target 是一个字符串类型属性,用于指定表单提交后显示响应的框架的名称。以下是一些此属性的可能值:

  1. _blank
  2. _parent
  3. _self
  4. _top

除了这些值之外,我们还可以通过为所需目标分配 name 属性的值来指定自己的目标名称。

语法

25. title

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

语法

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

ApexFormExample.vfp

ApexFormController.apxc

输出

<apex:form> in Visualforce Page