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
"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
|