事件处理程序

许多 Faces 组件都有相关联的事件。例如,“按钮 - 命令”组件与诸如 onclick 和 onmousedown 之类的事件相关联。通过使用所选 Faces 组件的“快速编辑”视图,可以定义特定事件的操作。

在组件的“快速编辑”视图的左窗格中选择事件后,可以在“快速编辑”视图的右窗格中输入 JavaScript™ 代码。此代码表示调用事件时执行的操作。

下表提供了选项卡式面板组件事件以及选项卡式面板组件中各个面板的事件。
事件 描述 受支持的组件
oncancel 启用此事件后,当用户单击取消时,将触发此事件。借助此事件的事件处理程序,可以添加任何业务逻辑,例如清除用户在某些输入字段中填写的值。此事件对象有一个属性:tabpanelForm,即选项卡式面板的外围 HTML 表单。 选项卡式面板
onenter 当进入选项卡式面板中的某个面板时,将触发此事件。如果事件处理程序返回 true,则可以进入选项卡式面板中的新面板;否则,焦点仍留在原来的面板上。借助此事件的事件处理程序,可以执行多项操作,例如对用户输入的信息进行验证或者准备面板所要显示的信息。此事件对象有一个属性:tobeEnterPanel,即将要进入的面板的 ID。 选项卡式面板中的面板
onexit 当退出选项卡式面板中的某个面板时,将触发此事件。事件处理程序可以返回三个不同的值。如果返回面板 ID,则将进入该面板,而不是进入缺省的下一个面板。True,将显示缺省的下一个面板。如果返回 False 或者未返回任何内容,则焦点将留在当前面板上。借助此事件的事件处理程序,可以添加任意业务逻辑,如用户输入验证、如果验证失败拒绝离开面板或控制下一个面板的流向。当“选项卡式面板”和“下一步”和“上一步”按钮一起使用时,可以使用此事件处理程序来创建复杂的流向控制。此事件对象有一个属性:tobeExitPanel,即将要进入的面板的 ID。 选项卡式面板中的面板
onfinish 选项卡式面板控件支持 onfinish 事件。启用此事件后,当用户单击“完成”时,将触发此事件。借助此事件的事件处理程序,可以添加任意业务逻辑,例如,验证用户输入信息并提交表单。此事件对象有一个属性:tabpanelForm,即选项卡式面板的外围 HTML 表单。 选项卡式面板
oninitialpanelshow 在页面上呈示选项卡式面板之前,将触发此事件。事件处理程序的返回值确定首先激活的面板。如果没有返回值,则将显示第一个面板。如果用户希望首先显示除第一个面板以外的面板,则返回值必须是该面板的 ID。 选项卡式面板
onpanelenter “选项卡式面板”控件支持 onpanelenter 事件,当用户进入“选项卡式面板”中的任何面板时,都将触发该事件。如果此面板已经具有 onenter 事件的事件处理程序,则该事件将会在此事件之前被调用。如果该事件处理程序返回 true,则可以进入选项卡式面板中新的面板;否则,焦点仍留在原来的面板上。借助此事件的事件处理程序,可以添加一些进入任何面板时需要调用的公共业务逻辑。此事件对象有一个属性:tobeEnterPanel,即将要进入的面板的 ID。 选项卡式面板
onpanelexit “选项卡式面板”控件支持 onpanelexit 事件,当用户退出“选项卡式面板”中的任何面板时,将触发该事件。如果此面板已经具有 onexit 事件的事件处理程序,则该事件将会在此之前被调用。如果该事件处理程序返回 true,则可以退出选项卡式面板上的该面板;否则,焦点仍留在原来的面板上。借助此事件的事件处理程序,可以添加一些退出任何面板时需要调用的公共业务逻辑。此事件对象有一个属性:tobeExitPanel,即将要退出的面板的 ID。 选项卡式面板

反馈