BaseTypes

SuperMap 自定义类型扩展, 包含string, number, function and array.

Summary

BaseTypes	SuperMap 自定义类型扩展, 包含string, number, function and array.
SuperMap.String	字符串操作的一系列常用扩展函数.
Functions
camelize	骆驼式(“-”)连字符的字符串处理.
contains	判断目标字符串是否包含指定的子字符串.
format	提供带 ${token} 标记的字符串, 返回context对象属性中指定标记的属性值.
isNumeric	判断一个字符串是否只包含一个数值.
numericIf	把一个看似数值型的字符串转化为一个数值.
startsWith	判断目标字符串是否以指定的子字符串开头.
trim	删除一个字符串的开头和结尾处的所有空白字符.
SuperMap.Number	数值操作的一系列常用扩展函数.
Functions
format	数字格式化输出.
limitSigDigs	限制浮点数的有效数字位数.
Number.limitSigDigs	限制浮点数的有效数字位数.
SuperMap.Function	函数操作的一系列常用扩展函数.
Functions
bind	绑定函数到对象.方便创建this的作用域.
bindAsEventListener	绑定函数到对象,在调用该函数时配置并使用事件对象作为第一个参数.
False	该函数仅仅返回false.
True	该函数仅仅返回true.
Void	可重用函数,仅仅返回”undefined”.
SuperMap.Array	数组操作的一系列常用扩展函数.
Functions
filter	过滤数组.提供了ECMA-262标准中Array.prototype.filter函数的扩展.

SuperMap.String

字符串操作的一系列常用扩展函数.

Summary

Functions
startsWith	判断目标字符串是否以指定的子字符串开头.
contains	判断目标字符串是否包含指定的子字符串.
trim	删除一个字符串的开头和结尾处的所有空白字符.
camelize	骆驼式(“-”)连字符的字符串处理.
format	提供带 ${token} 标记的字符串, 返回context对象属性中指定标记的属性值.
isNumeric	判断一个字符串是否只包含一个数值.
numericIf	把一个看似数值型的字符串转化为一个数值.

Functions

startsWith

startsWith: function( str,

sub )

判断目标字符串是否以指定的子字符串开头.

Parameters

str	{String} 目标字符串.
sub	{String} 查找的子字符串.

Returns

{Boolean} 目标字符串以指定的子字符串开头,则返回true;否则返回false.

contains

contains: function( str,

sub )

判断目标字符串是否包含指定的子字符串.

Parameters

str	{String} 目标字符串.
sub	{String} 查找的子字符串.

Returns

{Boolean} 目标字符串中包含指定的子字符串,则返回true;否则返回false.

trim

trim: function( str )

删除一个字符串的开头和结尾处的所有空白字符.

Parameters

str	{String} (可能)存在空白字符填塞的字符串.

Returns

{String} 删除开头和结尾处空白字符后的字符串.

camelize

camelize: function( str )

骆驼式(“-”)连字符的字符串处理. 例如: “chicken-head” becomes “chickenHead”, “-chicken-head” becomes “ChickenHead”.

Parameters

str	{String} 要处理的字符串,原始内容不应被修改.

Returns

{String}

format

format: function( template,

context,

args )

提供带 ${token} 标记的字符串, 返回context对象属性中指定标记的属性值.

示例

1、template = "${value,getValue}";
        context = {value: {getValue:function(){return Math.max.apply(null,argument);}}};
        args = [2,23,12,36,21];
      返回值:36

示例:

2、template = "$${{value,getValue}}";
        context = {value: {getValue:function(){return Math.max.apply(null,argument);}}};
        args = [2,23,12,36,21];
      返回值:"${36}"

示例:

3、template = "${a,b}";
        context = {a: {b:"format"}};
        args = null;
      返回值:"format"

示例:

3、template = "${a,b}";
        context = null;
        args = null;
      返回值:"${a.b}"

Parameters

template	{String} 带标记的字符串将要被替换. 参数 template 格式为”${token}”,此处的 token 标记会替换为 context[“token”] 属性的值
context	{Object} 带有属性的可选对象的属性用于匹配格式化字符串中的标记. 如果该参数为空,将使用 window 对象.
args	{Array} 可选参数传递给在context对象上找到的函数.

Returns

{String} 从 context 对象属性中替换字符串标记位的字符串.

isNumeric

isNumeric: function( value )

判断一个字符串是否只包含一个数值.

例如

SuperMap.String.isNumeric("6.02e23") // true
SuperMap.String.isNumeric("12 dozen") // false
SuperMap.String.isNumeric("4") // true
SuperMap.String.isNumeric(" 4 ") // false

Returns

{Boolean} 字符串包含唯一的数值,返回true;否则返回false.

numericIf

numericIf: function( value )

把一个看似数值型的字符串转化为一个数值.

Returns {Number|String} 如果能转换为数值则返回数值,否则返回字符串本身.

SuperMap.Number

数值操作的一系列常用扩展函数.

Summary

Functions
limitSigDigs	限制浮点数的有效数字位数.
format	数字格式化输出.
Number.limitSigDigs	限制浮点数的有效数字位数.

Functions

limitSigDigs

limitSigDigs: function( num,

sig )

限制浮点数的有效数字位数.

Parameters

num	{Float}
sig	{Integer}

Returns

{Float} 将数字四舍五入到指定数量的有效位数.

format

format: function( num,

dec,

tsep,

dsep )

数字格式化输出.

Parameters

num	{Float}
dec	{Integer} 数字的小数部分四舍五入到指定的位数. 默认为 0. 设置为null值时小数部分不变.
tsep	{String} 千位分隔符. 默认为”,”.
dsep	{String} 小数点分隔符. 默认为”.”.

Returns

{String} 数字格式化后的字符串.

Number.limitSigDigs

限制浮点数的有效数字位数.

Parameters

sig

{Integer}

Returns

{Integer} 将数字四舍五入到指定数量的有效位数. 如果传入值为 null、0、或者是负数, 返回值 0

SuperMap.Function

函数操作的一系列常用扩展函数.

Summary

Functions
bind	绑定函数到对象.方便创建this的作用域.
bindAsEventListener	绑定函数到对象,在调用该函数时配置并使用事件对象作为第一个参数.
False	该函数仅仅返回false.
True	该函数仅仅返回true.
Void	可重用函数,仅仅返回”undefined”.

Functions

bind

bind: function( func,

object )

绑定函数到对象.方便创建this的作用域.

Parameters

func	{Function} 输入函数.
object	{Object} 对象绑定到输入函数(作为输入函数的this对象).

Returns

{Function} object参数作为func函数的this对象.

bindAsEventListener

bindAsEventListener: function( func,

object )

绑定函数到对象,在调用该函数时配置并使用事件对象作为第一个参数.

Parameters

func	{Function} 用于监听事件的函数.
object	{Object} this 对象的引用.

Returns

{Function}

False

False : function()

该函数仅仅返回false. 该函数主要是避免在IE8以下浏览中DOM事件句柄的匿名函数问题.

用法

document.onclick = SuperMap.Function.False;

Returns

{Boolean}

True

True : function()

该函数仅仅返回true. 该函数主要是避免在IE8以下浏览中DOM事件句柄的匿名函数问题.

用法

document.onclick = SuperMap.Function.True;

Returns

{Boolean}

Void

Void: function()

可重用函数,仅仅返回”undefined”.

Returns

{undefined}

SuperMap.Array

数组操作的一系列常用扩展函数.

Summary

Functions
filter	过滤数组.提供了ECMA-262标准中Array.prototype.filter函数的扩展.

Functions

filter

filter: function( array,

callback,

caller )

过滤数组.提供了ECMA-262标准中Array.prototype.filter函数的扩展.

基于众所周知的例子

http://developer.mozilla.org/en/Core_JavaScript_1.5_Reference/Global_Objects/Array/filter

Parameters

array	{Array} 要过滤的数组..
callback	{Function} 数组中的每一个元素调用该函数. 如果函数的返回值为true,该元素将包含在返回的数组中. 该函数有三个参数: 数组中的元素,元素的索引,数组自身. 如果设置了可选参数caller,在调用callback时,使用可选参数caller设置为callback的参数.
caller	{Object} 在调用callback时,使用可选参数caller设置为callback的参数.

Returns

{Array} callback函数返回true时的元素将作为返回数组中的元素.