Skip to content

Commit 9bf395a

Browse files
committed
append: Documented that it accepts text nodes
Fixes gh-879 Closes gh-914
1 parent e45384e commit 9bf395a

4 files changed

Lines changed: 28 additions & 14 deletions

File tree

entries/after.xml

Lines changed: 8 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -4,41 +4,45 @@
44
<signature>
55
<added>1.0</added>
66
<argument name="content">
7-
<desc>HTML string, DOM element, array of elements, or jQuery object to insert after each element in the set of matched elements.</desc>
7+
<desc>HTML string, DOM element, text node, array of elements and text nodes, or jQuery object to insert after each element in the set of matched elements.</desc>
88
<type name="htmlString"/>
99
<type name="Element"/>
10+
<type name="Text"/>
1011
<type name="Array"/>
1112
<type name="jQuery"/>
1213
</argument>
1314
<argument name="content" optional="true">
14-
<desc>One or more additional DOM elements, arrays of elements, HTML strings, or jQuery objects to insert after each element in the set of matched elements.</desc>
15+
<desc>One or more additional DOM elements, text nodes, arrays of elements and text nodes, HTML strings, or jQuery objects to insert after each element in the set of matched elements.</desc>
1516
<type name="htmlString"/>
1617
<type name="Element"/>
18+
<type name="Text"/>
1719
<type name="Array"/>
1820
<type name="jQuery"/>
1921
</argument>
2022
</signature>
2123
<signature>
2224
<added>1.4</added>
2325
<argument name="function" type="Function">
24-
<desc>A function that returns an HTML string, DOM element(s), or jQuery object to insert after each element in the set of matched elements. Receives the index position of the element in the set as an argument. Within the function, <code>this</code> refers to the current element in the set.</desc>
26+
<desc>A function that returns an HTML string, DOM element(s), text node(s), or jQuery object to insert after each element in the set of matched elements. Receives the index position of the element in the set as an argument. Within the function, <code>this</code> refers to the current element in the set.</desc>
2527
<argument name="index" type="Integer" />
2628
<return>
2729
<type name="htmlString"/>
2830
<type name="Element"/>
31+
<type name="Text"/>
2932
<type name="jQuery"/>
3033
</return>
3134
</argument>
3235
</signature>
3336
<signature>
3437
<added>1.10</added>
3538
<argument name="function-html" type="Function">
36-
<desc>A function that returns an HTML string, DOM element(s), or jQuery object to insert after each element in the set of matched elements. Receives the index position of the element in the set and the old HTML value of the element as arguments. Within the function, <code>this</code> refers to the current element in the set.</desc>
39+
<desc>A function that returns an HTML string, DOM element(s), text node(s), or jQuery object to insert after each element in the set of matched elements. Receives the index position of the element in the set and the old HTML value of the element as arguments. Within the function, <code>this</code> refers to the current element in the set.</desc>
3740
<argument name="index" type="Integer" />
3841
<argument name="html" type="String" />
3942
<return>
4043
<type name="htmlString"/>
4144
<type name="Element"/>
45+
<type name="Text"/>
4246
<type name="jQuery"/>
4347
</return>
4448
</argument>

entries/append.xml

Lines changed: 6 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -4,29 +4,32 @@
44
<signature>
55
<added>1.0</added>
66
<argument name="content">
7-
<desc>DOM element, array of elements, HTML string, or jQuery object to insert at the end of each element in the set of matched elements.</desc>
7+
<desc>DOM element, text node, array of elements and text nodes, HTML string, or jQuery object to insert at the end of each element in the set of matched elements.</desc>
88
<type name="htmlString"/>
99
<type name="Element"/>
10+
<type name="Text"/>
1011
<type name="Array"/>
1112
<type name="jQuery"/>
1213
</argument>
1314
<argument name="content" optional="true">
14-
<desc>One or more additional DOM elements, arrays of elements, HTML strings, or jQuery objects to insert at the end of each element in the set of matched elements.</desc>
15+
<desc>One or more additional DOM elements, text nodes, arrays of elements and text nodes, HTML strings, or jQuery objects to insert at the end of each element in the set of matched elements.</desc>
1516
<type name="htmlString"/>
1617
<type name="Element"/>
18+
<type name="Text"/>
1719
<type name="Array"/>
1820
<type name="jQuery"/>
1921
</argument>
2022
</signature>
2123
<signature>
2224
<added>1.4</added>
2325
<argument name="function" type="Function">
24-
<desc>A function that returns an HTML string, DOM element(s), or jQuery object to insert at the end of each element in the set of matched elements. Receives the index position of the element in the set and the old HTML value of the element as arguments. Within the function, <code>this</code> refers to the current element in the set.</desc>
26+
<desc>A function that returns an HTML string, DOM element(s), text node(s), or jQuery object to insert at the end of each element in the set of matched elements. Receives the index position of the element in the set and the old HTML value of the element as arguments. Within the function, <code>this</code> refers to the current element in the set.</desc>
2527
<argument name="index" type="Integer" />
2628
<argument name="html" type="String" />
2729
<return>
2830
<type name="htmlString"/>
2931
<type name="Element"/>
32+
<type name="Text"/>
3033
<type name="jQuery"/>
3134
</return>
3235
</argument>

entries/before.xml

Lines changed: 8 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -4,16 +4,18 @@
44
<signature>
55
<added>1.0</added>
66
<argument name="content">
7-
<desc>HTML string, DOM element, array of elements, or jQuery object to insert before each element in the set of matched elements.</desc>
7+
<desc>HTML string, DOM element, text node, array of elements and text nodes, or jQuery object to insert before each element in the set of matched elements.</desc>
88
<type name="htmlString"/>
99
<type name="Element"/>
10+
<type name="Text"/>
1011
<type name="Array"/>
1112
<type name="jQuery"/>
1213
</argument>
1314
<argument name="content" optional="true">
14-
<desc>One or more additional DOM elements, arrays of elements, HTML strings, or jQuery objects to insert before each element in the set of matched elements.</desc>
15+
<desc>One or more additional DOM elements, text nodes, arrays of elements and text nodes, HTML strings, or jQuery objects to insert before each element in the set of matched elements.</desc>
1516
<type name="htmlString"/>
1617
<type name="Element"/>
18+
<type name="Text"/>
1719
<type name="Array"/>
1820
<type name="jQuery"/>
1921
</argument>
@@ -25,9 +27,10 @@
2527
<return>
2628
<type name="htmlString"/>
2729
<type name="Element"/>
30+
<type name="Text"/>
2831
<type name="jQuery"/>
2932
</return>
30-
<desc>A function that returns an HTML string, DOM element(s), or jQuery object to insert before each element in the set of matched elements. Receives the index position of the element in the set as an argument. Within the function, <code>this</code> refers to the current element in the set.
33+
<desc>A function that returns an HTML string, DOM element(s), text node(s), or jQuery object to insert before each element in the set of matched elements. Receives the index position of the element in the set as an argument. Within the function, <code>this</code> refers to the current element in the set.
3134
</desc>
3235
</argument>
3336
</signature>
@@ -39,9 +42,10 @@
3942
<return>
4043
<type name="htmlString"/>
4144
<type name="Element"/>
45+
<type name="Text"/>
4246
<type name="jQuery"/>
4347
</return>
44-
<desc>A function that returns an HTML string, DOM element(s), or jQuery object to insert before each element in the set of matched elements. Receives the index position of the element in the set and the old HTML value of the element as arguments. Within the function, <code>this</code> refers to the current element in the set.
48+
<desc>A function that returns an HTML string, DOM element(s), text node(s), or jQuery object to insert before each element in the set of matched elements. Receives the index position of the element in the set and the old HTML value of the element as arguments. Within the function, <code>this</code> refers to the current element in the set.
4549
</desc>
4650
</argument>
4751
</signature>

entries/prepend.xml

Lines changed: 6 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -4,18 +4,20 @@
44
<signature>
55
<added>1.0</added>
66
<argument name="content">
7-
<desc>DOM element, array of elements, HTML string, or jQuery object to insert at the beginning of each element in the set of matched elements.</desc>
7+
<desc>DOM element, text node, array of elements and text nodes, HTML string, or jQuery object to insert at the beginning of each element in the set of matched elements.</desc>
88
<type name="htmlString"/>
99
<type name="Element"/>
10+
<type name="Text"/>
1011
<type name="Array"/>
1112
<type name="jQuery"/>
1213
</argument>
1314
<argument name="content" optional="true">
1415
<type name="htmlString"/>
1516
<type name="Element"/>
17+
<type name="Text"/>
1618
<type name="Array"/>
1719
<type name="jQuery"/>
18-
<desc>One or more additional DOM elements, arrays of elements, HTML strings, or jQuery objects to insert at the beginning of each element in the set of matched elements.</desc>
20+
<desc>One or more additional DOM elements, text nodes, arrays of elements and text nodes, HTML strings, or jQuery objects to insert at the beginning of each element in the set of matched elements.</desc>
1921
</argument>
2022
</signature>
2123
<signature>
@@ -26,9 +28,10 @@
2628
<return>
2729
<type name="htmlString"/>
2830
<type name="Element"/>
31+
<type name="Text"/>
2932
<type name="jQuery"/>
3033
</return>
31-
<desc>A function that returns an HTML string, DOM element(s), or jQuery object to insert at the beginning of each element in the set of matched elements. Receives the index position of the element in the set and the old HTML value of the element as arguments. Within the function, <code>this</code> refers to the current element in the set.</desc>
34+
<desc>A function that returns an HTML string, DOM element(s), text node(s), or jQuery object to insert at the beginning of each element in the set of matched elements. Receives the index position of the element in the set and the old HTML value of the element as arguments. Within the function, <code>this</code> refers to the current element in the set.</desc>
3235
</argument>
3336
</signature>
3437
<desc>Insert content, specified by the parameter, to the beginning of each element in the set of matched elements.</desc>

0 commit comments

Comments
 (0)