日期:2011-08-17 浏览次数:20477 次
SP.NET Atlas中引入了客户端控件的概念,用面向对象思想将客户端JavaScript将要操作的DOM元素封装起来,带来了更清晰的代码模型以及更好的可复用性(不足之处是效率有所降低)。Atlas的客户端控件是连接JavaScript与DOM元素的桥梁,我们应该尽可能的使用客户端控件与DOM元素打交道,也就是以Atlas的方法来编写我们的程序。同时,Atlas对JavaScript面向对象方面的强大扩展(请参考:ASP.NET Atlas对JavaScript的扩展),也让我们很容易通过继承,覆写等方法来构建自定义的控件。
在前面的一些帖子中,我介绍了一些Atlas中较复杂的控件。但同时,Atlas也提供了一些比较简单/基础的客户端控件,同样在开发中十分有用,让我们通过这个系列来熟悉Atlas自带的简单客户端控件。
所有的Atlas客户端控件都继承于Sys.UI.Control基类,同时Sys.UI.Control继承于Sys.Component基类,让我们先看看Sys.Component提供的属性:
1. id:Atlas组件的标识符,将Atlas客户端组件与DOM元素连接起来。这个id值与DOM元素的id属性值相同,Atlas使用这个id以找到相关的DOM元素。
2. bindings:该组件的绑定集合。关于Atlas中的绑定,请参考:Atlas揭秘 —— 绑定(Binding)。
3. dataContext:该组件的绑定的操作对象。如果您设置了这个属性,那么所有绑定条目默认会继承这个对象,但您也可以在绑定的声明中覆盖这个默认的设定。
4. isInitialized:布尔值,代表该组件是否被初始化过。只读。
5. isUpdating:该组件是否正在更新中,在开始调用beginUpdate()方法到调用endUpdate()方法期间为true,其他时间为false。只读。
Sys.Component还提供如下的方法:
1. beginUpdate与endUpdate:依赖于基类的实现,可以通过调用这两个方法延迟或一起更新一批组件,以提高性能或减少屏幕闪烁。
2. initialize:构造函数,不必多言,继承类可以扩展该方法并初始化自己的成员。
还有如下事件:
1. propertyChanged:当组件的某个属性变化时,应该引发该事件。Atlas绑定的实现依赖于这个事件。
现在让我们看看Sys.UI.Control提供的属性:
1. accessKey:获取或设置控件的accessKey,该属性是DOM元素中的accessKey属性的包装。
2. associatedElement:返回控件的相关DOM元素。这个属性应该传入给控件的构造函数,并在构造以后不可以修改。
3. behaviors:该组件的Behavior集合。关于Atlas中的Behavior,请参考:在ASP.NET Atlas中创建自定义的Behavior。
4. cssClass:获取或设置控件的CSS Class,该属性是DOM元素中的class属性的包装。
5. enabled:代表该控件是否被启用,该属性是DOM元素中的enabled属性的包装。
6. parent:获取或设置该控件的父控件。
7. style:获取该控件相对应的DOM元素的style属性值。
8. tabIndex:获取或设置该控件的tab index。
9. visibilityMode:获取或设置该控件在隐藏时的显示模式,可选枚举值:Sys.UI.VisibilityMode.Collapse代表该控件隐藏时不占用页面空间,Sys.UI.VisibilityMode.Hidden代表该控件隐藏时依然占有其位置。
10. visible:获取或设置该控件是否可见。
Sys.UI.Control同样提供如下方法:
1. addCssClass:为该控件添加一个CSS Class。
2. removeCssClass:删除该控件的一个CSS Class。
3. containsCssClass:返回布尔值,代表该控件是否有指定的CSS Class。
4. toggleCssClass:如果该控件没有指定的CSS Class,则添加,如果有,则删除。
5. focus:使该控件获得输入焦点。
6. scrollIntoView:使该控件滚动到屏幕可视范围内。
7. onBubbleEvent:处理该控件的子控件发出的Bubble事件。您可以在这篇文章:使用 ASP.NET Atlas PageNavigator控件实现客户端分页导航中找到该方法的实际应用。
8. raiseBubbleEvent:该方法会调用该控件所有父控件的onBubbleEvent方法,来实现Bubble事件。您可以在这篇文章:使用 ASP.NET Atlas PageNavigator控件实现客户端分页导航中找到该方法的实际应用。
Atlas
中的客户端控件均继承或间接继承于Sys.UI.Control基类(请参考:ASP.NET Atlas简单控件介绍——Sys.Component基类与Sys.UI.Control基类),并有所扩展,本文将介绍Atlas内建的简单控件InputControl,TextBox,Button和CheckBox。
Sys.UI.InputControl
InputControl类是一个抽象类,作为所有提供用户输入的控件(例如TextBox,见下文)的基类,提供了输入数据验证等公有操作。InputControl抽象类提供如下属性:
1. isValid:该属性为只读,返回布尔值,代表输入数据经过验证后是否合法,即是否通过了所有Validator(请参考:在ASP.NET Atlas中创建自定义的Validator)的验证。
2. validationMessage:该属性为只读,返回String。当验证失败时,它包含第一个引发失败的Validator的错误信息;若验证成功,则为空字符串。
3. validators:返回该InputControl的Validator集合,您可以通过这个属性添加/删除某个Validator来实现对用户输入信息的验证。
Sys.UI.TextBox
TextBox控件是任何一种GUI都必须提供的控件之一,也是我们最常用的和用户交互的控件之一。Atlas中的TextBox封装了type为input的DOM元素input,或是DOM元素textarea,继承于InputControl基类以获得输入数据验证的功能。TextBox提供如下属性。
1. text:获取或设置TextBox中的文字。
正因为TextBox在实际程序设计中非常常用,所以我们也经常需要对它的扩展。关于对TextBox空间的扩展,有兴趣的朋友请参考:
1. 使用ASP.NET&