类 Jx
Defined in: jx.core.js.
Constructor Attributes | Constructor Name and Description |
---|---|
Jx(ver, isCreateNew)
【Jx 对象原型】
Jx
Jx 对象原型的描述
|
Field Attributes | Field Name and Description |
---|---|
<static> <constant> |
Jx 默认版本的版本号,默认将会是最后一个加载的Jx版本
|
<constant> |
当前 Jx 的版本号,此版本是 1.0
Version 1.0 当前 Jx 的版本号! |
Method Attributes | Method Name and Description |
---|---|
$namespace(name)
创建一个命名空间,创建的命名空间将会在 window 根命名空间下。
Create a new namespace, the top namespace is window.
|
|
$package(name, func)
创建一个 Javascript 代码包
|
|
$return(value)
生成一个返回值是传入的 value 值的函数
|
|
$try(fn1,)
从第一个函数开始try,直到尝试出第一个可以成功执行的函数就停止继续后边的函数,并返回这个个成功执行的函数结果
|
|
$typeof(o)
判断变量类型的方法
Determines the type of object
|
|
about()
关于 Jx
|
|
bind(func, contextObj, args)
将一个函数绑定给一个对象作方法,返回的函数将总被传入{@code obj} as {@code this}
|
|
checkPackage(name)
检查一个 Javascript 模块包是否已经存在
|
|
clone(o)
克隆一个对象
|
|
debug()
我就是传说中的debug哥!
|
|
一个空函数函数
|
|
error()
|
|
extend(beExtendObj, extendObj1,, extendObj2)
对一个对象或数组进行扩展
|
|
getLength(obj)
获取对象自身具有的属性和方法的数量
|
|
<inner> |
instanceOf(o, type)
|
isArguments(o)
判断变量的类型是否是 Arguments
Determines whether or not the provided object is a arguments
|
|
isArray(o)
判断变量的类型是否是 Array
Determines whether or not the provided object is a array
|
|
isBoolean(o)
判断变量的类型是否是 Boolean
Determines whether or not the provided object is a boolean
|
|
isFunction(o)
判断变量的类型是否是 Function
Determines whether or not the provided object is a function
|
|
isNull(o)
判断变量的值是否是 null
Determines whether or not the provided object is null
|
|
isNumber(o)
判断变量的类型是否是 Number
Determines whether or not the provided object is a number
|
|
isObject(o)
判断变量的类型是否是 Object
Determines whether or not the provided object is a object
|
|
isString(o)
判断变量的类型是否是 String
Determines whether or not the provided object is a string
|
|
isUndefined(o)
判断变量的值是否是 undefined
Determines whether or not the provided object is undefined
|
|
now()
获取当前时间的函数
|
|
out(msg, type)
标准化 Javascript 的核心输出方法,注意:在不同的Javascript嵌入宿主中会覆盖此方法!
|
|
pass(args, var_args)
给函数传入参数并执行
|
|
profile()
|
|
random(min, max)
生成随机数的方法
|
|
timedChunk(items, process, context, isShift, callback)
通用分时处理函数
|
|
warn()
|
类 详解
Jx(ver, isCreateNew)
- 功能:
- 【Jx 对象原型】 Jx Jx 对象原型的描述
//代码组织方式一(传统): var J = new Jx(); J.out(J.version); //输出当前Jx的版本
//代码组织方式二(推荐): Jx().$package(function(J){ J.out(J.version); //输出当前Jx的版本 }; //注:此种方式可以利用匿名函数来防止变量污染全局命名空间,尤其适合大型WebApp的构建!
//范例: Jx().$package("tencent.alloy", function(J){ var $ = J.dom.id, $D = J.dom, $E = J.event, $H = J.http; this.name = "腾讯Q+ Web"; J.out(this.name); };
- 参数:
-
- {Number} ver
- 要使用的 Jx 的版本号,当前是1.0
- {Boolean} isCreateNew
- 是否创建一个新的 Jx 实例,默认为 false 不创建新的 Jx 实例,只返回同一版本在全局中的唯一一个实例,注意:除非特殊需要,否则一般不要创建新的 Jx 实例
- Since:
- version 1.0
- 返回:
- {Object} 返回对应版本的 Jx 对象
属性详解
<static> <constant>
{Number}
Jx.DEFAULT_VERSION
Jx 默认版本的版本号,默认将会是最后一个加载的Jx版本
<constant>
{Number}
version
当前 Jx 的版本号,此版本是 1.0
Version 1.0 当前 Jx 的版本号!
Version 1.0 当前 Jx 的版本号!
方法详解
{Object}
$namespace(name)
- 功能:
- 创建一个命名空间,创建的命名空间将会在 window 根命名空间下。 Create a new namespace, the top namespace is window. 可以一次性连续创建命名空间
//在全局环境中创建tencent.alloy名字空间, $namespace完成的操作相当于在全局环境中执行如下语句: //var tencent = {}; //tencent.alloy = {}; J.$namespace("tencent.alloy"); //注:Jx的$namespace方法与其他JS框架的namespace的方法不同,其他框架如YUI是在其YAHOO对像下创 //建命名空间,而Jx的$namespace测试直接在顶级命名空间window的下边直接创建命名空间。
- 参数:
-
- {String} name
- 命名空间名称
- Since:
- version 1.0
- 返回:
- {Object} 返回对最末命名空间的引用
{Mixed}
$package(name, func)
- 功能:
- 创建一个 Javascript 代码包
//创建一个匿名package包: Jx().$package(function(J){ //这时上下文对象this指向全局window对象 alert("Hello world! This is " + this); };
//创建一个名字为tencent.kinvix的package包: Jx().$package("tencent.kinvix", function(J){ //这时上下文对象this指向window对象下的tencent.kinvix对象 alert("Hello world! This is " + this); };
- 参数:
-
- {String} name
- 要创建的包的名字空间
- {Function} func
- 要创建的包的包体
- 返回:
- {Mixed} 返回任何自定义的变量
{Mixed}
$return(value)
- 功能:
-
生成一个返回值是传入的 value 值的函数
Defined in: jx.base.js.
- 参数:
-
- {Mixed} value
- 要返回的值
- 返回:
- {Mixed} 返回一个返回值是 value 的函数
{Mixed}
$try(fn1,)
- 功能:
-
从第一个函数开始try,直到尝试出第一个可以成功执行的函数就停止继续后边的函数,并返回这个个成功执行的函数结果
Defined in: jx.base.js.
Jx().$package(function(J){ // 按顺序执行 funcA, funcB, funcC,当中途有一个 func 的执行结果返回 true 则不再往下执行,并返回成功执行的 func 的返回值; J.$try(funcA, funcB, funcC); };
- 参数:
-
- {Function} fn1,
- fn2, .... 要尝试的函数
- 返回:
- {Mixed} 返回第一个成功执行的函数的返回值
{String}
$typeof(o)
- 功能:
-
判断变量类型的方法
Determines the type of object
Defined in: jx.base.js.
- 参数:
-
- {Mixed} o
- 传入被检测变量的名称
- 返回:
- {String} 返回变量的类型,如果不识别则返回 other
{String}
about()
- 功能:
- 关于 Jx
- 返回:
- {String} 返回 Jx 的 about 信息
{Function}
bind(func, contextObj, args)
- 功能:
-
将一个函数绑定给一个对象作方法,返回的函数将总被传入{@code obj} as {@code this}
Defined in: jx.base.js.
Jx().$package(function(J){ funcB = J.bind(funcA, obj, a, b) funcB(c, d) // 相当于执行 funcA.call(obj, a, b, c, d) };
- 参数:
-
- {Function} func
- 要绑定的函数
- {Object} contextObj
- 要绑定的对象
- {Mixed} args
- 参数列表,长度任意
- 返回:
- {Function} 返回一个被绑定this上下文对象的函数
{Object}
checkPackage(name)
- 功能:
- 检查一个 Javascript 模块包是否已经存在
//创建一个匿名package包: Jx().$package(function(J){ // 输出undefined J.out(J.checkPackage("tencent.kinvix")); };
//创建一个名字为tencent.kinvix的package包: Jx().$package("tencent.kinvix", function(J){ //这时上下文对象this指向window下的tencent.kinvix对象 alert("Hello world! This is " + this); }; Jx().$package(function(J){ // J.checkPackage("tencent.kinvix")结果返回的将是tencent.kinvix的引用 var kinvix = J.checkPackage("tencent.kinvix"); if(kinvix){ J.out("tencent.kinvix包已加载..."); } };
- 参数:
-
- {String} name
- 包名
- 返回:
- {Object} 如果已加载则返回包对象,否则返回 undefined
{Object}
clone(o)
- 功能:
-
克隆一个对象
Defined in: jx.base.js.
Jx().$package(function(J){ var objA = {name: "Kinvix"}; // 克隆一个 objA 对象,并存入 objB 中。 var objB = J.clone(objA); };
- 参数:
-
- {Object} o
- 要克隆的对象
- 返回:
- {Object} 返回通过克隆创建的对象
debug()
- 功能:
- 我就是传说中的debug哥!
- 参看:
- 想知道我到底是谁吗?请参考J.console.debug
emptyFunc()
- 功能:
-
一个空函数函数
Defined in: jx.base.js.
error()
- 功能:
{Mixed}
extend(beExtendObj, extendObj1,, extendObj2)
- 功能:
-
对一个对象或数组进行扩展
Defined in: jx.base.js.
Jx().$package(function(J){ // 用 objB 和objC 扩展 objA 对象; J.extend(objA, objB, objC); };
- 参数:
-
- {Mixed} beExtendObj
- 被扩展的对象或数组
- {Mixed} extendObj1,
- extendObj2, .... 用来参照扩展的对象或数组
- extendObj2
- 返回:
- {Mixed} 返回被扩展后的对象或数组
{Number}
getLength(obj)
- 功能:
-
获取对象自身具有的属性和方法的数量
Defined in: jx.base.js.
- 参数:
-
- {Object} obj
- 要获取的对象
- 返回:
- {Number} 返回对象自身具有属性和方法的数量
<inner>
instanceOf(o, type)
- 功能:
- 参数:
-
- o
- type
{Boolean}
isArguments(o)
- 功能:
-
判断变量的类型是否是 Arguments
Determines whether or not the provided object is a arguments
Defined in: jx.base.js.
- 参数:
-
- {Mixed} o
- 传入被检测变量的名称
- 返回:
- {Boolean} 当 o 的类型是 arguments 时返回 true
{Boolean}
isArray(o)
- 功能:
-
判断变量的类型是否是 Array
Determines whether or not the provided object is a array
Defined in: jx.base.js.
- 参数:
-
- {Mixed} o
- 传入被检测变量的名称
- 返回:
- {Boolean} 当 o 的类型是 array 时返回 true
{Boolean}
isBoolean(o)
- 功能:
-
判断变量的类型是否是 Boolean
Determines whether or not the provided object is a boolean
Defined in: jx.base.js.
- 参数:
-
- {Mixed} o
- 传入被检测变量的名称
- 返回:
- {Boolean} 当 o 的类型是 boolean 时返回 true
{Boolean}
isFunction(o)
- 功能:
-
判断变量的类型是否是 Function
Determines whether or not the provided object is a function
Defined in: jx.base.js.
- 参数:
-
- {Mixed} o
- 传入被检测变量的名称
- 返回:
- {Boolean} 当 o 的类型是 function 时返回 true
{Boolean}
isNull(o)
- 功能:
-
判断变量的值是否是 null
Determines whether or not the provided object is null
Defined in: jx.base.js.
- 参数:
-
- {Mixed} o
- 传入被检测变量的名称
- 返回:
- {Boolean} 当 o 的值是 null 时返回 true
{Boolean}
isNumber(o)
- 功能:
-
判断变量的类型是否是 Number
Determines whether or not the provided object is a number
Defined in: jx.base.js.
- 参数:
-
- {Mixed} o
- 传入被检测变量的名称
- 返回:
- {Boolean} 当 o 的类型是 number 时返回 true
{Boolean}
isObject(o)
- 功能:
-
判断变量的类型是否是 Object
Determines whether or not the provided object is a object
Defined in: jx.base.js.
- 参数:
-
- {Mixed} o
- 传入被检测变量的名称
- 返回:
- {Boolean} 当 o 的类型是 object 时返回 true
{Boolean}
isString(o)
- 功能:
-
判断变量的类型是否是 String
Determines whether or not the provided object is a string
Defined in: jx.base.js.
- 参数:
-
- {Mixed} o
- 传入被检测变量的名称
- 返回:
- {Boolean} 当 o 的类型是 string 时返回 true
{Boolean}
isUndefined(o)
- 功能:
-
判断变量的值是否是 undefined
Determines whether or not the provided object is undefined
Defined in: jx.base.js.
- 参数:
-
- {Mixed} o
- 传入被检测变量的名称
- 返回:
- {Boolean} 当 o 的值是 undefined 时返回 true
now()
- 功能:
-
获取当前时间的函数
Defined in: jx.base.js.
alert(J.now());
{String}
out(msg, type)
- 功能:
- 标准化 Javascript 的核心输出方法,注意:在不同的Javascript嵌入宿主中会覆盖此方法!
//创建一个匿名package包: Jx().$package(function(J){ // 向Jx的控制台输出信息,在不同的js宿主中具体实现细节会不同,但不会影响out方法的使用; J.out("Hello, world!"); };
- 参数:
-
- {String} msg
- 要输出的信息
- {Number} type
- 输出信息的类型
- 返回:
- {String} msg 返回要输出的信息
{Mixed}
pass(args, var_args)
- 功能:
-
给函数传入参数并执行
Defined in: jx.base.js.
Jx().$package(function(J){ // 将"a"、"b"两个字符串传入funcA函数并执行 funcA.pass("a","b"); };
- 参数:
-
- {Mixed} args
- 参数列表
- var_args
- 返回:
- {Mixed} 返回函数执行结果
profile()
- 功能:
{Number}
random(min, max)
- 功能:
-
生成随机数的方法
Defined in: jx.base.js.
- 参数:
-
- {Number} min
- 生成随机数的最小值
- {Number} max
- 生成随机数的最大值
- 返回:
- {Number} 返回生成的随机数
timedChunk(items, process, context, isShift, callback)
- 功能:
-
通用分时处理函数
Defined in: jx.base.js.
Jx().$package(function(J){ };
- 参数:
-
- items
- process
- context
- isShift
- callback
warn()
- 功能: