<apex: inputField> 组件在 Visualforce 页面中

17 Mar 2025 | 5 分钟阅读

<apex: inputField> 是 Salesforce 中另一个重要的输入元素。 <apex: inputField><apex: input> 之间主要区别在于,<apex: inputField> 用于与 Salesforce 对象上的字段相对应的值,而 <apex: input> 用于与 Salesforce 对象上的字段不对应的值。

<apex: inputField> 组件会遵循与此字段关联的所有属性。属性包括此字段是否为必需字段或唯一字段以及用于显示的 UI 小部件。

如果指定的 <apex: inputField> 组件是日期或选择列表字段,则将分别显示日历输入小部件或选择列表下拉列表。

HTML 直通属性通过使用 "html-" 前缀以及附加到生成的 <input> 标签来支持此组件。

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

1. id

id 是一个字符串类型属性,即一个唯一的标识符,允许此组件被页面中的其他组件引用。

语法

2. ignoreEditPermissionForRendering

ignoreEditPermissionForRendering 是一个布尔类型属性。 当它的值为 true 时,即使对象上的底层权限不允许编辑,用户也可以编辑或覆盖该字段。

被覆盖的数据会影响所有用户,但仅供访客用户使用。

注意:我们只能将此属性与没有共享模式的自定义控制器一起使用。

语法

3. 标签

label 是一个字符串类型属性,用于指定文本值。 此属性将使用指定的标签值覆盖字段的默认标签。 要隐藏字段的默认标签,我们可以将标签设置为空字符串。

语法

4. onblur

onblur 是一个字符串类型属性,用于在 onblur 事件发生或焦点移出该字段时调用 JavaScript 方法。

语法

5. onchange

onchange 是一个字符串类型属性,用于在 onchange 事件发生或用户更改字段内容时调用 JavaScript 方法。

语法

6. onclick

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

语法

7. ondblclick

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

语法

8. onfocus

onfocus 是一个字符串类型属性,用于在输入事件发生或焦点在该字段上时调用 JavaScript 方法。

语法

9. onkeydown

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

语法

10. onkeypress

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

语法

11. onkeyup

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

语法

12. onmousedown

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

语法

13. onmousemove

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

语法

14. onmouseout

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

语法

15. onmouseover

onmouseover 是一个字符串类型属性,用于在 onmouseover 事件发生或用户将指针移到输入上方时调用 JavaScript 方法。

语法

16. onmouseup

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

语法

17. onselect

onselect 是一个字符串类型属性,用于在 onselect 事件发生或用户选择与此字段关联的复选框时调用 JavaScript 方法。

语法

18. rendered

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

语法

19. required

required 是一个布尔类型属性,用于指定此字段是否为必填字段。 默认情况下,其值设置为 false。

语法

20. showDatePicker

showDatePicker 是一个布尔类型属性,用于检查是否需要为此字段使用 VF 日期选择器。 此属性仅影响日期和日期时间字段。

语法

21. style

style 是一个字符串类型的属性,用于指定将应用于显示输入组件的内联 CSS 样式。

语法

22. styleClass

styleClass 是一个字符串类型的属性,用于指定将应用于显示输入组件的样式类。

语法

23. taborderhint

taborderhint 是一个整数类型属性,用于指定提示,指示当用户按 Tab 键时,与其他页面组件相比,选择此字段的相对顺序。 此属性的值应介于 0 到 32767 之间。

语法

24. type

type 是一个字符串类型属性,用于将定义的类型添加到生成的输入元素。 type 属性的可能值包括 auto、date、datetime、datetime-local、month、week、time、email、number、range、search、tel、text、url。

语法

25. value

value 是一个对象类型属性,即一个引用与此 inputField 关联的 Salesforce 字段的表达式。

语法

让我们举个例子来了解如何在 VF 页面上使用 <apex:inputField> 组件

ApexInputFieldExample.vfp

ApexInputFieldController.apxc

输出

apex: inputField in Visualforce Page