Microsoft AJAX Library 对中JS的封装

 

 

对Array类型的扩展：

[S]Array.add (array, item)：添加一项至Array的结尾。Array.add(a, 'e');

[S]Array.addRange (array, items)：将items中的项依次添加到Array的结尾。Array.addRange(a, b); a,b两个数组

[S]Array.clear (array)：清除该Array中的所有项。

[S]Array.clone (array)：返回该Array的浅拷贝（Shallow Copy）。

注意：浅拷贝只包含原Array中的项，无论是引用类型还是值类型。但浅拷贝并不会复制被引用的对象，新的Array和原Array中的某个元素引用的是同一个对象的实例。

[S] Array.contains (array, item)：判断指定的项是否包含在该Array中。

[S] Array.dequeue (array)：从原Array中删除第一项，并返回该项。

[S] Array.forEach (array, method, context)：依次访问该Array中的每一项，但跳过值为undefined的项。

[S] Array.indexOf (array, item, start)：在Array中搜索某一项，并返回其在该Array中的索引。若该Array中不包含该项，则返回-1。

[S] Array.insert (array, index, item) ：在Array中的某一位置插入新项。

[S] Array.parse (value) ：从字符串表达方式解析出真正的Array对象。

[S] Array.enqueue (array, item) ：添加一项至Array的结尾。请同时参考Array.dequeue (array)。

[S] Array.remove(array, item)：从该Array中移除（第一次出现的）该项。

[S] Array.removeAt(array, index) ：从该Array中移除指定索引位置上的项。

 

Boolean和Date类型的扩展

[S]Boolean.parse (value ) ：从字符串表示的布尔值解析成相应的Boolean类型。value参数必须为“true”或“false”二者之一，不区分大小写，且可以包含空格。var b = Boolean.parse("true");

Date.format (format)格式化字符串（区域设定无关）。

Date.localeFormat (format)格式化字符串（区域设定相关）。使用Sys.CultureInfo.CurrentCulture得到区域属性。

[S] Date.parseLocale (value, formats)从字符串表示的本地时间日期解析成相应的Date类型。使用Sys.CultureInfo.CurrentCulture得到区域属性。

[S] Date.parseInvariant (value, formats) ：从字符串表示的区域无关时间日期解析成相应的Date类型。

支持的格式：

d： 缩写日期(e.g.: 02/17/2007)：

D： 完整日期(e.g: Saturday, 17 February 2007)

t： 缩写时间(e.g.: 22:10)

T： 完整时间(e.g.: 22:10:30)

F： 完整时间日期(e.g.: Saturday, 17 February 2007 22:10:30)

m (or M)： 月和日(e.g.: February 17)

s： 可排序的时间日期(e.g.: 2007-02-17T22:10:30)

y (or Y)： 年和月(e.g.: 2007 February)

 

DomElement类

[S] getElementById (id, element)：在element所包含的元素中搜索特定id的元素，若不指定element，则默认为document。

[S] $get (id, element)：Sys.UI.DomElement.getElementById的简写形式。

[S] addCssClass (element, className)：将指定的CSS Class应用至该元素。

[S] containsCssClass (element, className)：判断该元素是否应用了指定的CSS Class。

[S] removeCssClass (element, className)：从该元素中移除指定的CSS Class。

[S] toggleCssClass (element, className)：若元素已经应用了该CSS Class，则将其移除；否则添加。

[S] getLocation (element)：取得元素相对于浏览器左上角的绝对位置，滚动出页面可见区域之外的距离也计算在内。

[S] setLocation (element, x, y)：设定元素相对于其定位元素左上角的位置。定位元素是指元素最近的应用了position（非static值）的祖先元素。

[S] getBounds (element)：取得元素的绝对位置以及其长宽，返回值对象包括如下几个属性：

x, y：取得元素相对于浏览器左上角的绝对位置，与Sys.UI.DomElement.getLocation()一样。

width：元素的宽度，包括border、padding以及滚动部分。

height：元素的高度，包括border、padding以及滚动部分。

var article = $get('article');

var bounds = Sys.UI.DomElement.getBounds (article);

Sys.Debug.traceDump (bounds, 'Article position and size');

 

DomEvent类:

[S] $addHandler (element, eventName, handler)：为DOM元素添加某一事件的处理函数，事件名称应去掉“on”前缀。

注意：在事件处理函数中，this指向的是element，而不一定是发出该事件的元素。

Sys.UI.DomEvent.addHandler (element, "click", clickHandler);

[S] $addHandlers (element, events, handlerOwner) ：为DOM元素添加多个事件处理函数，events是一个事件处理函数的字典。

注意：在事件处理函数中，若指定了handlerOwner，那么this将指向该handlerOwner，否则将指向element。

$addHandlers ($get ("article"), {

    mouseover: onMouseOver,

    mouseout: onMouseOut

});

[S] $clearHandlers (element)：移除指定DOM元素所有的事件处理函数。

Sys.UI.DomEvent.clearHandlers (element);

[S] $removeHandler (element, eventName, handler)：为DOM元素移除指定的事件处理函数。

Sys.UI.DomEvent.removeHandler (element, "click", clickHandler);

preventDefault ()：阻止执行默认的事件处理函数。例如若阻止了a元素的onclick事件，那么将不会引发页面导航。

stopPropagation ()：阻止事件冒泡传递至父元素。

 

Event对象的属性：

altKey：判断触发事件时Alt键是否被按下。

button：得到触发事件的鼠标按键。可选值为Sys.UI.MouseButton枚举（leftButton、middleButton和rightButton）。

charCode：得到触发事件时的键盘按键代码。可以为Sys.UI.Key枚举（backspace, tab, enter,esc, space, pageUp, pageDown, end, home, left, up, right, down, del）。

clientX：鼠标指针相对于文档可见区域的X坐标。

clientY：鼠标指针相对于文档可见区域的Y坐标。

ctrlKey：判断触发事件时Ctrl键是否被按下。

offsetX：鼠标指针相对于触发事件元素左侧边缘的偏移位置。

offsetY：鼠标指针相对于触发事件元素上边缘的偏移位置。

rawEvent：原始的DOM事件。

screenX：鼠标指针相对于浏览者屏幕的X坐标。

screenY：鼠标指针相对于浏览者屏幕的Y坐标。

shiftKey：判断触发事件时Shift键是否被按下。

target：触发事件的对象。

type：事件名称（例如“click”）。

 

Number和Error类型的扩展：

Number.format (format)：用指定的format格式化数字（区域设定无关）。

Number.localeFormat (format)：用指定的format格式化数字（区域设定相关）。

支持的格式：

p：将数字转为百分比字符串（e.g.: -1,234.56 %）

d：将数字装化为十进制字符串，没有逗号分隔符（e.g.: -1234.56）

c：将数字转化为货币金额形式（e.g.: (¤1,234.56)）

n：将数字串化为逗号三位分隔（-d,ddd,ddd.ddd…"）形式（e.g.: -1,234.56）

 

[S] Number.parseLocale (value) ：从字符串表示的本地数字解析成相应的Number类型。使用Sys.CultureInfo.CurrentCulture得到当前的区域属性。

[S] Number.parseInvariant (value)：从字符串表示的本地数字解析成相应的浮点数Number类型。value中可以包含逗号分隔符（,）或是正负（+-）号。

 

Error相关的方法：

[S] Error.argument：根据指定的异常信息和非法的参数创建一个Sys.ArgumentException类型的异常。

[S] Error.argumentNull：根据指定的异常信息和为Null的参数创建一个Sys.ArgumentNullException 类型的异常。

[S] Error.argumentType：根据指定的异常信息、期待参数类型和实际参数类型创建一个Sys.ArgumentTypeException 类型的异常。

[S] Error.argumentUndefined：根据指定的异常信息和为定义的参数创建一个Sys.ArgumentUndefinedException类型的异常。

[S] Error.create：根据指定的异常信息创建一个Error对象。

[S] Error.invalidOperation：根据指定的异常信息和引发该异常的参数创建一个Sys.InvalidOperationException 类型的异常。

[S] Error.notImplemented：根据指定的异常信息创建一个Sys.NotImplementedException类型的异常。

[S] Error.argumentOutOfRange：根据指定的异常信息和引发该异常的参数创建一个Sys.ArgumentOutOfRangeException类型的异常。

[S] Error.parameterCount：根据指定的异常信息创建一个Sys.ParameterCountException 类型的异常。

Error.popstackFrame：将该Error实例的fileName和lineNumber字段更新为该Error被掷出时的位置，而不是该Error被创建时的位置。

 

String和Object类型的扩展

String.endsWith (suffix)：判断该String是否以指定的后缀结束。

[S] String.format (format, args)：将该String中的各个格式化项用相应的参数值替代。args可以为单一的Object，或是一个包含多个项的Array。

[S] String.localeFormat (format, args)：功能与String.format (format, args)类似，不过格式化时与区域设定相关。

String.startsWith (prefix)：判断该String是否以指定的前缀开始。请参考String.endsWith (suffix)。

String.trim ()返回一个原String的拷贝，但将原String开头和结尾部分的所有空白字符（例如空格或Tab）都移除。

String.trimEnd ()：返回一个原String的拷贝，但将原String结尾部分的所有空白字符（例如空格或Tab）都移除。

String.trimStart ()：返回一个原String的拷贝，但将原String开头部分的所有空白字符（例如空格或Tab）都移除。

[S] Object.getType (instance):返回指定对象的类型，请参考Object.getTypeName (instance)。

[S] Object.getTypeName (instance):返回一个表示对象在运行时的完全限定类型的字符串。

 

其他：

Sys.Browsser

– agent：表示浏览器类型 g 表示浏览器类型

•Sys.Browser.InternetExplorer、

Sys.Browser.FireFox、Sys.Browser.Safari、 y y

Sys.Browser.Opera

– hasDebuggerStatement：是否支持“debugger”命令

– name：浏览器名称 name：浏览器名称

– version：浏览器版本