reference/dom/domelement.xml
68d8ee5720470b011af6867062a11f709cf6aaef
68d8ee5720470b011af6867062a11f709cf6aaef
...
...
@@ -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.domelement" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
3
+
<reference xml:id="class.domelement" role="class" 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 DOMElement class</title>
5
5
<titleabbrev>DOMElement</titleabbrev>
6
6
...
...
@@ -21,46 +21,101 @@
21
21
&reftitle.classsynopsis;
22
22
23
23
<!-- {{{ Synopsis -->
24
-
<classsynopsis>
25
-
<ooclass><classname>DOMElement</classname></ooclass>
26
-
27
-
<!-- {{{ Class synopsis -->
28
-
<classsynopsisinfo>
29
-
<ooclass>
30
-
<classname>DOMElement</classname>
31
-
</ooclass>
32
-
33
-
<!-- If the class extends another one, use this -->
34
-
<ooclass>
35
-
<modifier>extends</modifier>
36
-
<classname>DOMNode</classname>
37
-
</ooclass>
38
-
39
-
</classsynopsisinfo>
40
-
<!-- }}} -->
24
+
<classsynopsis class="class">
25
+
<ooclass>
26
+
<classname>DOMElement</classname>
27
+
</ooclass>
28
+
29
+
<ooclass>
30
+
<modifier>extends</modifier>
31
+
<classname>DOMNode</classname>
32
+
</ooclass>
33
+
34
+
<oointerface>
35
+
<modifier>implements</modifier>
36
+
<interfacename>DOMParentNode</interfacename>
37
+
</oointerface>
38
+
39
+
<oointerface>
40
+
<interfacename>DOMChildNode</interfacename>
41
+
</oointerface>
42
+
43
+
<classsynopsisinfo role="comment">&InheritedConstants;</classsynopsisinfo>
44
+
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.domnode')/db:partintro/db:section/db:classsynopsis/db:fieldsynopsis[preceding-sibling::db:classsynopsisinfo[1][@role='comment' and text()='&Constants;']]))">
45
+
<xi:fallback/>
46
+
</xi:include>
41
47
42
48
<classsynopsisinfo role="comment">&Properties;</classsynopsisinfo>
43
-
<!-- If the property is documented below (xml:id=domelement.props) use this -->
44
49
<fieldsynopsis>
50
+
<modifier>public</modifier>
45
51
<modifier>readonly</modifier>
52
+
<type>string</type>
53
+
<varname linkend="domelement.props.tagname">tagName</varname>
54
+
</fieldsynopsis>
55
+
<fieldsynopsis>
56
+
<modifier>public</modifier>
57
+
<type>string</type>
58
+
<varname linkend="domelement.props.classname">className</varname>
59
+
</fieldsynopsis>
60
+
<fieldsynopsis>
61
+
<modifier>public</modifier>
62
+
<type>string</type>
63
+
<varname linkend="domelement.props.id">id</varname>
64
+
</fieldsynopsis>
65
+
<fieldsynopsis>
46
66
<modifier>public</modifier>
47
-
<type>bool</type>
67
+
<modifier>readonly</modifier>
68
+
<type>mixed</type>
48
69
<varname linkend="domelement.props.schematypeinfo">schemaTypeInfo</varname>
49
70
</fieldsynopsis>
50
71
<fieldsynopsis>
72
+
<modifier>public</modifier>
51
73
<modifier>readonly</modifier>
74
+
<type class="union"><type>DOMElement</type><type>null</type></type>
75
+
<varname linkend="domelement.props.firstelementchild">firstElementChild</varname>
76
+
</fieldsynopsis>
77
+
<fieldsynopsis>
52
78
<modifier>public</modifier>
53
-
<type>string</type>
54
-
<varname linkend="domelement.props.tagname">tagName</varname>
79
+
<modifier>readonly</modifier>
80
+
<type class="union"><type>DOMElement</type><type>null</type></type>
81
+
<varname linkend="domelement.props.lastelementchild">lastElementChild</varname>
82
+
</fieldsynopsis>
83
+
<fieldsynopsis>
84
+
<modifier>public</modifier>
85
+
<modifier>readonly</modifier>
86
+
<type>int</type>
87
+
<varname linkend="domelement.props.childelementcount">childElementCount</varname>
88
+
</fieldsynopsis>
89
+
<fieldsynopsis>
90
+
<modifier>public</modifier>
91
+
<modifier>readonly</modifier>
92
+
<type class="union"><type>DOMElement</type><type>null</type></type>
93
+
<varname linkend="domelement.props.previouselementsibling">previousElementSibling</varname>
94
+
</fieldsynopsis>
95
+
<fieldsynopsis>
96
+
<modifier>public</modifier>
97
+
<modifier>readonly</modifier>
98
+
<type class="union"><type>DOMElement</type><type>null</type></type>
99
+
<varname linkend="domelement.props.nextelementsibling">nextElementSibling</varname>
55
100
</fieldsynopsis>
56
101
102
+
<classsynopsisinfo role="comment">&InheritedProperties;</classsynopsisinfo>
103
+
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.domnode')/db:partintro/db:section/db:classsynopsis/db:fieldsynopsis[preceding-sibling::db:classsynopsisinfo[1][@role='comment' and text()='&Properties;']]))">
104
+
<xi:fallback/>
105
+
</xi:include>
106
+
57
107
<classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
58
-
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.domelement')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[1])" />
108
+
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.domelement')/db:refentry/db:refsect1[@role='description']/descendant::db:constructorsynopsis[@role='DOMElement'])">
109
+
<xi:fallback/>
110
+
</xi:include>
111
+
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.domelement')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[@role='DOMElement'])">
112
+
<xi:fallback/>
113
+
</xi:include>
59
114
60
-
<!-- Again, if the class extends a class use this -->
61
115
<classsynopsisinfo role="comment">&InheritedMethods;</classsynopsisinfo>
62
-
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.domnode')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[1])" />
63
-
116
+
<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'])">
117
+
<xi:fallback/>
118
+
</xi:include>
64
119
</classsynopsis>
65
120
<!-- }}} -->
66
121
...
...
@@ -70,6 +125,36 @@
70
125
<section xml:id="domelement.props">
71
126
&reftitle.properties;
72
127
<variablelist>
128
+
<varlistentry xml:id="domelement.props.childelementcount">
129
+
<term><varname>childElementCount</varname></term>
130
+
<listitem>
131
+
<para>The number of child elements.</para>
132
+
</listitem>
133
+
</varlistentry>
134
+
<varlistentry xml:id="domelement.props.firstelementchild">
135
+
<term><varname>firstElementChild</varname></term>
136
+
<listitem>
137
+
<para>First child element or &null;.</para>
138
+
</listitem>
139
+
</varlistentry>
140
+
<varlistentry xml:id="domelement.props.lastelementchild">
141
+
<term><varname>lastElementChild</varname></term>
142
+
<listitem>
143
+
<para>Last child element or &null;.</para>
144
+
</listitem>
145
+
</varlistentry>
146
+
<varlistentry xml:id="domelement.props.nextelementsibling">
147
+
<term><varname>nextElementSibling</varname></term>
148
+
<listitem>
149
+
<para>The next sibling element or &null;.</para>
150
+
</listitem>
151
+
</varlistentry>
152
+
<varlistentry xml:id="domelement.props.previouselementsibling">
153
+
<term><varname>previousElementSibling</varname></term>
154
+
<listitem>
155
+
<para>The previous sibling element or &null;.</para>
156
+
</listitem>
157
+
</varlistentry>
73
158
<varlistentry xml:id="domelement.props.schematypeinfo">
74
159
<term><varname>schemaTypeInfo</varname></term>
75
160
<listitem>
...
...
@@ -82,20 +167,68 @@
82
167
<para>The element name</para>
83
168
</listitem>
84
169
</varlistentry>
170
+
<varlistentry xml:id="domelement.props.classname">
171
+
<term><varname>className</varname></term>
172
+
<listitem>
173
+
<para>A string representing the classes of the element separated by spaces.</para>
174
+
</listitem>
175
+
</varlistentry>
176
+
<varlistentry xml:id="domelement.props.id">
177
+
<term><varname>id</varname></term>
178
+
<listitem>
179
+
<para>Reflects the element ID through the <literal>"id"</literal> attribute.</para>
180
+
</listitem>
181
+
</varlistentry>
85
182
</variablelist>
86
183
</section>
87
184
<!-- }}} -->
88
185
186
+
<section role="changelog">
187
+
&reftitle.changelog;
188
+
<informaltable>
189
+
<tgroup cols="2">
190
+
<thead>
191
+
<row>
192
+
<entry>&Version;</entry>
193
+
<entry>&Description;</entry>
194
+
</row>
195
+
</thead>
196
+
<tbody>
197
+
<row>
198
+
<entry>8.3.0</entry>
199
+
<entry>
200
+
The <varname>className</varname> and <varname>id</varname> properties and
201
+
the <methodname>DOMElement::getAttributeNames</methodname>,
202
+
<methodname>DOMElement::insertAdjacentElement</methodname>,
203
+
<methodname>DOMElement::insertAdjacentText</methodname>, and
204
+
<methodname>DOMElement::toggleAttribute</methodname> methods have been added.
205
+
</entry>
206
+
</row>
207
+
<row>
208
+
<entry>8.0.0</entry>
209
+
<entry>
210
+
The <varname>firstElementChild</varname>, <varname>lastElementChild</varname>,
211
+
<varname>childElementCount</varname>, <varname>previousElementSibling</varname>,
212
+
and <varname>nextElementSibling</varname> properties have been added.
213
+
</entry>
214
+
</row>
215
+
<row>
216
+
<entry>8.0.0</entry>
217
+
<entry>
218
+
<classname>DOMElement</classname> implements
219
+
<interfacename>DOMParentNode</interfacename> and
220
+
<interfacename>DOMChildNode</interfacename> now.
221
+
</entry>
222
+
</row>
223
+
</tbody>
224
+
</tgroup>
225
+
</informaltable>
226
+
</section>
227
+
89
228
<!-- {{{ Notes -->
90
229
<section role="notes">
91
230
&reftitle.notes;
92
-
<note>
93
-
<para>
94
-
The DOM extension uses UTF-8 encoding. Use <function>utf8_encode</function>
95
-
and <function>utf8_decode</function> to work with texts in ISO-8859-1
96
-
encoding or <link linkend="ref.iconv">Iconv</link> for other encodings.
97
-
</para>
98
-
</note>
231
+
&dom.note.utf8;
99
232
</section>
100
233
<!-- }}} -->
101
234
...
...
@@ -116,8 +249,7 @@
116
249
117
250
&reference.dom.entities.domelement;
118
251
119
-
</phpdoc:classref>
120
-
252
+
</reference>
121
253
<!-- Keep this comment at the end of the file
122
254
Local variables:
123
255
mode: sgml
...
...
@@ -138,4 +270,3 @@ vim600: syn=xml fen fdm=syntax fdl=2 si
138
270
vim: et tw=78 syn=sgml
139
271
vi: ts=1 sw=1
140
272
-->
141
-
142
273