reference/dom/domnode.xml
fa6a5829a0d00c24eea2ed9a270e4b56f73c032f
...
...
@@ -1,6 +1,6 @@
1
1
<?xml version="1.0" encoding="utf-8"?>
2
2
<!-- $Revision$ -->
3
-
<phpdoc:classref xmlns:phpdoc="http://php.net/ns/phpdoc" xml:id="class.domnode" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
3
+
<phpdoc:classref xml:id="class.domnode" xmlns:phpdoc="http://php.net/ns/phpdoc" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
4
4
<title>The DOMNode class</title>
5
5
<titleabbrev>DOMNode</titleabbrev>
6
6
...
...
@@ -19,20 +19,12 @@
19
19
&reftitle.classsynopsis;
20
20
21
21
<!-- {{{ Synopsis -->
22
-
<classsynopsis>
23
-
<ooclass><classname>DOMNode</classname></ooclass>
24
-
25
-
<!-- {{{ Class synopsis -->
26
-
<classsynopsisinfo>
27
-
<ooclass>
28
-
<classname>DOMNode</classname>
29
-
</ooclass>
30
-
31
-
</classsynopsisinfo>
32
-
<!-- }}} -->
22
+
<classsynopsis class="class">
23
+
<ooclass>
24
+
<classname>DOMNode</classname>
25
+
</ooclass>
33
26

34
27
<classsynopsisinfo role="comment">&Properties;</classsynopsisinfo>
35
-
<!-- If the property is documented below (xml:id=domnode.props) use this -->
36
28
<fieldsynopsis>
37
29
<modifier>public</modifier>
38
30
<modifier>readonly</modifier>
...
...
@@ -41,7 +33,7 @@
41
33
</fieldsynopsis>
42
34
<fieldsynopsis>
43
35
<modifier>public</modifier>
44
-
<type>string</type>
36
+
<type class="union"><type>string</type><type>null</type></type>
45
37
<varname linkend="domnode.props.nodevalue">nodeValue</varname>
46
38
</fieldsynopsis>
47
39
<fieldsynopsis>
...
...
@@ -53,55 +45,67 @@
53
45
<fieldsynopsis>
54
46
<modifier>public</modifier>
55
47
<modifier>readonly</modifier>
56
-
<type>DOMNode</type>
48
+
<type class="union"><type>DOMNode</type><type>null</type></type>
57
49
<varname linkend="domnode.props.parentnode">parentNode</varname>
58
50
</fieldsynopsis>
59
51
<fieldsynopsis>
60
52
<modifier>public</modifier>
61
53
<modifier>readonly</modifier>
54
+
<type class="union"><type>DOMElement</type><type>null</type></type>
55
+
<varname linkend="domnode.props.parentelement">parentElement</varname>
56
+
</fieldsynopsis>
57
+
<fieldsynopsis>
58
+
<modifier>public</modifier>
59
+
<modifier>readonly</modifier>
62
60
<type>DOMNodeList</type>
63
61
<varname linkend="domnode.props.childnodes">childNodes</varname>
64
62
</fieldsynopsis>
65
63
<fieldsynopsis>
66
64
<modifier>public</modifier>
67
65
<modifier>readonly</modifier>
68
-
<type>DOMNode</type>
66
+
<type class="union"><type>DOMNode</type><type>null</type></type>
69
67
<varname linkend="domnode.props.firstchild">firstChild</varname>
70
68
</fieldsynopsis>
71
69
<fieldsynopsis>
72
70
<modifier>public</modifier>
73
71
<modifier>readonly</modifier>
74
-
<type>DOMNode</type>
72
+
<type class="union"><type>DOMNode</type><type>null</type></type>
75
73
<varname linkend="domnode.props.lastchild">lastChild</varname>
76
74
</fieldsynopsis>
77
75
<fieldsynopsis>
78
76
<modifier>public</modifier>
79
77
<modifier>readonly</modifier>
80
-
<type>DOMNode</type>
78
+
<type class="union"><type>DOMNode</type><type>null</type></type>
81
79
<varname linkend="domnode.props.previoussibling">previousSibling</varname>
82
80
</fieldsynopsis>
83
81
<fieldsynopsis>
84
82
<modifier>public</modifier>
85
83
<modifier>readonly</modifier>
86
-
<type>DOMNode</type>
84
+
<type class="union"><type>DOMNode</type><type>null</type></type>
87
85
<varname linkend="domnode.props.nextsibling">nextSibling</varname>
88
86
</fieldsynopsis>
89
87
<fieldsynopsis>
90
88
<modifier>public</modifier>
91
89
<modifier>readonly</modifier>
92
-
<type>DOMNamedNodeMap</type>
90
+
<type class="union"><type>DOMNamedNodeMap</type><type>null</type></type>
93
91
<varname linkend="domnode.props.attributes">attributes</varname>
94
92
</fieldsynopsis>
95
93
<fieldsynopsis>
96
94
<modifier>public</modifier>
97
95
<modifier>readonly</modifier>
98
-
<type>DOMDocument</type>
96
+
<type>bool</type>
97
+
<varname linkend="domnode.props.isconnected">isConnected</varname>
98
+
</fieldsynopsis>
99
+
<fieldsynopsis>
100
+
<modifier>public</modifier>
101
+
<modifier>readonly</modifier>
102
+
<type class="union"><type>DOMDocument</type><type>null</type></type>
99
103
<varname linkend="domnode.props.ownerdocument">ownerDocument</varname>
100
104
</fieldsynopsis>
101
105
<fieldsynopsis>
102
106
<modifier>public</modifier>
103
107
<modifier>readonly</modifier>
104
-
<type>string</type>
108
+
<type class="union"><type>string</type><type>null</type></type>
105
109
<varname linkend="domnode.props.namespaceuri">namespaceURI</varname>
106
110
</fieldsynopsis>
107
111
<fieldsynopsis>
...
...
@@ -112,13 +116,13 @@
112
116
<fieldsynopsis>
113
117
<modifier>public</modifier>
114
118
<modifier>readonly</modifier>
115
-
<type>string</type>
119
+
<type class="union"><type>string</type><type>null</type></type>
116
120
<varname linkend="domnode.props.localname">localName</varname>
117
121
</fieldsynopsis>
118
122
<fieldsynopsis>
119
123
<modifier>public</modifier>
120
124
<modifier>readonly</modifier>
121
-
<type>string</type>
125
+
<type class="union"><type>string</type><type>null</type></type>
122
126
<varname linkend="domnode.props.baseuri">baseURI</varname>
123
127
</fieldsynopsis>
124
128
<fieldsynopsis>
...
...
@@ -126,8 +130,11 @@
126
130
<type>string</type>
127
131
<varname linkend="domnode.props.textcontent">textContent</varname>
128
132
</fieldsynopsis>
133
+

129
134
<classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
130
-
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.domnode')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[1])" />
135
+
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.domnode')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[@role='DOMNode'])">
136
+
<xi:fallback/>
137
+
</xi:include>
131
138
</classsynopsis>
132
139
<!-- }}} -->
133
140
...
...
@@ -149,8 +156,7 @@
149
156
<para>
150
157
The value of this node, depending on its type.
151
158
Contrary to the W3C specification, the node value of
152
-
<classname>DOMElement</classname> nodes is equal to <link
153
-
linkend="domnode.props.textcontent">DOMNode::textContent</link> instead
159
+
<classname>DOMElement</classname> nodes is equal to <link linkend="domnode.props.textcontent">DOMNode::textContent</link> instead
154
160
of &null;.
155
161
</para>
156
162
</listitem>
...
...
@@ -167,6 +173,12 @@
167
173
<para>The parent of this node. If there is no such node, this returns &null;.</para>
168
174
</listitem>
169
175
</varlistentry>
176
+
<varlistentry xml:id="domnode.props.parentelement">
177
+
<term><varname>parentElement</varname></term>
178
+
<listitem>
179
+
<para>The parent element of this element. If there is no such element, this returns &null;.</para>
180
+
</listitem>
181
+
</varlistentry>
170
182
<varlistentry xml:id="domnode.props.childnodes">
171
183
<term><varname>childNodes</varname></term>
172
184
<listitem>
...
...
@@ -220,10 +232,16 @@
220
232
</para>
221
233
</listitem>
222
234
</varlistentry>
235
+
<varlistentry xml:id="domnode.props.isconnected">
236
+
<term><varname>isConnected</varname></term>
237
+
<listitem>
238
+
<para>Whether the node is connected to a document</para>
239
+
</listitem>
240
+
</varlistentry>
223
241
<varlistentry xml:id="domnode.props.ownerdocument">
224
242
<term><varname>ownerDocument</varname></term>
225
243
<listitem>
226
-
<para>The <classname>DOMDocument</classname> object associated with this node.</para>
244
+
<para>The <classname>DOMDocument</classname> object associated with this node, or &null; if this node is a <classname>DOMDocument</classname></para>
227
245
</listitem>
228
246
</varlistentry>
229
247
<varlistentry xml:id="domnode.props.namespaceuri">
...
...
@@ -235,7 +253,7 @@
235
253
<varlistentry xml:id="domnode.props.prefix">
236
254
<term><varname>prefix</varname></term>
237
255
<listitem>
238
-
<para>The namespace prefix of this node, or &null; if it is unspecified.</para>
256
+
<para>The namespace prefix of this node.</para>
239
257
</listitem>
240
258
</varlistentry>
241
259
<varlistentry xml:id="domnode.props.localname">
...
...
@@ -263,22 +281,8 @@
263
281
</section>
264
282
<!-- }}} -->
265
283

266
-
<!-- {{{ Notes -->
267
-
<section role="notes">
268
-
&reftitle.notes;
269
-
<note>
270
-
<para>
271
-
The DOM extension uses UTF-8 encoding. Use <function>utf8_encode</function>
272
-
and <function>utf8_decode</function> to work with texts in ISO-8859-1
273
-
encoding or <link linkend="ref.iconv">Iconv</link> for other encodings.
274
-
</para>
275
-
</note>
276
-
</section>
277
-
<!-- }}} -->
278
-

279
-
<section role="changelog">
280
-
&reftitle.changelog;
281
-
<para>
284
+
<section role="changelog">
285
+
&reftitle.changelog;
282
286
<informaltable>
283
287
<tgroup cols="2">
284
288
<thead>
...
...
@@ -289,17 +293,33 @@
289
293
</thead>
290
294
<tbody>
291
295
<row>
292
-
<entry>5.6.1</entry>
296
+
<entry>8.3.0</entry>
297
+
<entry>
298
+
Properties <property>DOMNode::$parentElement</property>, and
299
+
<property>DOMNode::$isConnected</property> have been added.
300
+
</entry>
301
+
</row>
302
+
<row>
303
+
<entry>8.0.0</entry>
293
304
<entry>
294
-
The textContent property has been made writable (formerly it has been
295
-
readonly).
305
+
The unimplemented methods <methodname>DOMNode::compareDocumentPosition</methodname>,
306
+
<methodname>DOMNode::isEqualNode</methodname>,
307
+
<methodname>DOMNode::getFeature</methodname>,
308
+
<methodname>DOMNode::setUserData</methodname> and
309
+
<methodname>DOMNode::getUserData</methodname> have been removed.
296
310
</entry>
297
311
</row>
298
312
</tbody>
299
313
</tgroup>
300
314
</informaltable>
301
-
</para>
302
-
</section>
315
+
</section>
316
+

317
+
<!-- {{{ Notes -->
318
+
<section role="notes">
319
+
&reftitle.notes;
320
+
&dom.note.utf8;
321
+
</section>
322
+
<!-- }}} -->
303
323

304
324
<!-- {{{ See also -->
305
325
<section role="seealso">
...
...
@@ -317,7 +337,6 @@
317
337
&reference.dom.entities.domnode;
318
338
319
339
</phpdoc:classref>
320
-
321
340
<!-- Keep this comment at the end of the file
322
341
Local variables:
323
342
mode: sgml
...
...
@@ -338,4 +357,3 @@ vim600: syn=xml fen fdm=syntax fdl=2 si
338
357
vim: et tw=78 syn=sgml
339
358
vi: ts=1 sw=1
340
359
-->
341
-

342
360



Tools (Spanish Manual)