通用行为用于执行 JSF 操作,以响应对任何标记触发的任何事件。通用行为提供了一种机制,用户可以通过此机制运行预定义的便捷 JavaScript™ 功能块以响应事件,而不必运行他们自己编写的代码。
虽然对通用行为可以连接的标记类型或事件类型没有限制,但由于对该行为指定的操作可以在它们定义的、能在事件处理程序中运行的上下文中运行,因此您必须谨慎地进行处理。例如,在 onresize 事件处理程序中执行警报操作并不明智。通用行为并不会检查操作在其运行上下文中是否有意义。因此,编码者/设计者必须负责确保该操作在其上下文中有意义。
<hx:behavior>
与任何支持事件处理程序的 HTML 标记配合使用。
hX_5.addBehavior("id", "eventname", new hX_5.JSFBehaviorGeneric(attributes)); 其中
id |
组件所连接至的 HTML 标记的 ID。 |
属性 |
逗号分隔的属性列表,其中每个属性都是一个加引号的字符串,此字符串包含使用冒号分隔的属性名称和值,例如,"label:MyLabel"。 |
eventname |
调用行为的 HTML 事件名称。例如,onclick 或 onkeydown。每个行为仅支持一些 HTML 事件名称,例如,mouseclick 行为不能与键盘事件绑定。在某些情况下,此行为需要与多个 HTML 事件绑定,此时将使用一个“伪”事件名称。例如,将 mouseclick 行为与多个事件绑定,因此事件名称是“onmouse”。 |
事件 |
描述 |
---|---|
any |
虽然通常此事件与键盘处理程序、鼠标处理程序以及获得焦点和失去焦点处理程序配合使用,但所有事件处理程序均受支持。 |
属性名称 |
描述 |
---|---|
action |
单击一个可单击实体时所要执行的一个或一组操作。通常需要该操作的一个或一组目标。 |
target |
如果提供,则为页面中 input type='text' 字段的 ID。每次在菜单中选择一个菜单项时,该菜单项的文本都会设置为指定字段的值。此属性通常仅适用于生成一个仿真组合框的弹出菜单,即,您有一个输入字段,该字段带有一个顶级菜单为单按钮的邻近菜单,单击该按钮将显示菜单,从此菜单中选择一个菜单项将设置输入字段的值。 |
function |
按下按键时要执行的 JavaScript 函数或 JavaScript 的内联字符串。 |
在为该事件提供的任何其他处理程序运行完成后运行。
如果该操作停止了该事件,则停止进行事件继续/冒泡。
API 调用 |
描述 |
---|---|
object = setAttribute(attribute) |
设置属性,或如果以前已设置属性,则更改其值。 |
string = getAttribute(attribute-name) |
检索属性的当前值。 |
如上所述,将不合适的操作与标记/事件绑定会导致浏览器工作失常。