Faces Client 组件事件处理程序允许您定义 Faces Client 组件的特定事件;事件处理程序允许您将一个 Faces Client 组件的事件连接至另一个 Faces Client 组件和某些 Faces 组件。还可以将
Faces Client 事件连接至 HTML 控件或 JavaScript™ 中可能的任何其他定制逻辑。
注: 一些 Faces Client 组件和客户机数据已停用,建议不要使用。
以下各项已停用,建议不要使用:
- 客户机数据及其相关联的工具(例如,“客户机数据”视图)
- Faces Client 组件
- <odc:dataGrid>(数据网格)
- <odc:webService>(Web Service)
- <odc:clientData>
- <odc:clientBinder>
例如,假定使用数据树来表示公司,数据树的每个节点则是不同的部门。每个部门都是客户机数据对象,而部门名是属性。每个部门的名称都显示为数据树的节点。客户机数据对象是使用数据网格创建的,它包含特定部门中各个职员的姓名。当突出显示数据树中的另一部门时,那个部门将成为数据网格的根对象,该数据网格会被刷新以显示那个部门的职员。在“快速编辑”视图中定义的事件处理程序允许这一交互。
注: 一旦选择了事件处理程序,就必须在“快速编辑”视图的右窗格中输入 JavaScript™ 代码。此代码将成为在调用事件(例如,onhighlight)时执行的操作。
以下列表包括可能会出现在“快速编辑”视图的左窗格中、对应于特定 Faces Client
组件的 Faces Client 事件。
数据树
- onhighlight
- 数据网格和数据树组件支持 onhighlight 事件。当数据网格中的某行或数据树中的某个节点被用户突出显示或单击时,将触发该事件。该事件对象有两个属性。
- eobject - 映射至突出显示的行或节点的对象(例如,部门)
- propertyName - 用户单击的对象属性的名称,例如,部门名,它仅适用于数据树。
- onselect / onunselect
- 数据网格和数据树组件支持 onselect 和 onunselect 事件。当用户对数据树中的某个节点或数据网格中的某行选择或取消选择复选框或者对数据网格中的某行选择或取消选择单选按钮时,将触发这些事件。
- eobject - 映射至当前选择或取消选择的行或节点的对象。
- checkedItemsArray - 当前选择的行或节点的列表对象,例如,职员对象。
- onnodehighlight
- 数据树组件支持 onnodehighlight 事件。当数据树中的任何节点被用户突出显示时,将触发该事件。如果特定节点已具有 onhighlight 事件的处理程序,则在调用 onnodehighlight 事件处理程序之前会调用 onhighlight 事件处理程序。该事件对象有两个属性。
- eobject - 映射至被突出显示的节点的对象,例如,部门。
- propertyName - 用户单击的对象属性的名称,例如,部门名。
- onnodeselect/onnodeunselect
- 数据树组件支持 onnodeselect 和 onnodeunselect 事件。选择或取消选择数据树中的任何节点之后,将触发这些事件。如果特定节点的 onselect 或 onunselect 事件已经有对应的事件处理程序,则在调用 onnodeselect/onnodeunselect 事件处理程序之前会调用 onselect/onunselect 事件处理程序。该事件对象有两个属性。
- eobject - 映射至当前选择或取消选择的节点的对象。
- checkedItemsArray - 当前选择的节点的列表对象,例如,职员对象。
- onexpand
- 当展开数据树中的特定节点时,将触发此事件。该事件对象有 3 个属性。
- eobject - 这是映射至用户所单击的节点的对象。
- openedItemsArray - 这是包含 eobject(它们表示数据树中当前已展开的所有节点)的数组。
- levels - 它是一个整数,表示要展开的层数。如果该值为 -1,则将展开当前所展开节点下面的所有节点。如果该值为
1,则将只展开所单击的节点。
- oncollapse
- 当折叠数据树中的特定节点时,将触发此事件。该事件对象有 3 个属性。
- eobject - 这是映射至用户所单击的节点的对象。
- openedItemsArray - 这是包含 eobject(它们表示数据树中当前已展开的所有节点)的数组。
- levels - 它是一个整数,表示要折叠的层数。如果该值为 -1,则还将折叠当前折叠的节点下面的所有节点。如果该值为
1,则将只折叠所单击的节点。
- onnodeexpand
- 当展开数据树中的任何节点时,将触发此事件。如果此事件被触发的数据树节点已具有 onexpand 事件的处理程序,则调用 onnodeexpand 事件处理程序之前会调用 onexpand 事件处理程序。该事件对象有 3 个属性。
- eobject - 这是映射至用户所单击的节点的对象。
- openedItemsArray - 这是包含 eobject(它们表示数据树中当前已展开的所有节点)的数组。
- levels - 它是一个整数,表示要展开的层数。如果该值为 -1,则将展开当前所展开节点下面的所有节点。如果该值为
1,则将只展开所单击的节点。
- onnodecollapse
- 当折叠数据树中的任何节点时,将触发此事件。如果要折叠的数据树节点已具有 oncollapse 事件的处理程序,则在调用 onnodecollapse 事件处理程序之前会调用 oncollapse 事件处理程序。该事件对象有 3 个属性。
- eobject - 这是映射至用户所单击的节点的对象。
- openedItemsArray - 这是包含 eobject(它们表示数据树中当前已展开的所有节点)的数组。
- levels - 它是一个整数,表示要折叠的层数。如果该值为 -1,则还将折叠当前折叠的节点下面的所有节点。如果该值为
1,则将只折叠所单击的节点。
有关 eObject 的更多信息,请参阅第 6 章:FacesClient Components Developer's Guide 中的 JavaScript 库。
数据网格
- onhighlight
- 数据网格和数据树组件支持 onhighlight 事件。当数据网格中的某行或数据树中的某个节点被用户突出显示或单击时,将触发该事件。该事件对象有两个属性。
- eobject - 映射至突出显示的行或节点的对象(例如,部门)
- propertyName - 用户单击的对象属性的名称,例如,部门名,它仅适用于数据树。
- onselect / onunselect
- 数据网格和数据树组件支持 onselect 和 onunselect 事件。当用户对数据树中的某个节点或数据网格中的某行选择或取消选择复选框或者对数据网格中的某行选择或取消选择单选按钮时,将触发这些事件。
- eobject - 映射至当前选择或取消选择的行或节点的对象。
- checkedItemsArray - 当前选择的行或节点的列表对象,例如,职员对象。
- onnodeselect/onnodeunselect
- 数据网格和数据树组件支持 onnodeselect 和 onnodeunselect 事件。选择或取消选择数据树中的任何节点之后,将触发这些事件。如果特定节点的 onselect 或 onunselect 事件已经有对应的事件处理程序,则在调用 onnodeselect/onnodeunselect 事件处理程序之前会调用 onselect/onunselect 事件处理程序。该事件对象有两个属性。
- eobject - 映射至当前选择或取消选择的节点的对象。
- checkedItemsArray - 当前选择的节点的列表对象,例如,职员对象。
- onfilter
- 当数据网格使用用户提供的数据网格“属性视图”中的“行过滤器”表达式过滤数据时,会触发 onfilter 事件。此事件对象有一个属性。
- filterExpression - 这是用户提供的用于过滤数据的 JavaScript 表达式。
- onpage
- 当用户在数据网格的不同页面之间切换时,将触发 onpage 事件。该事件对象有两个属性。
- pageSelectChoice - 此属性的值告诉用户:他(或她)是浏览至下一页、上一页、第一页或最后一页了,还是通过指定页码跳到了特定的页面。相应地,此属性的值将为下一页、上一页、第一页、最后一页或跳到。
- pageStartIndex - 此属性的值告诉您该页面上显示的第一项的索引。例如,如果用户在每个页面上显示 5 项并跳到第二页上,则此属性的值将为 6。
- onsort
- 当用户单击数据网格中的其中一列以对它进行排序时,将触发此事件。该事件对象有两个属性。
- sortOrder - 此属性的值告诉用户排序是按升序还是降序进行的。相应地,此属性的值将为升序或降序。
- propertyName - 此属性的值是 bean 属性的名称,bean 属性用来显示要排序的列中的值。
- onselectall
- 当用户选择数据网格中的所有行时,该网格将触发此事件,但是只会对具有选择的列的数据网格触发该事件。该事件对象有两个属性。
- allEobjs - 这是包含当前绑定至数据网格的所有对象的数组。例如,如果数据网格正在显示部门列表,则该数组中的每一项都将是部门对象。
- toBeSelectEobjs - 这是数据网格中作为调用“全部选中”操作的结果而选择的一组对象。
- onunselectall
- 当用户取消选择数据网格中的所有行时,该网格将触发此事件,但是,只会对具有选择的列的数据网格触发该事件。该事件对象有两个属性。
- allEobjs - 这是包含当前绑定至数据网格的所有对象的数组。例如,如果数据网格正在显示部门列表,则该数组中的每一项都将是部门对象。
- toBeUnselectedEobjs - 这是数据网格中作为调用“全部不选”操作的结果而取消选择的一组对象。
注: 如果在处理程序属性的参数中包括字符串变量,则必须确保对所有引号正确进行了转义。