DOM 包装类。
列表节点。
当前包含的节点数。
返回包含当前节点及匹配到的新节点的 DOMWrap 对象(节点顺序与其在文档树中的顺序一致)。
选择器。
Optional
context: Document | HTMLElement上下文。
Optional
包含上述节点的 DOMWrap 对象。
// <p id="p1"></p>
// <div><p id="p2"></p></div>
$('div').add('p'); // [p#p1, div, p#p2]
返回包含当前节点及指定节点的 DOMWrap 对象(节点顺序与其在文档树中的顺序一致)。
指定节点。
包含上述节点的 DOMWrap 对象。
// <div><p id="p2"></p></div>
$('div').add(document.querySelector('#p2')); // [div, p#p2]
为当前所有节点添加样式类。
样式类名。多个样式类名可用空格隔开,也可以传入数组。
当前对象。
// <div></div>
$('div').addClass('visible'); // <div class="visible"></div>
// <div></div>
$('div').addClass('visible bg'); // <div class="visible bg"></div>
// <div></div>
$('div').addClass(['visible', 'bg']); // <div class="visible bg"></div>
获取当前第一个节点的属性值。
属性名。
属性值。
// <input readonly="readonly" />
$('input').attr('readonly'); // "readonly"
设置当前所有节点的属性值。
属性名。
属性值。
当前对象。
$('input').attr('readonly', 'readonly');
设置当前所有节点的属性值。
属性键值对。
当前对象。
$('input').attr({
readonly: 'readonly'
});
查找当前所有节点的子元素。
Optional
selector: string选择器。不为空时仅返回符合选择器规则的元素。
Optional
包含查找结果的 DOMWrap 对象。
// <ul id="list">
// <li></li>
// <li class="item"></li>
// <li class="item"></li>
// </ul>
$('#list').children(); // [li, li.item, li.item]
$('#list').children('.item'); // [li.item, li.item]
克隆当前所有节点。
// <div id="container"></div>
const $container = $('#container').data('testData', 1);
$container.clone().data('testData'); // undefined
$container.clone(true).data('testData'); // 1
Optional
withData: boolean是否克隆节点数据。
Optional
Optional
deepWithData: boolean是否克隆后代节点数据。
Optional
包含所有节点副本的 DOMWrap 对象。
获取当前第一个节点的样式属性值。
样式属性名。
样式属性值。
$('div').css('color');
设置当前所有节点的样式属性值。
样式属性名。
样式属性值。
当前对象。
$('div').css('color', 'red');
设置当前所有节点的样式属性值。
样式属性键值对。
当前对象。
$('div').css({
color: 'red',
'font-size': '16px'
});
获取当前第一个节点的自定义数据项值。
数据项键。
数据项值。
$('body').data('testData');
设置当前所有节点的自定义数据项值。
数据项键。
数据项值。
当前对象。
$('body').data('testData', 'my test data');
设置当前所有节点的自定义数据项值。
数据项键值对。
当前对象。
$('body').data({
testData: 'my test data'
});
遍历当前所有节点。
对每个节点执行的操作函数,返回值为 false 时中断遍历。
Optional
index: numberOptional
Optional
member: DOMWrapMemberOptional
当前对象。
$('div').each(function(i: number, member: DOMWrapMember) {
console.log(i);
return i < 10; // 仅遍历前 10 项
});
即数组的 every。
功能与数组的 filter 基本一致,但返回值是 DOMWrap 对象。
即数组的 forEach。
获取指定索引的节点。
索引。
指定索引的节点。
即数组的 indexOf。
指定节点。
序号索引。
查找当前所有节点之后的同级元素,直到遇到符合指定规则的元素为止。
Optional
until: TraversalUntil截止元素或选择器规则。
Optional
Optional
filter: string选择器。不为空时仅返回符合选择器规则的元素。
Optional
包含查找结果的 DOMWrap 对象。
给当前所有节点的指定事件注销监听函数。 不指定监听函数和代理元素选择器时,注销指定事件类型的所有监听函数; 不指定事件类型时注销所有事件的监听函数。
Optional
types: string | string[]事件类型。多个事件类型用空格隔开,或者以数组传入。
Optional
Optional
selector: string | IEventHandler代理元素选择器。不传或为空时不限制代理元素,为函数时表示监听函数。
Optional
Optional
handler: IEventHandler监听函数。不传或为空时注销指定事件的所有监听函数。
Optional
当前对象。
$('body').off('click', handler); // 移除 click 事件的 handler 监听函数
$('body').off('click'); // 移除 click 事件的所有监听函数
$('body').off(); // 移除所有事件的所有监听函数
给当前所有节点的指定事件注册监听函数。
事件类型。多个事件类型用空格隔开,或者以数组传入。
Optional
selector: string | IEventHandler代理元素选择器。为空时不代理元素,为函数时表示监听函数。
Optional
Optional
handler: IEventHandler监听函数。
Optional
当前对象。
$('body').on('click', 'div', function() {
console.log('click on div');
});
$('body').on('click', function(e) {
if (e.target === e.currentTarget) {
console.log('click on body');
}
});
查找当前所有节点的祖先元素,直到遇到符合指定规则的元素为止。
Optional
until: TraversalUntil截止元素或选择器规则。
Optional
Optional
filter: string选择器。不为空时仅返回符合选择器规则的元素。
Optional
包含查找结果的 DOMWrap 对象。
查找当前所有节点之前的同级元素,直到遇到符合指定规则的元素为止。
Optional
until: TraversalUntil截止元素或选择器规则。
Optional
Optional
filter: string选择器。不为空时仅返回符合选择器规则的元素。
Optional
包含查找结果的 DOMWrap 对象。
获取当前第一个节点的特性值。
特性名。
特性值。
// <input readonly="readonly" />
$('input').prop('readOnly'); // true
设置当前所有节点的特性值。
特性名。
特性值。
当前对象。
$('input').prop('readOnly', true);
设置当前所有节点的特性值。
特性键值对。
当前对象。
$('input').prop({
readOnly: true
});
为当前所有节点移除样式类。
Optional
classNames: string | string[]样式类名。多个样式类名可用空格隔开,也可以传入数组。不传时移除所有样式类。
Optional
当前对象。
// <div class="visible bg"></div>
$('div').removeClass('bg'); // <div class="visible"></div>
// <div class="visible bg"></div>
$('div').removeClass('visible bg'); // <div></div>
// <div class="visible bg"></div>
$('div').removeClass(['visible', 'bg']); // <div></div>
// <div class="visible bg"></div>
$('div').removeClass(); // <div></div>
获取当前第一个节点的 scrollLeft。
当前第一个节点的 scrollLeft。
设置当前所有节点的 scrollLeft。
scrollLeft 值。
当前对象。
获取当前第一个节点的 scrollTop。
当前第一个节点的 scrollTop。
设置当前所有节点的 scrollTop。
scrollTop 值。
当前对象。
查找当前所有节点的同级元素。
Optional
selector: string选择器。不为空时仅返回符合选择器规则的元素。
Optional
包含查找结果的 DOMWrap 对象。
// <ul>
// <li id="first-item"></li>
// <li></li>
// <li class="last-item"></li>
// </ul>
$('#first-item').siblings(); // [li, li.last-item]
$('#first-item').siblings('.last-item'); // [li.last-item]
即数组的 some。
返回包含当前所有节点的数组。
包含当前所有节点的数组。
对当前每个节点,如果包含指定样式类,则移除;否则添加。
样式类名。多个样式类名可用空格隔开,也可以传入数组。
当前对象。
// <div class="visible bg"></div>
// <div></div>
$('div').toggleClass('visible');
// <div class="bg"></div>
// <div class="visible"></div>
// <div class="visible bg"></div>
// <div></div>
$('div').toggleClass('visible bg');
// <div></div>
// <div class="visible bg"></div>
// <div class="visible"></div>
// <div class="bg"></div>
$('div').toggleClass(['visible', 'bg']);
// <div class="bg"></div>
// <div class="visible"></div>
Generated using TypeDoc
DOM 包装类。