reference/dom/domelement/getelementsbytagnamens.xml
842bbe35c608b95d04ba5c0e0f5eeb4bd4dcd799
...
...
@@ -1,20 +1,20 @@
1
1
<?xml version="1.0" encoding="utf-8"?>
2
2
<!-- $Revision$ -->
3
-
<refentry xml:id='domelement.getelementsbytagnamens' xmlns="http://docbook.org/ns/docbook">
3
+
<refentry xml:id="domelement.getelementsbytagnamens" xmlns="http://docbook.org/ns/docbook">
4
4
<refnamediv>
5
5
<refname>DOMElement::getElementsByTagNameNS</refname>
6
6
<refpurpose>Get elements by namespaceURI and localName</refpurpose>
7
7
</refnamediv>
8
8
<refsect1 role="description">
9
9
&reftitle.description;
10
-
<methodsynopsis>
10
+
<methodsynopsis role="DOMElement">
11
11
<modifier>public</modifier> <type>DOMNodeList</type><methodname>DOMElement::getElementsByTagNameNS</methodname>
12
-
<methodparam><type>string</type><parameter>namespaceURI</parameter></methodparam>
12
+
<methodparam><type class="union"><type>string</type><type>null</type></type><parameter>namespace</parameter></methodparam>
13
13
<methodparam><type>string</type><parameter>localName</parameter></methodparam>
14
14
</methodsynopsis>
15
15
<para>
16
16
This function fetch all the descendant elements with a given
17
-
<parameter>localName</parameter> and <parameter>namespaceURI</parameter>.
17
+
<parameter>localName</parameter> and <parameter>namespace</parameter>.
18
18
</para>
19
19
</refsect1>
20
20
<refsect1 role="parameters">
...
...
@@ -22,10 +22,12 @@
22
22
<para>
23
23
<variablelist>
24
24
<varlistentry>
25
-
<term><parameter>namespaceURI</parameter></term>
25
+
<term><parameter>namespace</parameter></term>
26
26
<listitem>
27
27
<para>
28
-
The namespace URI.
28
+
The namespace URI of the elements to match on.
29
+
The special value <literal>"*"</literal> matches all namespaces.
30
+
Passing &null; matches the empty namespace.
29
31
</para>
30
32
</listitem>
31
33
</varlistentry>
...
...
@@ -33,8 +35,8 @@
33
35
<term><parameter>localName</parameter></term>
34
36
<listitem>
35
37
<para>
36
-
The local name. Use <literal>*</literal> to return all elements within
37
-
the element tree.
38
+
The local name of the elements to match on.
39
+
The special value <literal>"*"</literal> matches all local names.
38
40
</para>
39
41
</listitem>
40
42
</varlistentry>
...
...
@@ -49,6 +51,29 @@
49
51
which they are encountered in a preorder traversal of this element tree.
50
52
</para>
51
53
</refsect1>
54
+

55
+
<refsect1 role="changelog">
56
+
&reftitle.changelog;
57
+
<informaltable>
58
+
<tgroup cols="2">
59
+
<thead>
60
+
<row>
61
+
<entry>&Version;</entry>
62
+
<entry>&Description;</entry>
63
+
</row>
64
+
</thead>
65
+
<tbody>
66
+
<row>
67
+
<entry>8.0.3</entry>
68
+
<entry>
69
+
<parameter>namespace</parameter> is nullable now.
70
+
</entry>
71
+
</row>
72
+
</tbody>
73
+
</tgroup>
74
+
</informaltable>
75
+
</refsect1>
76
+

52
77
<refsect1 role="seealso">
53
78
&reftitle.seealso;
54
79
<para>
...
...
@@ -58,7 +83,6 @@
58
83
</para>
59
84
</refsect1>
60
85
</refentry>
61
-

62
86
<!-- Keep this comment at the end of the file
63
87
Local variables:
64
88
mode: sgml
65
89