一,什么是forward
forward属性是zk提供的一个事件转发特性,
该特性将自身的某个原始事件转发到指定的目标组件上
或者将自身的onClick事件转发给另外一个事件
二,forwrd的格式
forward属性可以定义为如下格式
1#,forward="target_event_expr"
2#,forward="oringal_event=target_event_expr"
1.1-----如果未指定oringal_event原始事件,默认为onClick事件
所以第1种的完整写法是forward="onClick=target_event_expr",
1.2-----第二种格式,你可以随意定义原始事件
例如:<button forward="onMouseOver=onSavePosition"/>
<button forward="onBlur=targetId.onClick"/>
第二种方式是一个通用格式,但大部分情况下我们使用的是onClick事件,
所以提供了格式1,方便我们的开发
1.2.1------target_event_expr是一个表达式,这个表达式也有几种写法:
1#,event-name
2#,target-id.event-name
3#,id1/id2/id3.event-name
4#,${el-expr}.event-name
三,forward的目标是谁?
在上例子中
<button forward="onMouseOver=onSavePosition"/>
onSavePosition是谁的事件呢?
而<button forward="onSavePosition"/>中onSavePosition事件又是谁的呢?
在这两个例子中,都不属于以下类型,以下三种都指定了目标组件
1#,target-id.event-name
2#,id1/id2/id3.event-name
3#,${el-expr}.event-name
event-name前未指定目标组件,那么zk如何处理???
在zk的组件创建阶段,组件创建完毕后,有这么一段代码
ComponentsCtrl.applyForward(child, childInfo.getForward());(zk5.0.6 UiEngineImpl 743行)
该代码的作用是应用forward表达式,创建EventListener监听器,由此我们还可以知道forward其实
与comp.addEventListener差不多的
然后我们找,找到我们感兴趣的代码,
然后我找到了AbstractComponent的ForwardEventListener
的onEvent方法(zk5.0.6 AbstractComponent 2973行)
public void onEvent(Event event) {
final Object[] info = (Object[])_auxinf.forwards.get(_orgEvent);
if (info != null)
for (Iterator it = new ArrayList((List)info[1]).iterator();
it.hasNext();) {
final Object[] fwd = (Object[])it.next();
Component target = resolveForwardTarget(fwd[0]);
if (target == null) {
final IdSpace owner = getSpaceOwner();
if (owner instanceof Component) {
target = (Component)owner;
} else {
//Use the root component instead
for (target = AbstractComponent.this;;) {
final Component p = target.getParent();
if (p == null)
break;
target = p;
}
}
}
//bug #2790393 Forward event listener shall be called immediately
//(since 3.6.2) change from postEvent to sendEvent to
//make forward event deterministic
Events.sendEvent(
new ForwardEvent((String)fwd[1], target, event, fwd[2]));
}
}
为了方便理解,我解释一下关键代码的意思,假如转发到的目标target组件为空,首先检测该组件的所属命
名空间是否为一个组件, 如果是一个组件类型,那么设置该命名空间为目标组件,反之将循环迭代获取,直至获取该组件的根组件,即root component
那么上面我们产生的疑问就豁然开朗了,
那么实际开发中我们需要注意什么
1,首先在mvc模式开发中,controller(use或apply指定的类)最好建立在forward组件所属的命名空间上
2,如果没有命名空间,那么将controller(use或apply指定的类)放在root component
四,传递参数
1,forward="target_event_expr"
2,forward="oringal_event=target_event_expr"
其中target_event_expr目标事件表达式,有四个类型
1#,event-name
2#,target-id.event-name
3#,id1/id2/id3.event-name
4#,${el-expr}.event-name
这四种类型的event-name也可以使用()号,像方法一样也可以有参数,这个参数可以是el表达式,
a,<button forward="onSomeEvent(${2+2})"/>
b,<label id="compId"/><button forward="onBlur=onSomeEvent(compId)"/>
b,<button forward="onBlur=compId.onSomeEvent("你好我是参数")"/>
在事件方法中onSomeEvent(Event event){
event.getData();//返回传递的参数
}