通用行为

通用行为使您能够将 JSF 操作连接至任何 HTML 标记的任何事件处理程序。

通用行为用于执行 JSF 操作,以响应对任何标记触发的任何事件。通用行为提供了一种机制,用户可以通过此机制运行预定义的便捷 JavaScript™ 功能块以响应事件,而不必运行他们自己编写的代码。

虽然对通用行为可以连接的标记类型或事件类型没有限制,但由于对该行为指定的操作可以在它们定义的、能在事件处理程序中运行的上下文中运行,因此您必须谨慎地进行处理。例如,在 onresize 事件处理程序中执行警报操作并不明智。通用行为并不会检查操作在其运行上下文中是否有意义。因此,编码者/设计者必须负责确保该操作在其上下文中有意义。

发送组件的 JSF 标记

<hx:behavior>

基本 HTML

与任何支持事件处理程序的 HTML 标记配合使用。

JavaScript 构造函数

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

虽然通常此事件与键盘处理程序、鼠标处理程序以及获得焦点和失去焦点处理程序配合使用,但所有事件处理程序均受支持。

属性

表 1. 通用行为属性

属性名称

描述

action

单击一个可单击实体时所要执行的一个或一组操作。通常需要该操作的一个或一组目标。

target

如果提供,则为页面中 input type='text' 字段的 ID。每次在菜单中选择一个菜单项时,该菜单项的文本都会设置为指定字段的值。此属性通常仅适用于生成一个仿真组合框的弹出菜单,即,您有一个输入字段,该字段带有一个顶级菜单为单按钮的邻近菜单,单击该按钮将显示菜单,从此菜单中选择一个菜单项将设置输入字段的值。

function

按下按键时要执行的 JavaScript 函数或 JavaScript 的内联字符串。

序列

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

如果该操作停止了该事件,则停止进行事件继续/冒泡。

API 调用

API 调用

描述

object = setAttribute(attribute)

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

string = getAttribute(attribute-name)

检索属性的当前值。

局限性

如上所述,将不合适的操作与标记/事件绑定会导致浏览器工作失常。


反馈