操作

JSF 行为通常将操作作为它们的其中一个属性。操作是执行禁用字段等常用 JavaScript™ 任务的简易方法。

操作具有作为独立属性指定的可选目标。目标是操作所处理的对象,例如,操作标识了应该禁用的字段。

通过指定多个由分号分隔的操作作为一个属性值,可以执行一系列操作。使用这种语法,还可以指定多个目标。目标将按顺序与操作配对,因此,目标数与操作数应该相同。

例如,下列属性指定应该禁用某个字段并启用另一个字段:

操作将返回 true 或 false。如果操作返回 false,则操作列表的处理过程将停止。某些操作始终返回 false,因而必须是列表中的最后一个操作,例如用于设置焦点的操作。某些操作是有条件的,即根据操作情况返回 true 或 false,因此可以用来有条件地执行一系列操作。
"action:UNLOCKED;LOCKED", "target:form1:text2;form1:text3"
如果某个操作返回 true,但您想要停止触发该操作的底层事件,例如,您正在编码 onclick 事件并对其指定了执行 HIDE 操作的常规行为,则应该在该操作完成后执行返回 false 的“NOTHING”操作。例如:
<hx:behavior event="onclick" behaviorAction="hide;nothing" actionTarget="div1" />

JWL 操作列表

表 1. JWL 操作列表

操作

目标

结果

描述

GOTO

url('value')

true

转至指定页面。注意目标的语法。

LOCKED

id

true

禁用指定的标记。如果标记是容器,例如 div,则禁用该标记中的所有标记。禁用指定的标记。如果标记是容器,例如 div,则禁用该标记中的所有标记。

UNLOCKED

id

true

启用指定的标记。如果标记是容器,例如 div,则启用该标记中的所有标记。

INVERTLOCKED

id

true

反转指定标记的已禁用状态。如果标记是容器,则将该标记中的所有标记设置为相同的状态。

SHOW

id

true

显示指定的标记。

HIDE

id

true

隐藏指定的标记。

INVERTHIDE

id

true

反转指定标记的显示。

VISIBLE

id

true

使指定的标记可视。

INVISIBLE

id

true

使指定的标记不可视。
注: 如果标记被隐藏,则看不到它,而且它不占用任何空间。如果标记不可视,虽然看不到它,但它会占用空间,即,标记还在那里,只是未绘制该标记的任何像素。

INVERTVISIBLE

id

true

反转指定标记的可视性。

NEXTTAB

id

true

根据与指定标识相关的跳进顺序前进到下一控件。

NEXTTABCLEAR

id

true

清除(删除)字段中从光标位置到字段结尾的所有字符,然后根据与指定标识相关的跳进顺序前进到下一控件。

PREVTAB

id

true

根据与指定标识相关的跳进顺序前进到上一控件。

PREVTABCLEAR

id

true

清除(删除)字段中从光标位置到字段结尾的所有字符,然后根据与指定标识相关的跳进顺序前进到上一控件。

CLICK

id

false

“单击”由指定标识所标识的控件。

SUBMIT

id

false

使用指定标识提交表单。该 ID 可以是表单中任何字段的 ID,也可以是表单自身的 ID。如果此 ID 用于标识提交按钮,则将使用该按钮来提交表单。如果此 ID 用于标识表单中的任何其他标记或者表单自身,则将使用表单中的第一个提交按钮来进行提交。使用提交按钮而不是 form.submit() 来完成提交将触发表单的 onsubmit 处理程序。

FOCUS

id

false

将焦点设置到指定的标记。根据浏览器的不同,获得焦点的字段的内容可能会/可能不会被选中。

SELECTED

id

false

将焦点设置到指定的标记并选择内容。

UNSELECTED

id

false

将焦点设置到指定的标记并取消选择内容。

ALERT

string

false

显示带有指定字符串作为消息的警报消息框。如果目标设置为特殊字符串 @ERROR,则事件对象中的(本地化)错误消息将显示为消息。

CONFIRM

string

如果“确定”,则为 true,否则为 false

显示带有指定字符串作为消息的“确认”(确定和取消)消息框。如果目标设置为特殊字符串 @ERROR,则事件对象中的(本地化)错误消息将显示为消息。

PADLEFT

id

true

建议不要使用。对由该 ID 所标识的字段的值进行填充,间隔可达到该字段的最大长度。在字段左边进行填充。

PADRIGHT

id

true

建议不要使用。对由该 ID 所标识的字段的值进行填充,间隔可达到该字段的最大长度。在字段右边进行填充。

TRIM

id

true

建议不要使用。除去该 ID 所标识的字段左边和右边的空格。

NOTHING

none

false

不执行任何操作。不单击键或鼠标时,对键绑定和鼠标绑定很有用。

注:
  • 如果指定了多个操作,则在列表中只能指定一个 NEXTTAB、PREVTAB、NEXTTABCLEAR 或 PREVTABCLEAR 操作。
  • 如果指定了多个操作,则在列表中只能指定一个 FOCUS、SELECTED 或 UNSELECTED 操作。
  • 如果字段不带焦点,则不会执行任何依赖于焦点的操作,例如 NEXTTAB。
  • 如果字段不带允许包含光标的焦点,则 NEXTTABCLEAR 等任何依赖于光标的操作都不会执行光标操作。

反馈