在ASP.NET Atlas中创建自定义的Behavior

English Version: http://dflying.dflying.net/1/archive/120_build_your_own_behaviors_in_aspnet_atlas.html

Atlas中的Behavior定义了当控件的某个事件被触发时的行为。Behavior可以看作是一种封装了的DHTML的事件,例如click和hover等。Behavior同样可以是一个组件,可被attach到某个Atlas客户端控件上,以提供这个Atlas客户端控件更高级,更丰富的功能,例如一些复杂的拖放(drag & drop),自动完成,浮动等功能。Behavior将被定义在某个Atlas控件的behaviors集合中。

从Atlas文档以及源文件中,我们可以知道Atlas有如下一些内建的Behavior:

  1. Click Behavior:提供对鼠标点击的处理。
  2. Floating Behavior:提供拖放(drag & drop)的效果。
  3. Hover Behavior:提供对DHTML的事件onmouseover,onmouseout,onfocus以及onblur的处理。
  4. Pop-up Component:提供pop-up的功能,可以用来实现高级的tooltip。
  5. Auto-complete Behavior:提供自动完成的功能。这也是Atlas演示中常用的功能之一。这个Behavior还需要服务器端的处理程序。

Click Behavior用来处理DHTML的onclick事件,非常有用但是它提供的功能有些简单。在一些比较复杂的程序中,我们可能需要将左右键的功能分开,例如,左键用来选择,右键用来弹出快捷菜单。虽然我们可以把这个if-else放在Click Behavior的处理函数中,但这并不是好的Atlas的方法。因此,今天我们来编写一个更加强大的Click Behavior,叫做ExtendedClickBehavior,它可以在Behavior的内部就把左右键分开,并且引发出两个不同的事件。通过编写这个ExtendedClickBehavior,您也可以了解在Atlas中创建自定义的Behavior的一般过程。

通常的,创建自定义的Behavior有如下5个步骤:

  1. 继承于Sys.UI.Behavior基类。
  2. 定义您自己的事件以封装DHTML中的事件。这些事件将被用来暴露给其他的Atlas控件以代替原有的,未经修饰的DHTML事件。
  3. 在Behavior的构造函数中为您的事件指定处理函数,并在析构函数中detach事件的处理函数。
  4. 在处理函数中发出相应的事件。在ExtendedClickBehavior的例子中,我们根据鼠标按键的不同来发出不同的事件。
  5. 在getDescriptor()方法中加上对您定义的事件的描述。

下面是ExtendedClickBehavior的JavaScript代码。上述五个步骤在代码内以注释的形式标出。将下面的代码保存为ExtendedClickBehavior.js。

Sys.UI.ExtendedClickBehavior = function() {
    Sys.UI.ExtendedClickBehavior.initializeBase(
this);
    
    
var _clickHandler;
    
    
// step 2
    this.click = this.createEvent();
    
this.leftClick = this.createEvent();
    
this.rightClick = this.createEvent();
    
    
this.dispose = function() {
        
// step 3
        this.control.element.detachEvent('onmousedown', _clickHandler);
        Sys.UI.ExtendedClickBehavior.callBaseMethod(
this, 'dispose');
    }


    
this.initialize = function() {
        Sys.UI.ExtendedClickBehavior.callBaseMethod(
this, 'initialize');

        
// step 3
        _clickHandler = Function.createDelegate(this, clickHandler);
        
this.control.element.attachEvent('onmousedown', _clickHandler);
    }

    
    
this.getDescriptor = function() {
        
var td = Sys.UI.ExtendedClickBehavior.callBaseMethod(this, 'getDescriptor');
        
        
// step 5
        td.addEvent('click', true);
        td.addEvent('leftClick', 
true);
        td.addEvent('rightClick', 
true);
        
return td;
    }

    
    
// step 4
    function clickHandler() {
        
this.click.invoke(this, Sys.EventArgs.Empty);
        
if (window.event.button == 1)
        
{
            
this.leftClick.invoke(this, Sys.EventArgs.Empty);
        }

        
else if (window.event.button == 2)
        
{
            
this.rightClick.invoke(this, Sys.EventArgs.Empty);
        }

    }

}

// step 1
Sys.UI.ExtendedClickBehavior.registerSealedClass('Sys.UI.ExtendedClickBehavior', Sys.UI.Behavior);
Sys.TypeDescriptor.addType('script', 'extendedClickBehavior', Sys.UI.ExtendedClickBehavior);

让我们在页面中测试一下这个ExtendedClickBehavior。在页面上添加一个<div>用来点击,一个label用来显示点击的信息。下面是ASPX文件中的HTML定义。不要忘记在ScriptManager中添加对ExtendedClickBehavior.js文件的引用。

<atlas:ScriptManager EnablePartialRendering="true" ID="ScriptManager1" runat="server">
    
<Scripts>
        
<atlas:ScriptReference Path="ExtendedClickBehavior.js" />
    
</Scripts>
</atlas:ScriptManager>
<div>
    
<div id="myButton" style="border: 1px solid black; width: 20em; white-space:normal">Click On Me (Left and Right)!</div> <br />
    
<span id="myLabel">not clicked</span>
</div>

下面是Atlas脚本定义。注意到我们使用了Atlas的setProperty Action(有关Atlas Action,请见后续文章)用来在每次点击后设置label的text。

<page xmlns:script="http://schemas.microsoft.com/xml-script/2005">
    
<components>
        
<label id="myButton">
            
<behaviors>
                
<extendedClickBehavior>
                    
<click>
                        
<setProperty target="myLabel" property="text" value="clicked" />
                    
</click>
                    
<leftClick>
                        
<setProperty target="myLabel" property="text" value="left clicked" />
                    
</leftClick>
                    
<rightClick>
                        
<setProperty target="myLabel" property="text" value="right clicked" />
                    
</rightClick>   
                
</extendedClickBehavior> 
            
</behaviors>
        
</label>
        
<label id="myLabel" />
    
</components>
</page>

 

浏览器中的运行结果:

没有点击:

左键点击:

右键点击:

上述示例程序可以在此下载:https://files.cnblogs.com/dflying/ExtendedClickBehaviorDemo.zip

posted on 2006-04-12 16:38  Dflying Chen  阅读(4845)  评论(32编辑  收藏  举报