编辑“KindEditor/Node API”

{{KindEditor导航}}

*'''K(expr , root)'''
创建或选取KNode对象，KNode是原生node的封装，KNode对象拥有以下属性和方法。

参数:
#string|node expr: [[DOM]]元素、选择器表达式、[[HTML]][[代码]]
#element root: DOM根元素，在root范围内选择DOM元素

返回: KNode

示例:
<pre>
node = K('<div>abc</div>');
node = K('#id div');
node = K(document.getElementById('id'));
firstNode = node[0];
</pre>

*'''length'''
node数量
<pre>
var length = K('#id div').length;
</pre>

*'''doc'''
第一个node的document对象。
<pre>
var doc = K('#id div').doc;
</pre>

*'''name'''
第一个node的nodeName。

*'''type'''
第一个node的nodeType。1: Element, 3: textNode

*'''bind(type , fn)'''
将指定函数绑定到所有KNode的指定事件上。

参数:
#string type: 事件类型
#function fn: 回调函数

返回: KNode

示例:
<pre>
K('#id div').bind('click', function() {
        alert(this.nodeName + ': clicked');
});
K('#id div').click(function() {
        alert(this.nodeName + ': clicked');
});
</pre>

*'''unbind([type , fn])'''
移除已绑定的事件函数。

参数:
#string type: 事件类型
#function fn: 回调函数

返回: KNode

示例:
<pre>
K('#id').unbind('click', functionName); //移除指定的事件函数
K('#id').unbind('click'); //移除所有click事件函数
K('#id').unbind(); //移除所有事件函数
</pre>

*'''fire(type)'''
执行绑定在第一个node上的事件函数。

参数:

string type: 事件类型

返回: KNode

示例:
<pre>
K('#id').fire('click');
K.click();
</pre>

*'''hasAttr(key)'''
判断第一个node是否拥有指定属性。

参数:

string key: 属性名

返回: boolean

示例:
<pre>
var bool = K('#id').hasAttr('border');
</pre>

*'''attr()'''
取得第一个node的所有属性.

参数: 无；
返回: object

示例:
<pre>
var attrList = K('#id').attr(); //return key-value data
</pre>

*'''attr(key)'''
取得第一个node的指定属性.

参数:

string key: 属性名

返回: string

示例:
<pre>
var border = K('#id').attr('border');
</pre>

*'''attr(key, val)'''
设置所有node的属性。

参数:
#string key: 属性名
#string val: 属性值

返回: KNode

示例:
<pre>
K('#id img').attr('border', 1);
</pre>

*'''attr(obj)'''
设置所有node的多个属性。

参数:

object obj: key-value数组

返回: KNode

示例:
<pre>
K('#id img').attr({
        'width' => '100px',
        'border' => 1
});
</pre>

*'''removeAttr(key)'''
移除所有node的指定属性.

参数:

string key: 属性名

返回: KNode

示例:
<pre>
K('#id img').removeAttr('border');
</pre>

*'''get([i])'''
取得原生node，当KNode的length为0时，返回null.

参数:

int i: offset，默认值为0

返回: node

示例:
<pre>
div1 = K('#id div').get(0);
div2 = K('#id div').get(1);
</pre>

*'''hasClass(cls)'''
判断第一个node是否拥有指定class。

参数:

string cls: className

返回: boolean

示例:
<pre>
var bool = K('#id').hasClass('class-name');
</pre>

*'''addClass(cls)'''
将指定className添加到所有node。

参数:

string cls: className

返回: KNode

示例:
<pre>
K('#id').addClass('class-name');
</pre>

*'''removeClass(cls)'''
移除所有node上的指定className。

参数:

string cls: className

返回: KNode

示例:
<pre>
K('#id').removeClass('class-name');
</pre>

*'''html()'''
取得第一个node的innerHTML。

参数: 无；
返回: string

示例:
<pre>
K('#id').html(val);
</pre>

*'''html(val)'''
设置所有node的innerHTML。

参数:

string val: HTML[[字符串]]

返回: KNode

示例:
<pre>
K('#id').html('<strong>abc</strong>');
</pre>

*'''hasVal()'''
判断第一个node是否拥有value属性。

参数: 无；
返回: boolean

示例:
<pre>
bool = K('#textarea').hasVal(); //return true
bool = K('#div').hasVal(); //return false
</pre>

*'''val()'''
取得第一个node的value。

参数: 无；返回: string

示例:
<pre>
var value = K('#textarea').val();
</pre>

*'''val(val)'''
设置所有node的value。

参数: 无；
返回: KNode

示例:
<pre>
K('#textarea').val('abc');
</pre>

*'''css()'''
取得第一个node的所有[[CSS]].

参数: 无；
返回: object

示例:
<pre>
var cssList = K('#id').css(); //return key-value data
</pre>

*'''css(key)'''
取得第一个node的指定CSS.

参数:

string key: CSS key

返回: string

示例:
<pre>
var padding = K('#id').css('padding');
</pre>

*'''css(key, val)'''
设置所有node的CSS。

参数:
#string key: CSS key
#string val: CSS value

返回: KNode

示例:
<pre>
K('#id div').css('border', '1px solid #000');
</pre>

*'''css(obj)'''
设置所有node的多个CSS。

参数:

object obj: key-value数组

返回: KNode

示例:
<pre>
K('#id div').css({
        'width' => '100px',
        'height' => '50px',
        'padding' => '10px'
});
</pre>

==参考来源==
*http://www.kindsoft.net/doc.php 


[[category:KindEditor|N]]
{{KindEditor使用手册导航}}