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

17 Mar 2025 | 6 分钟阅读

<apex: input> 是一个通用输入组件,可根据表单字段所需的数据进行调整。<apex:input> 组件支持 HTML type 属性,该属性允许客户端浏览器显示类型适当的用户输入小部件。

我们使用 <apex: input> 组件获取用户对控制器属性或方法的输入,该属性或方法不对应于 Salesforce 对象上的字段。此组件不使用 Salesforce 样式。

HTML 透传属性 得到此组件的支持,使用 "html-" 前缀,该前缀附加到生成的 <input> 标签。

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

1. accesskey

acesskey 是一个字符串类型的属性,它定义了将焦点置于字段的键盘访问键。

语法

2. alt

alt 是一个字符串类型的属性,用于定义字段的替代文本描述。

语法

3. dir

dir 是一个字符串类型的属性,用于指定应使用生成的 HTML 组件的方向。 RTLLTRdir 属性的两个可能值。

语法

4. disabled

disabled 是一个布尔类型的属性,它指定此文本框是否应以禁用状态显示。 默认情况下,其值设置为 false。

语法

5. id

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

语法

6. label (标签)

label 是一个字符串类型的属性,用于在控件旁边显示文本,并在错误消息中引用该控件。

语法

7. lang (语言)

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

语法

8. 列表

list 是一个 Object 类型的属性,即要添加到与输入字段关联的 HTML <datalist> 块中的自动完成值的列表。此属性是逗号分隔的静态字符串或 VF 表达式。

语法

9. onblur

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

语法

10. onchange

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

语法

11. onclick

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

语法

12. ondblclick

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

语法

13. onfocus

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

语法

14. onkeydown

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

语法

15. onkeypress

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

语法

16. onkeyup

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

语法

17. onmousedown

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

语法

18. onmousemove

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

语法

19. onmouseout

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

语法

20. onmouseover

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

语法

21. onmouseup

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

语法

22. rendered (已渲染)

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

语法

23. 必需的

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

语法

24. 大小

size 是一个 Integer 类型的属性,用于指定输入字段的宽度。宽度用一次显示的字符数表示。

语法

25. style

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

语法

26. styleClass

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

语法

27. tabindex

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

语法

28. 标题

title 是一个字符串类型的属性,用于指定当用户的鼠标指针悬停在该组件上时要显示为工具提示的文本。

语法

29. 类型

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

语法

30. value

value 是一个 Object 类型的属性,即引用与该字段关联的控制器类变量的表达式。

语法

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

ApexInputExample.vfp

ApexInputController.apxc

输出

apex:input in Visualforce Page