类 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,直到尝试出第一个可以成功执行的函数就停止继续后边的函数,并返回这个个成功执行的函数结果
 
判断变量类型的方法 Determines the type of object
 
关于 Jx
 
bind(func, contextObj, args)
将一个函数绑定给一个对象作方法,返回的函数将总被传入{@code obj} as {@code this}
 
检查一个 Javascript 模块包是否已经存在
 
clone(o)
克隆一个对象
 
我就是传说中的debug哥!
 
一个空函数函数
 
 
extend(beExtendObj, extendObj1,, extendObj2)
对一个对象或数组进行扩展
 
getLength(obj)
获取对象自身具有的属性和方法的数量
<inner>  
instanceOf(o, type)
 
判断变量的类型是否是 Arguments Determines whether or not the provided object is a arguments
 
判断变量的类型是否是 Array Determines whether or not the provided object is a array
 
判断变量的类型是否是 Boolean Determines whether or not the provided object is a boolean
 
判断变量的类型是否是 Function Determines whether or not the provided object is a function
 
isNull(o)
判断变量的值是否是 null Determines whether or not the provided object is null
 
判断变量的类型是否是 Number Determines whether or not the provided object is a number
 
判断变量的类型是否是 Object Determines whether or not the provided object is a object
 
判断变量的类型是否是 String Determines whether or not the provided object is a string
 
判断变量的值是否是 undefined Determines whether or not the provided object is undefined
 
now()
获取当前时间的函数
 
out(msg, type)
标准化 Javascript 的核心输出方法,注意:在不同的Javascript嵌入宿主中会覆盖此方法!
 
pass(args, var_args)
给函数传入参数并执行
 
 
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 的版本号!
方法详解
{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()
功能: