许多 Faces 组件都具有与它们相关联的事件。例如,“命令 - 按钮”组件具有诸如 onclick 和 onmousedown 之类的事件和它相关联。使用选定 Faces 组件的“快速编辑”视图,可以定义特定事件的操作。
一旦在组件的“快速编辑”视图左窗格中选择了事件,就可以在“快速编辑”视图的右窗格中输入 JavaScript™ 代码。此代码表示调用事件时执行的操作。
下表包括选项卡式面板组件和选项卡式面板组件中面板的事件。事件 | 描述 | 受支持的组件 |
---|---|---|
oncancel | 如果已启用它,则当用户单击取消时将激发它。借助此事件的事件处理程序,可以添加任意业务逻辑,例如,清除用户在某些输入字段中填写的值。该事件对象具有一个属性。tabpanelForm - 内含选项卡式面板的 HTML 表单(如果有的话)。 | 选项卡式面板 |
onenter | 当进入“选项卡式面板”中的面板时,就会激发它。如果该事件处理程序返回 true,则可以进入选项卡式面板中新的面板;否则,焦点仍留在原来的面板上。借助此事件的事件处理程序,可以处理诸如此类的事情:验证用户输入的信息或准备在面板中显示的信息。该事件对象具有一个属性。tobeEnterPanel - 将进入的面板的标识。 | 选项卡式面板中的面板 |
onexit | 当退出“选项卡式面板”中的面板时,就会激发它。事件处理程序能够返回三个不同的值,面板标识(它是将进入的下一个面板标识而不是缺省的下一个面板标识)。True,将显示缺省的下一个面板。False 或不返回任何东西,焦点留在当前面板上。借助此事件的事件处理程序,可以添加任意业务逻辑(如用户输入验证、如果验证失败拒绝离开面板或控制下一个面板的流向)。当“选项卡式面板”和“下一步”和“上一步”按钮一起使用时,可以使用此事件处理程序来创建复杂的流向控制。该事件对象具有一个属性。tobeExitPanel - 将进入的面板的标识。 | 选项卡式面板中的面板 |
onfinish | “选项卡式面板”控件支持 onfinish 事件,如果该事件被启用,则当用户按“完成”时,事件被激发。借助此事件的事件处理程序,可以添加任意业务逻辑,例如,验证用户输入信息并提交表单。事件对象具有一个属性 tabpanelForm - 内含选项卡式面板的 HTML 表单(如果有的话)。 | 选项卡式面板 |
oninitialpanelshow | 选项卡式面板呈示在页面之前,激发此事件。事件处理程序的返回值确定首先激活的面板。如果没有返回值,则将显示第一个面板。如果用户想要开始显示的面板不是第一个面板,则返回值必须是该面板的标识。 | 选项卡式面板 |
onpanelenter | “选项卡式面板”控件支持 onpanelenter 事件,当用户进入“选项卡式面板”中的任何面板时,都会激发它。如果此面板已经具有 onenter 事件的事件处理程序,则该事件将会在此事件之前被调用。如果该事件处理程序返回 true,则可以进入选项卡式面板中新的面板;否则,焦点仍留在原来的面板上。借助此事件的事件处理程序,可以添加一些进入任何面板时需要调用的公共业务逻辑。该事件对象具有一个属性。tobeEnterPanel-将进入的面板的标识。 | 选项卡式面板 |
onpanelexit | “选项卡式面板”控件支持 onpanelexit 事件,当用户退出“选项卡式面板”中的任何面板时,就会激发它。如果此面板已经具有 onexit 事件的事件处理程序,则该事件将会在此之前被调用。如果该事件处理程序返回 true,则可以退出选项卡式面板上的该面板;否则,焦点仍留在原来的面板上。借助此事件的事件处理程序,可以添加一些退出任何面板时需要调用的公共业务逻辑。该事件对象具有一个属性。tobeExitPanel - 将退出的面板的标识。 | 选项卡式面板 |