焦点行为

页面装入时,将初始焦点设置到指定字段或者页面跳进顺序中的第一个字段。

页面装入时,此行为将焦点设置到指定的字段。如果没有此行为,浏览器通常会将初始焦点设置到工具栏中的“URL”字段。

如果指定了某个字段,则会将焦点设置到该字段。否则,会将焦点设置到页面跳进顺序中的第一个字段。

发送组件的 JSF 标记

<hx:inputHelperSetFocus>

基本 HTML

仅与 <body> 配合使用。

JavaScript 构造函数

hX_5.addBehavior("#body", "onload", new hX_5.JSFBehaviorFocus(attributes)); 其中

属性

逗号分隔的属性列表,其中每个属性都是一个加引号的字符串,此字符串包含使用冒号分隔的属性名称和值,例如,"label:MyLabel"。

请注意特殊 ID #body 的用法。

受支持的事件

事件

描述

onload

该行为只能用于指定页面中的初始焦点。

属性

表 1.

属性名称

描述

focus-id

指定给字段的焦点的 ID。如果省略,则焦点将按照页面的跳进顺序指定给第一个字段。

select

如果为 True,则将选择字段的内容(如果可以选择内容)。否则,当字段被指定焦点时,如果浏览器未执行选择,则字段的内容将保留为未选中。

序列

在为该事件提供的任何其他处理程序运行完成后运行。

不会停止该事件。

API 调用

表 2. 焦点行为 API 调用

API 调用

描述

object = setAttribute(attribute)

设置属性,或如果以前已设置属性,则更改其值。

string = getAttribute(attribute-name)

检索属性的当前值。

局限性

示例代码

将焦点设置到页面跳进顺序中的第一个字段。选择内容。

hX.addBehavior("#body", "onload", new hX.JSFBehaviorFocus("select"));

将焦点设置到指定的字段。

hX.addBehavior("#body", "onload", new hX.JSFBehaviorFocus("focus-id:form1:menu2"));

反馈