You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
861 lines
26 KiB
861 lines
26 KiB
2 years ago
|
"use strict";
|
||
|
|
/**
|
||
|
|
* Methods for modifying the DOM structure.
|
||
|
|
*
|
||
|
|
* @module cheerio/manipulation
|
||
|
|
*/
|
||
|
|
var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
|
||
|
|
if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {
|
||
|
|
if (ar || !(i in from)) {
|
||
|
|
if (!ar) ar = Array.prototype.slice.call(from, 0, i);
|
||
|
|
ar[i] = from[i];
|
||
|
|
}
|
||
|
|
}
|
||
|
|
return to.concat(ar || Array.prototype.slice.call(from));
|
||
|
|
};
|
||
|
|
Object.defineProperty(exports, "__esModule", { value: true });
|
||
|
|
exports.clone = exports.text = exports.toString = exports.html = exports.empty = exports.replaceWith = exports.remove = exports.insertBefore = exports.before = exports.insertAfter = exports.after = exports.wrapAll = exports.unwrap = exports.wrapInner = exports.wrap = exports.prepend = exports.append = exports.prependTo = exports.appendTo = exports._makeDomArray = void 0;
|
||
|
|
var domhandler_1 = require("domhandler");
|
||
|
|
var parse_js_1 = require("../parse.js");
|
||
|
|
var static_js_1 = require("../static.js");
|
||
|
|
var utils_js_1 = require("../utils.js");
|
||
|
|
var domutils_1 = require("domutils");
|
||
|
|
/**
|
||
|
|
* Create an array of nodes, recursing into arrays and parsing strings if necessary.
|
||
|
|
*
|
||
|
|
* @private
|
||
|
|
* @category Manipulation
|
||
|
|
* @param elem - Elements to make an array of.
|
||
|
|
* @param clone - Optionally clone nodes.
|
||
|
|
* @returns The array of nodes.
|
||
|
|
*/
|
||
|
|
function _makeDomArray(elem, clone) {
|
||
|
|
var _this = this;
|
||
|
|
if (elem == null) {
|
||
|
|
return [];
|
||
|
|
}
|
||
|
|
if ((0, utils_js_1.isCheerio)(elem)) {
|
||
|
|
return clone ? (0, utils_js_1.cloneDom)(elem.get()) : elem.get();
|
||
|
|
}
|
||
|
|
if (Array.isArray(elem)) {
|
||
|
|
return elem.reduce(function (newElems, el) { return newElems.concat(_this._makeDomArray(el, clone)); }, []);
|
||
|
|
}
|
||
|
|
if (typeof elem === 'string') {
|
||
|
|
return this._parse(elem, this.options, false, null).children;
|
||
|
|
}
|
||
|
|
return clone ? (0, utils_js_1.cloneDom)([elem]) : [elem];
|
||
|
|
}
|
||
|
|
exports._makeDomArray = _makeDomArray;
|
||
|
|
function _insert(concatenator) {
|
||
|
|
return function () {
|
||
|
|
var _this = this;
|
||
|
|
var elems = [];
|
||
|
|
for (var _i = 0; _i < arguments.length; _i++) {
|
||
|
|
elems[_i] = arguments[_i];
|
||
|
|
}
|
||
|
|
var lastIdx = this.length - 1;
|
||
|
|
return (0, utils_js_1.domEach)(this, function (el, i) {
|
||
|
|
if (!(0, domhandler_1.hasChildren)(el))
|
||
|
|
return;
|
||
|
|
var domSrc = typeof elems[0] === 'function'
|
||
|
|
? elems[0].call(el, i, _this._render(el.children))
|
||
|
|
: elems;
|
||
|
|
var dom = _this._makeDomArray(domSrc, i < lastIdx);
|
||
|
|
concatenator(dom, el.children, el);
|
||
|
|
});
|
||
|
|
};
|
||
|
|
}
|
||
|
|
/**
|
||
|
|
* Modify an array in-place, removing some number of elements and adding new
|
||
|
|
* elements directly following them.
|
||
|
|
*
|
||
|
|
* @private
|
||
|
|
* @category Manipulation
|
||
|
|
* @param array - Target array to splice.
|
||
|
|
* @param spliceIdx - Index at which to begin changing the array.
|
||
|
|
* @param spliceCount - Number of elements to remove from the array.
|
||
|
|
* @param newElems - Elements to insert into the array.
|
||
|
|
* @param parent - The parent of the node.
|
||
|
|
* @returns The spliced array.
|
||
|
|
*/
|
||
|
|
function uniqueSplice(array, spliceIdx, spliceCount, newElems, parent) {
|
||
|
|
var _a, _b;
|
||
|
|
var spliceArgs = __spreadArray([
|
||
|
|
spliceIdx,
|
||
|
|
spliceCount
|
||
|
|
], newElems, true);
|
||
|
|
var prev = spliceIdx === 0 ? null : array[spliceIdx - 1];
|
||
|
|
var next = spliceIdx + spliceCount >= array.length
|
||
|
|
? null
|
||
|
|
: array[spliceIdx + spliceCount];
|
||
|
|
/*
|
||
|
|
* Before splicing in new elements, ensure they do not already appear in the
|
||
|
|
* current array.
|
||
|
|
*/
|
||
|
|
for (var idx = 0; idx < newElems.length; ++idx) {
|
||
|
|
var node = newElems[idx];
|
||
|
|
var oldParent = node.parent;
|
||
|
|
if (oldParent) {
|
||
|
|
var oldSiblings = oldParent.children;
|
||
|
|
var prevIdx = oldSiblings.indexOf(node);
|
||
|
|
if (prevIdx > -1) {
|
||
|
|
oldParent.children.splice(prevIdx, 1);
|
||
|
|
if (parent === oldParent && spliceIdx > prevIdx) {
|
||
|
|
spliceArgs[0]--;
|
||
|
|
}
|
||
|
|
}
|
||
|
|
}
|
||
|
|
node.parent = parent;
|
||
|
|
if (node.prev) {
|
||
|
|
node.prev.next = (_a = node.next) !== null && _a !== void 0 ? _a : null;
|
||
|
|
}
|
||
|
|
if (node.next) {
|
||
|
|
node.next.prev = (_b = node.prev) !== null && _b !== void 0 ? _b : null;
|
||
|
|
}
|
||
|
|
node.prev = idx === 0 ? prev : newElems[idx - 1];
|
||
|
|
node.next = idx === newElems.length - 1 ? next : newElems[idx + 1];
|
||
|
|
}
|
||
|
|
if (prev) {
|
||
|
|
prev.next = newElems[0];
|
||
|
|
}
|
||
|
|
if (next) {
|
||
|
|
next.prev = newElems[newElems.length - 1];
|
||
|
|
}
|
||
|
|
return array.splice.apply(array, spliceArgs);
|
||
|
|
}
|
||
|
|
/**
|
||
|
|
* Insert every element in the set of matched elements to the end of the target.
|
||
|
|
*
|
||
|
|
* @category Manipulation
|
||
|
|
* @example
|
||
|
|
*
|
||
|
|
* ```js
|
||
|
|
* $('<li class="plum">Plum</li>').appendTo('#fruits');
|
||
|
|
* $.html();
|
||
|
|
* //=> <ul id="fruits">
|
||
|
|
* // <li class="apple">Apple</li>
|
||
|
|
* // <li class="orange">Orange</li>
|
||
|
|
* // <li class="pear">Pear</li>
|
||
|
|
* // <li class="plum">Plum</li>
|
||
|
|
* // </ul>
|
||
|
|
* ```
|
||
|
|
*
|
||
|
|
* @param target - Element to append elements to.
|
||
|
|
* @returns The instance itself.
|
||
|
|
* @see {@link https://api.jquery.com/appendTo/}
|
||
|
|
*/
|
||
|
|
function appendTo(target) {
|
||
|
|
var appendTarget = (0, utils_js_1.isCheerio)(target) ? target : this._make(target);
|
||
|
|
appendTarget.append(this);
|
||
|
|
return this;
|
||
|
|
}
|
||
|
|
exports.appendTo = appendTo;
|
||
|
|
/**
|
||
|
|
* Insert every element in the set of matched elements to the beginning of the target.
|
||
|
|
*
|
||
|
|
* @category Manipulation
|
||
|
|
* @example
|
||
|
|
*
|
||
|
|
* ```js
|
||
|
|
* $('<li class="plum">Plum</li>').prependTo('#fruits');
|
||
|
|
* $.html();
|
||
|
|
* //=> <ul id="fruits">
|
||
|
|
* // <li class="plum">Plum</li>
|
||
|
|
* // <li class="apple">Apple</li>
|
||
|
|
* // <li class="orange">Orange</li>
|
||
|
|
* // <li class="pear">Pear</li>
|
||
|
|
* // </ul>
|
||
|
|
* ```
|
||
|
|
*
|
||
|
|
* @param target - Element to prepend elements to.
|
||
|
|
* @returns The instance itself.
|
||
|
|
* @see {@link https://api.jquery.com/prependTo/}
|
||
|
|
*/
|
||
|
|
function prependTo(target) {
|
||
|
|
var prependTarget = (0, utils_js_1.isCheerio)(target) ? target : this._make(target);
|
||
|
|
prependTarget.prepend(this);
|
||
|
|
return this;
|
||
|
|
}
|
||
|
|
exports.prependTo = prependTo;
|
||
|
|
/**
|
||
|
|
* Inserts content as the _last_ child of each of the selected elements.
|
||
|
|
*
|
||
|
|
* @category Manipulation
|
||
|
|
* @example
|
||
|
|
*
|
||
|
|
* ```js
|
||
|
|
* $('ul').append('<li class="plum">Plum</li>');
|
||
|
|
* $.html();
|
||
|
|
* //=> <ul id="fruits">
|
||
|
|
* // <li class="apple">Apple</li>
|
||
|
|
* // <li class="orange">Orange</li>
|
||
|
|
* // <li class="pear">Pear</li>
|
||
|
|
* // <li class="plum">Plum</li>
|
||
|
|
* // </ul>
|
||
|
|
* ```
|
||
|
|
*
|
||
|
|
* @see {@link https://api.jquery.com/append/}
|
||
|
|
*/
|
||
|
|
exports.append = _insert(function (dom, children, parent) {
|
||
|
|
uniqueSplice(children, children.length, 0, dom, parent);
|
||
|
|
});
|
||
|
|
/**
|
||
|
|
* Inserts content as the _first_ child of each of the selected elements.
|
||
|
|
*
|
||
|
|
* @category Manipulation
|
||
|
|
* @example
|
||
|
|
*
|
||
|
|
* ```js
|
||
|
|
* $('ul').prepend('<li class="plum">Plum</li>');
|
||
|
|
* $.html();
|
||
|
|
* //=> <ul id="fruits">
|
||
|
|
* // <li class="plum">Plum</li>
|
||
|
|
* // <li class="apple">Apple</li>
|
||
|
|
* // <li class="orange">Orange</li>
|
||
|
|
* // <li class="pear">Pear</li>
|
||
|
|
* // </ul>
|
||
|
|
* ```
|
||
|
|
*
|
||
|
|
* @see {@link https://api.jquery.com/prepend/}
|
||
|
|
*/
|
||
|
|
exports.prepend = _insert(function (dom, children, parent) {
|
||
|
|
uniqueSplice(children, 0, 0, dom, parent);
|
||
|
|
});
|
||
|
|
function _wrap(insert) {
|
||
|
|
return function (wrapper) {
|
||
|
|
var lastIdx = this.length - 1;
|
||
|
|
var lastParent = this.parents().last();
|
||
|
|
for (var i = 0; i < this.length; i++) {
|
||
|
|
var el = this[i];
|
||
|
|
var wrap_1 = typeof wrapper === 'function'
|
||
|
|
? wrapper.call(el, i, el)
|
||
|
|
: typeof wrapper === 'string' && !(0, utils_js_1.isHtml)(wrapper)
|
||
|
|
? lastParent.find(wrapper).clone()
|
||
|
|
: wrapper;
|
||
|
|
var wrapperDom = this._makeDomArray(wrap_1, i < lastIdx)[0];
|
||
|
|
if (!wrapperDom || !(0, domhandler_1.hasChildren)(wrapperDom))
|
||
|
|
continue;
|
||
|
|
var elInsertLocation = wrapperDom;
|
||
|
|
/*
|
||
|
|
* Find the deepest child. Only consider the first tag child of each node
|
||
|
|
* (ignore text); stop if no children are found.
|
||
|
|
*/
|
||
|
|
var j = 0;
|
||
|
|
while (j < elInsertLocation.children.length) {
|
||
|
|
var child = elInsertLocation.children[j];
|
||
|
|
if ((0, utils_js_1.isTag)(child)) {
|
||
|
|
elInsertLocation = child;
|
||
|
|
j = 0;
|
||
|
|
}
|
||
|
|
else {
|
||
|
|
j++;
|
||
|
|
}
|
||
|
|
}
|
||
|
|
insert(el, elInsertLocation, [wrapperDom]);
|
||
|
|
}
|
||
|
|
return this;
|
||
|
|
};
|
||
|
|
}
|
||
|
|
/**
|
||
|
|
* The .wrap() function can take any string or object that could be passed to
|
||
|
|
* the $() factory function to specify a DOM structure. This structure may be
|
||
|
|
* nested several levels deep, but should contain only one inmost element. A
|
||
|
|
* copy of this structure will be wrapped around each of the elements in the set
|
||
|
|
* of matched elements. This method returns the original set of elements for
|
||
|
|
* chaining purposes.
|
||
|
|
*
|
||
|
|
* @category Manipulation
|
||
|
|
* @example
|
||
|
|
*
|
||
|
|
* ```js
|
||
|
|
* const redFruit = $('<div class="red-fruit"></div>');
|
||
|
|
* $('.apple').wrap(redFruit);
|
||
|
|
*
|
||
|
|
* //=> <ul id="fruits">
|
||
|
|
* // <div class="red-fruit">
|
||
|
|
* // <li class="apple">Apple</li>
|
||
|
|
* // </div>
|
||
|
|
* // <li class="orange">Orange</li>
|
||
|
|
* // <li class="plum">Plum</li>
|
||
|
|
* // </ul>
|
||
|
|
*
|
||
|
|
* const healthy = $('<div class="healthy"></div>');
|
||
|
|
* $('li').wrap(healthy);
|
||
|
|
*
|
||
|
|
* //=> <ul id="fruits">
|
||
|
|
* // <div class="healthy">
|
||
|
|
* // <li class="apple">Apple</li>
|
||
|
|
* // </div>
|
||
|
|
* // <div class="healthy">
|
||
|
|
* // <li class="orange">Orange</li>
|
||
|
|
* // </div>
|
||
|
|
* // <div class="healthy">
|
||
|
|
* // <li class="plum">Plum</li>
|
||
|
|
* // </div>
|
||
|
|
* // </ul>
|
||
|
|
* ```
|
||
|
|
*
|
||
|
|
* @param wrapper - The DOM structure to wrap around each element in the selection.
|
||
|
|
* @see {@link https://api.jquery.com/wrap/}
|
||
|
|
*/
|
||
|
|
exports.wrap = _wrap(function (el, elInsertLocation, wrapperDom) {
|
||
|
|
var parent = el.parent;
|
||
|
|
if (!parent)
|
||
|
|
return;
|
||
|
|
var siblings = parent.children;
|
||
|
|
var index = siblings.indexOf(el);
|
||
|
|
(0, parse_js_1.update)([el], elInsertLocation);
|
||
|
|
/*
|
||
|
|
* The previous operation removed the current element from the `siblings`
|
||
|
|
* array, so the `dom` array can be inserted without removing any
|
||
|
|
* additional elements.
|
||
|
|
*/
|
||
|
|
uniqueSplice(siblings, index, 0, wrapperDom, parent);
|
||
|
|
});
|
||
|
|
/**
|
||
|
|
* The .wrapInner() function can take any string or object that could be passed
|
||
|
|
* to the $() factory function to specify a DOM structure. This structure may be
|
||
|
|
* nested several levels deep, but should contain only one inmost element. The
|
||
|
|
* structure will be wrapped around the content of each of the elements in the
|
||
|
|
* set of matched elements.
|
||
|
|
*
|
||
|
|
* @category Manipulation
|
||
|
|
* @example
|
||
|
|
*
|
||
|
|
* ```js
|
||
|
|
* const redFruit = $('<div class="red-fruit"></div>');
|
||
|
|
* $('.apple').wrapInner(redFruit);
|
||
|
|
*
|
||
|
|
* //=> <ul id="fruits">
|
||
|
|
* // <li class="apple">
|
||
|
|
* // <div class="red-fruit">Apple</div>
|
||
|
|
* // </li>
|
||
|
|
* // <li class="orange">Orange</li>
|
||
|
|
* // <li class="pear">Pear</li>
|
||
|
|
* // </ul>
|
||
|
|
*
|
||
|
|
* const healthy = $('<div class="healthy"></div>');
|
||
|
|
* $('li').wrapInner(healthy);
|
||
|
|
*
|
||
|
|
* //=> <ul id="fruits">
|
||
|
|
* // <li class="apple">
|
||
|
|
* // <div class="healthy">Apple</div>
|
||
|
|
* // </li>
|
||
|
|
* // <li class="orange">
|
||
|
|
* // <div class="healthy">Orange</div>
|
||
|
|
* // </li>
|
||
|
|
* // <li class="pear">
|
||
|
|
* // <div class="healthy">Pear</div>
|
||
|
|
* // </li>
|
||
|
|
* // </ul>
|
||
|
|
* ```
|
||
|
|
*
|
||
|
|
* @param wrapper - The DOM structure to wrap around the content of each element
|
||
|
|
* in the selection.
|
||
|
|
* @returns The instance itself, for chaining.
|
||
|
|
* @see {@link https://api.jquery.com/wrapInner/}
|
||
|
|
*/
|
||
|
|
exports.wrapInner = _wrap(function (el, elInsertLocation, wrapperDom) {
|
||
|
|
if (!(0, domhandler_1.hasChildren)(el))
|
||
|
|
return;
|
||
|
|
(0, parse_js_1.update)(el.children, elInsertLocation);
|
||
|
|
(0, parse_js_1.update)(wrapperDom, el);
|
||
|
|
});
|
||
|
|
/**
|
||
|
|
* The .unwrap() function, removes the parents of the set of matched elements
|
||
|
|
* from the DOM, leaving the matched elements in their place.
|
||
|
|
*
|
||
|
|
* @category Manipulation
|
||
|
|
* @example <caption>without selector</caption>
|
||
|
|
*
|
||
|
|
* ```js
|
||
|
|
* const $ = cheerio.load(
|
||
|
|
* '<div id=test>\n <div><p>Hello</p></div>\n <div><p>World</p></div>\n</div>'
|
||
|
|
* );
|
||
|
|
* $('#test p').unwrap();
|
||
|
|
*
|
||
|
|
* //=> <div id=test>
|
||
|
|
* // <p>Hello</p>
|
||
|
|
* // <p>World</p>
|
||
|
|
* // </div>
|
||
|
|
* ```
|
||
|
|
*
|
||
|
|
* @example <caption>with selector</caption>
|
||
|
|
*
|
||
|
|
* ```js
|
||
|
|
* const $ = cheerio.load(
|
||
|
|
* '<div id=test>\n <p>Hello</p>\n <b><p>World</p></b>\n</div>'
|
||
|
|
* );
|
||
|
|
* $('#test p').unwrap('b');
|
||
|
|
*
|
||
|
|
* //=> <div id=test>
|
||
|
|
* // <p>Hello</p>
|
||
|
|
* // <p>World</p>
|
||
|
|
* // </div>
|
||
|
|
* ```
|
||
|
|
*
|
||
|
|
* @param selector - A selector to check the parent element against. If an
|
||
|
|
* element's parent does not match the selector, the element won't be unwrapped.
|
||
|
|
* @returns The instance itself, for chaining.
|
||
|
|
* @see {@link https://api.jquery.com/unwrap/}
|
||
|
|
*/
|
||
|
|
function unwrap(selector) {
|
||
|
|
var _this = this;
|
||
|
|
this.parent(selector)
|
||
|
|
.not('body')
|
||
|
|
.each(function (_, el) {
|
||
|
|
_this._make(el).replaceWith(el.children);
|
||
|
|
});
|
||
|
|
return this;
|
||
|
|
}
|
||
|
|
exports.unwrap = unwrap;
|
||
|
|
/**
|
||
|
|
* The .wrapAll() function can take any string or object that could be passed to
|
||
|
|
* the $() function to specify a DOM structure. This structure may be nested
|
||
|
|
* several levels deep, but should contain only one inmost element. The
|
||
|
|
* structure will be wrapped around all of the elements in the set of matched
|
||
|
|
* elements, as a single group.
|
||
|
|
*
|
||
|
|
* @category Manipulation
|
||
|
|
* @example <caption>With markup passed to `wrapAll`</caption>
|
||
|
|
*
|
||
|
|
* ```js
|
||
|
|
* const $ = cheerio.load(
|
||
|
|
* '<div class="container"><div class="inner">First</div><div class="inner">Second</div></div>'
|
||
|
|
* );
|
||
|
|
* $('.inner').wrapAll("<div class='new'></div>");
|
||
|
|
*
|
||
|
|
* //=> <div class="container">
|
||
|
|
* // <div class='new'>
|
||
|
|
* // <div class="inner">First</div>
|
||
|
|
* // <div class="inner">Second</div>
|
||
|
|
* // </div>
|
||
|
|
* // </div>
|
||
|
|
* ```
|
||
|
|
*
|
||
|
|
* @example <caption>With an existing cheerio instance</caption>
|
||
|
|
*
|
||
|
|
* ```js
|
||
|
|
* const $ = cheerio.load(
|
||
|
|
* '<span>Span 1</span><strong>Strong</strong><span>Span 2</span>'
|
||
|
|
* );
|
||
|
|
* const wrap = $('<div><p><em><b></b></em></p></div>');
|
||
|
|
* $('span').wrapAll(wrap);
|
||
|
|
*
|
||
|
|
* //=> <div>
|
||
|
|
* // <p>
|
||
|
|
* // <em>
|
||
|
|
* // <b>
|
||
|
|
* // <span>Span 1</span>
|
||
|
|
* // <span>Span 2</span>
|
||
|
|
* // </b>
|
||
|
|
* // </em>
|
||
|
|
* // </p>
|
||
|
|
* // </div>
|
||
|
|
* // <strong>Strong</strong>
|
||
|
|
* ```
|
||
|
|
*
|
||
|
|
* @param wrapper - The DOM structure to wrap around all matched elements in the
|
||
|
|
* selection.
|
||
|
|
* @returns The instance itself.
|
||
|
|
* @see {@link https://api.jquery.com/wrapAll/}
|
||
|
|
*/
|
||
|
|
function wrapAll(wrapper) {
|
||
|
|
var el = this[0];
|
||
|
|
if (el) {
|
||
|
|
var wrap_2 = this._make(typeof wrapper === 'function' ? wrapper.call(el, 0, el) : wrapper).insertBefore(el);
|
||
|
|
// If html is given as wrapper, wrap may contain text elements
|
||
|
|
var elInsertLocation = void 0;
|
||
|
|
for (var i = 0; i < wrap_2.length; i++) {
|
||
|
|
if (wrap_2[i].type === 'tag')
|
||
|
|
elInsertLocation = wrap_2[i];
|
||
|
|
}
|
||
|
|
var j = 0;
|
||
|
|
/*
|
||
|
|
* Find the deepest child. Only consider the first tag child of each node
|
||
|
|
* (ignore text); stop if no children are found.
|
||
|
|
*/
|
||
|
|
while (elInsertLocation && j < elInsertLocation.children.length) {
|
||
|
|
var child = elInsertLocation.children[j];
|
||
|
|
if (child.type === 'tag') {
|
||
|
|
elInsertLocation = child;
|
||
|
|
j = 0;
|
||
|
|
}
|
||
|
|
else {
|
||
|
|
j++;
|
||
|
|
}
|
||
|
|
}
|
||
|
|
if (elInsertLocation)
|
||
|
|
this._make(elInsertLocation).append(this);
|
||
|
|
}
|
||
|
|
return this;
|
||
|
|
}
|
||
|
|
exports.wrapAll = wrapAll;
|
||
|
|
/* eslint-disable jsdoc/check-param-names*/
|
||
|
|
/**
|
||
|
|
* Insert content next to each element in the set of matched elements.
|
||
|
|
*
|
||
|
|
* @category Manipulation
|
||
|
|
* @example
|
||
|
|
*
|
||
|
|
* ```js
|
||
|
|
* $('.apple').after('<li class="plum">Plum</li>');
|
||
|
|
* $.html();
|
||
|
|
* //=> <ul id="fruits">
|
||
|
|
* // <li class="apple">Apple</li>
|
||
|
|
* // <li class="plum">Plum</li>
|
||
|
|
* // <li class="orange">Orange</li>
|
||
|
|
* // <li class="pear">Pear</li>
|
||
|
|
* // </ul>
|
||
|
|
* ```
|
||
|
|
*
|
||
|
|
* @param content - HTML string, DOM element, array of DOM elements or Cheerio
|
||
|
|
* to insert after each element in the set of matched elements.
|
||
|
|
* @returns The instance itself.
|
||
|
|
* @see {@link https://api.jquery.com/after/}
|
||
|
|
*/
|
||
|
|
function after() {
|
||
|
|
var _this = this;
|
||
|
|
var elems = [];
|
||
|
|
for (var _i = 0; _i < arguments.length; _i++) {
|
||
|
|
elems[_i] = arguments[_i];
|
||
|
|
}
|
||
|
|
var lastIdx = this.length - 1;
|
||
|
|
return (0, utils_js_1.domEach)(this, function (el, i) {
|
||
|
|
var parent = el.parent;
|
||
|
|
if (!(0, domhandler_1.hasChildren)(el) || !parent) {
|
||
|
|
return;
|
||
|
|
}
|
||
|
|
var siblings = parent.children;
|
||
|
|
var index = siblings.indexOf(el);
|
||
|
|
// If not found, move on
|
||
|
|
/* istanbul ignore next */
|
||
|
|
if (index < 0)
|
||
|
|
return;
|
||
|
|
var domSrc = typeof elems[0] === 'function'
|
||
|
|
? elems[0].call(el, i, _this._render(el.children))
|
||
|
|
: elems;
|
||
|
|
var dom = _this._makeDomArray(domSrc, i < lastIdx);
|
||
|
|
// Add element after `this` element
|
||
|
|
uniqueSplice(siblings, index + 1, 0, dom, parent);
|
||
|
|
});
|
||
|
|
}
|
||
|
|
exports.after = after;
|
||
|
|
/* eslint-enable jsdoc/check-param-names*/
|
||
|
|
/**
|
||
|
|
* Insert every element in the set of matched elements after the target.
|
||
|
|
*
|
||
|
|
* @category Manipulation
|
||
|
|
* @example
|
||
|
|
*
|
||
|
|
* ```js
|
||
|
|
* $('<li class="plum">Plum</li>').insertAfter('.apple');
|
||
|
|
* $.html();
|
||
|
|
* //=> <ul id="fruits">
|
||
|
|
* // <li class="apple">Apple</li>
|
||
|
|
* // <li class="plum">Plum</li>
|
||
|
|
* // <li class="orange">Orange</li>
|
||
|
|
* // <li class="pear">Pear</li>
|
||
|
|
* // </ul>
|
||
|
|
* ```
|
||
|
|
*
|
||
|
|
* @param target - Element to insert elements after.
|
||
|
|
* @returns The set of newly inserted elements.
|
||
|
|
* @see {@link https://api.jquery.com/insertAfter/}
|
||
|
|
*/
|
||
|
|
function insertAfter(target) {
|
||
|
|
var _this = this;
|
||
|
|
if (typeof target === 'string') {
|
||
|
|
target = this._make(target);
|
||
|
|
}
|
||
|
|
this.remove();
|
||
|
|
var clones = [];
|
||
|
|
this._makeDomArray(target).forEach(function (el) {
|
||
|
|
var clonedSelf = _this.clone().toArray();
|
||
|
|
var parent = el.parent;
|
||
|
|
if (!parent) {
|
||
|
|
return;
|
||
|
|
}
|
||
|
|
var siblings = parent.children;
|
||
|
|
var index = siblings.indexOf(el);
|
||
|
|
// If not found, move on
|
||
|
|
/* istanbul ignore next */
|
||
|
|
if (index < 0)
|
||
|
|
return;
|
||
|
|
// Add cloned `this` element(s) after target element
|
||
|
|
uniqueSplice(siblings, index + 1, 0, clonedSelf, parent);
|
||
|
|
clones.push.apply(clones, clonedSelf);
|
||
|
|
});
|
||
|
|
return this._make(clones);
|
||
|
|
}
|
||
|
|
exports.insertAfter = insertAfter;
|
||
|
|
/* eslint-disable jsdoc/check-param-names*/
|
||
|
|
/**
|
||
|
|
* Insert content previous to each element in the set of matched elements.
|
||
|
|
*
|
||
|
|
* @category Manipulation
|
||
|
|
* @example
|
||
|
|
*
|
||
|
|
* ```js
|
||
|
|
* $('.apple').before('<li class="plum">Plum</li>');
|
||
|
|
* $.html();
|
||
|
|
* //=> <ul id="fruits">
|
||
|
|
* // <li class="plum">Plum</li>
|
||
|
|
* // <li class="apple">Apple</li>
|
||
|
|
* // <li class="orange">Orange</li>
|
||
|
|
* // <li class="pear">Pear</li>
|
||
|
|
* // </ul>
|
||
|
|
* ```
|
||
|
|
*
|
||
|
|
* @param content - HTML string, DOM element, array of DOM elements or Cheerio
|
||
|
|
* to insert before each element in the set of matched elements.
|
||
|
|
* @returns The instance itself.
|
||
|
|
* @see {@link https://api.jquery.com/before/}
|
||
|
|
*/
|
||
|
|
function before() {
|
||
|
|
var _this = this;
|
||
|
|
var elems = [];
|
||
|
|
for (var _i = 0; _i < arguments.length; _i++) {
|
||
|
|
elems[_i] = arguments[_i];
|
||
|
|
}
|
||
|
|
var lastIdx = this.length - 1;
|
||
|
|
return (0, utils_js_1.domEach)(this, function (el, i) {
|
||
|
|
var parent = el.parent;
|
||
|
|
if (!(0, domhandler_1.hasChildren)(el) || !parent) {
|
||
|
|
return;
|
||
|
|
}
|
||
|
|
var siblings = parent.children;
|
||
|
|
var index = siblings.indexOf(el);
|
||
|
|
// If not found, move on
|
||
|
|
/* istanbul ignore next */
|
||
|
|
if (index < 0)
|
||
|
|
return;
|
||
|
|
var domSrc = typeof elems[0] === 'function'
|
||
|
|
? elems[0].call(el, i, _this._render(el.children))
|
||
|
|
: elems;
|
||
|
|
var dom = _this._makeDomArray(domSrc, i < lastIdx);
|
||
|
|
// Add element before `el` element
|
||
|
|
uniqueSplice(siblings, index, 0, dom, parent);
|
||
|
|
});
|
||
|
|
}
|
||
|
|
exports.before = before;
|
||
|
|
/* eslint-enable jsdoc/check-param-names*/
|
||
|
|
/**
|
||
|
|
* Insert every element in the set of matched elements before the target.
|
||
|
|
*
|
||
|
|
* @category Manipulation
|
||
|
|
* @example
|
||
|
|
*
|
||
|
|
* ```js
|
||
|
|
* $('<li class="plum">Plum</li>').insertBefore('.apple');
|
||
|
|
* $.html();
|
||
|
|
* //=> <ul id="fruits">
|
||
|
|
* // <li class="plum">Plum</li>
|
||
|
|
* // <li class="apple">Apple</li>
|
||
|
|
* // <li class="orange">Orange</li>
|
||
|
|
* // <li class="pear">Pear</li>
|
||
|
|
* // </ul>
|
||
|
|
* ```
|
||
|
|
*
|
||
|
|
* @param target - Element to insert elements before.
|
||
|
|
* @returns The set of newly inserted elements.
|
||
|
|
* @see {@link https://api.jquery.com/insertBefore/}
|
||
|
|
*/
|
||
|
|
function insertBefore(target) {
|
||
|
|
var _this = this;
|
||
|
|
var targetArr = this._make(target);
|
||
|
|
this.remove();
|
||
|
|
var clones = [];
|
||
|
|
(0, utils_js_1.domEach)(targetArr, function (el) {
|
||
|
|
var clonedSelf = _this.clone().toArray();
|
||
|
|
var parent = el.parent;
|
||
|
|
if (!parent) {
|
||
|
|
return;
|
||
|
|
}
|
||
|
|
var siblings = parent.children;
|
||
|
|
var index = siblings.indexOf(el);
|
||
|
|
// If not found, move on
|
||
|
|
/* istanbul ignore next */
|
||
|
|
if (index < 0)
|
||
|
|
return;
|
||
|
|
// Add cloned `this` element(s) after target element
|
||
|
|
uniqueSplice(siblings, index, 0, clonedSelf, parent);
|
||
|
|
clones.push.apply(clones, clonedSelf);
|
||
|
|
});
|
||
|
|
return this._make(clones);
|
||
|
|
}
|
||
|
|
exports.insertBefore = insertBefore;
|
||
|
|
/**
|
||
|
|
* Removes the set of matched elements from the DOM and all their children.
|
||
|
|
* `selector` filters the set of matched elements to be removed.
|
||
|
|
*
|
||
|
|
* @category Manipulation
|
||
|
|
* @example
|
||
|
|
*
|
||
|
|
* ```js
|
||
|
|
* $('.pear').remove();
|
||
|
|
* $.html();
|
||
|
|
* //=> <ul id="fruits">
|
||
|
|
* // <li class="apple">Apple</li>
|
||
|
|
* // <li class="orange">Orange</li>
|
||
|
|
* // </ul>
|
||
|
|
* ```
|
||
|
|
*
|
||
|
|
* @param selector - Optional selector for elements to remove.
|
||
|
|
* @returns The instance itself.
|
||
|
|
* @see {@link https://api.jquery.com/remove/}
|
||
|
|
*/
|
||
|
|
function remove(selector) {
|
||
|
|
// Filter if we have selector
|
||
|
|
var elems = selector ? this.filter(selector) : this;
|
||
|
|
(0, utils_js_1.domEach)(elems, function (el) {
|
||
|
|
(0, domutils_1.removeElement)(el);
|
||
|
|
el.prev = el.next = el.parent = null;
|
||
|
|
});
|
||
|
|
return this;
|
||
|
|
}
|
||
|
|
exports.remove = remove;
|
||
|
|
/**
|
||
|
|
* Replaces matched elements with `content`.
|
||
|
|
*
|
||
|
|
* @category Manipulation
|
||
|
|
* @example
|
||
|
|
*
|
||
|
|
* ```js
|
||
|
|
* const plum = $('<li class="plum">Plum</li>');
|
||
|
|
* $('.pear').replaceWith(plum);
|
||
|
|
* $.html();
|
||
|
|
* //=> <ul id="fruits">
|
||
|
|
* // <li class="apple">Apple</li>
|
||
|
|
* // <li class="orange">Orange</li>
|
||
|
|
* // <li class="plum">Plum</li>
|
||
|
|
* // </ul>
|
||
|
|
* ```
|
||
|
|
*
|
||
|
|
* @param content - Replacement for matched elements.
|
||
|
|
* @returns The instance itself.
|
||
|
|
* @see {@link https://api.jquery.com/replaceWith/}
|
||
|
|
*/
|
||
|
|
function replaceWith(content) {
|
||
|
|
var _this = this;
|
||
|
|
return (0, utils_js_1.domEach)(this, function (el, i) {
|
||
|
|
var parent = el.parent;
|
||
|
|
if (!parent) {
|
||
|
|
return;
|
||
|
|
}
|
||
|
|
var siblings = parent.children;
|
||
|
|
var cont = typeof content === 'function' ? content.call(el, i, el) : content;
|
||
|
|
var dom = _this._makeDomArray(cont);
|
||
|
|
/*
|
||
|
|
* In the case that `dom` contains nodes that already exist in other
|
||
|
|
* structures, ensure those nodes are properly removed.
|
||
|
|
*/
|
||
|
|
(0, parse_js_1.update)(dom, null);
|
||
|
|
var index = siblings.indexOf(el);
|
||
|
|
// Completely remove old element
|
||
|
|
uniqueSplice(siblings, index, 1, dom, parent);
|
||
|
|
if (!dom.includes(el)) {
|
||
|
|
el.parent = el.prev = el.next = null;
|
||
|
|
}
|
||
|
|
});
|
||
|
|
}
|
||
|
|
exports.replaceWith = replaceWith;
|
||
|
|
/**
|
||
|
|
* Empties an element, removing all its children.
|
||
|
|
*
|
||
|
|
* @category Manipulation
|
||
|
|
* @example
|
||
|
|
*
|
||
|
|
* ```js
|
||
|
|
* $('ul').empty();
|
||
|
|
* $.html();
|
||
|
|
* //=> <ul id="fruits"></ul>
|
||
|
|
* ```
|
||
|
|
*
|
||
|
|
* @returns The instance itself.
|
||
|
|
* @see {@link https://api.jquery.com/empty/}
|
||
|
|
*/
|
||
|
|
function empty() {
|
||
|
|
return (0, utils_js_1.domEach)(this, function (el) {
|
||
|
|
if (!(0, domhandler_1.hasChildren)(el))
|
||
|
|
return;
|
||
|
|
el.children.forEach(function (child) {
|
||
|
|
child.next = child.prev = child.parent = null;
|
||
|
|
});
|
||
|
|
el.children.length = 0;
|
||
|
|
});
|
||
|
|
}
|
||
|
|
exports.empty = empty;
|
||
|
|
function html(str) {
|
||
|
|
var _this = this;
|
||
|
|
if (str === undefined) {
|
||
|
|
var el = this[0];
|
||
|
|
if (!el || !(0, domhandler_1.hasChildren)(el))
|
||
|
|
return null;
|
||
|
|
return this._render(el.children);
|
||
|
|
}
|
||
|
|
return (0, utils_js_1.domEach)(this, function (el) {
|
||
|
|
if (!(0, domhandler_1.hasChildren)(el))
|
||
|
|
return;
|
||
|
|
el.children.forEach(function (child) {
|
||
|
|
child.next = child.prev = child.parent = null;
|
||
|
|
});
|
||
|
|
var content = (0, utils_js_1.isCheerio)(str)
|
||
|
|
? str.toArray()
|
||
|
|
: _this._parse("".concat(str), _this.options, false, el).children;
|
||
|
|
(0, parse_js_1.update)(content, el);
|
||
|
|
});
|
||
|
|
}
|
||
|
|
exports.html = html;
|
||
|
|
/**
|
||
|
|
* Turns the collection to a string. Alias for `.html()`.
|
||
|
|
*
|
||
|
|
* @category Manipulation
|
||
|
|
* @returns The rendered document.
|
||
|
|
*/
|
||
|
|
function toString() {
|
||
|
|
return this._render(this);
|
||
|
|
}
|
||
|
|
exports.toString = toString;
|
||
|
|
function text(str) {
|
||
|
|
var _this = this;
|
||
|
|
// If `str` is undefined, act as a "getter"
|
||
|
|
if (str === undefined) {
|
||
|
|
return (0, static_js_1.text)(this);
|
||
|
|
}
|
||
|
|
if (typeof str === 'function') {
|
||
|
|
// Function support
|
||
|
|
return (0, utils_js_1.domEach)(this, function (el, i) {
|
||
|
|
return _this._make(el).text(str.call(el, i, (0, static_js_1.text)([el])));
|
||
|
|
});
|
||
|
|
}
|
||
|
|
// Append text node to each selected elements
|
||
|
|
return (0, utils_js_1.domEach)(this, function (el) {
|
||
|
|
if (!(0, domhandler_1.hasChildren)(el))
|
||
|
|
return;
|
||
|
|
el.children.forEach(function (child) {
|
||
|
|
child.next = child.prev = child.parent = null;
|
||
|
|
});
|
||
|
|
var textNode = new domhandler_1.Text("".concat(str));
|
||
|
|
(0, parse_js_1.update)(textNode, el);
|
||
|
|
});
|
||
|
|
}
|
||
|
|
exports.text = text;
|
||
|
|
/**
|
||
|
|
* Clone the cheerio object.
|
||
|
|
*
|
||
|
|
* @category Manipulation
|
||
|
|
* @example
|
||
|
|
*
|
||
|
|
* ```js
|
||
|
|
* const moreFruit = $('#fruits').clone();
|
||
|
|
* ```
|
||
|
|
*
|
||
|
|
* @returns The cloned object.
|
||
|
|
* @see {@link https://api.jquery.com/clone/}
|
||
|
|
*/
|
||
|
|
function clone() {
|
||
|
|
return this._make((0, utils_js_1.cloneDom)(this.get()));
|
||
|
|
}
|
||
|
|
exports.clone = clone;
|
||
|
|
//# sourceMappingURL=manipulation.js.map
|