Skip to content

[Sync-En] dom: document getElementsByClassName() and the cloning failure of node collections #3580

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
lacatoire merged 1 commit into from
Sep 25, 2026
Merged

[Sync-En] dom: document getElementsByClassName() and the cloning failure of node collections #3580

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
29 changes: 26 additions & 3 deletions reference/dom/dom/dom-dtdnamednodemap.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: ae7db14ea8cb8f3041e114f0ef865d86a95f72d6 Maintainer: Fan2Shrek Status: ready -->
<!-- Reviewed: yes -->
<!-- EN-Revision: 38fcf6262ae5eceb1162dc271a510e882b1d4a13 Maintainer: Fan2Shrek Status: ready -->
<reference xml:id="class.dom-dtdnamednodemap" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
<title>La classe Dom\DtdNamedNodeMap</title>
<titleabbrev>Dom\DtdNamedNodeMap</titleabbrev>
Expand All @@ -11,7 +10,9 @@
&reftitle.intro;
<simpara>
Représente une carte de nœuds nommés pour les entités et les nœuds de
<acronym>DTD</acronym>.
<acronym>DTD</acronym>. Elle est similaire à <classname>Dom\NamedNodeMap</classname>,
mais limitée aux nœuds <classname>Dom\Entity</classname> et
<classname>Dom\Notation</classname>.
</simpara>
</section>

Expand Down Expand Up @@ -62,6 +63,28 @@
</variablelist>
</section>

<section role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.5.0</entry>
<entry>
Il n'est plus possible de cloner un objet <classname>Dom\DtdNamedNodeMap</classname>.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</section>

</partintro>

<!-- &reference.dom.dom.entities.dtdnamednodemap; -->
Expand Down
72 changes: 35 additions & 37 deletions reference/dom/dom/dom-element.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 34314b7c6eab4d9b7efabd42154b38fcc5db1fef Maintainer: lacatoire Status: ready -->
<!-- EN-Revision: d4f96dae6e6c07096bb06d187967be50ed13550e Maintainer: lacatoire Status: ready -->
<reference xml:id="class.dom-element" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
<title>La classe Dom\Element</title>
<titleabbrev>Dom\Element</titleabbrev>
Expand Down Expand Up @@ -40,9 +40,7 @@
</oointerface>

<classsynopsisinfo role="comment">&InheritedConstants;</classsynopsisinfo>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.dom-node')/db:partintro/db:section/db:classsynopsis/db:fieldsynopsis[preceding-sibling::db:classsynopsisinfo[1][@role='comment' and text()='&Constants;']]))">
<xi:fallback/>
</xi:include>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.dom-node')/db:partintro/db:section/db:classsynopsis/db:fieldsynopsis[preceding-sibling::db:classsynopsisinfo[1][@role='comment' and text()='&Constants;']]))"/>

<classsynopsisinfo role="comment">&Properties;</classsynopsisinfo>
<fieldsynopsis>
Expand Down Expand Up @@ -144,21 +142,15 @@
</fieldsynopsis>

<classsynopsisinfo role="comment">&InheritedProperties;</classsynopsisinfo>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.dom-node')/db:partintro/db:section/db:classsynopsis/db:fieldsynopsis[preceding-sibling::db:classsynopsisinfo[1][@role='comment' and text()='&Properties;']]))">
<xi:fallback/>
</xi:include>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.dom-node')/db:partintro/db:section/db:classsynopsis/db:fieldsynopsis[preceding-sibling::db:classsynopsisinfo[1][@role='comment' and text()='&Properties;']]))"/>

<classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
<classsynopsisinfo role="comment">Pas encore documenté</classsynopsisinfo>
<!--<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.dom-element')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[@role='Dom\\Element'])">
<xi:fallback/>
</xi:include>-->
<!--<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.dom-element')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[@role='Dom\\Element'])"/>-->

<classsynopsisinfo role="comment">&InheritedMethods;</classsynopsisinfo>
<classsynopsisinfo role="comment">Pas encore documenté</classsynopsisinfo>
<!--<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.dom-node')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[@role='Dom\\Node'])">
<xi:fallback/>
</xi:include>-->
<!--<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.dom-node')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[@role='Dom\\Node'])"/>-->
</classsynopsis>
</section>

Expand Down Expand Up @@ -190,9 +182,7 @@
</listitem>
</varlistentry>
<varlistentry xml:id="dom-element.props.classname">
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('domelement.props.classname')/*)">
<xi:fallback/>
</xi:include>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('domelement.props.classname')/*)"/>
</varlistentry>
<varlistentry xml:id="dom-element.props.classlist">
<term><varname>classList</varname></term>
Expand All @@ -213,39 +203,25 @@
</listitem>
</varlistentry>
<varlistentry xml:id="dom-element.props.id">
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('domelement.props.id')/*)">
<xi:fallback/>
</xi:include>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('domelement.props.id')/*)"/>
</varlistentry>
<varlistentry xml:id="dom-element.props.firstelementchild">
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('domelement.props.firstelementchild')/*)">
<xi:fallback/>
</xi:include>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('domelement.props.firstelementchild')/*)"/>
</varlistentry>
<varlistentry xml:id="dom-element.props.lastelementchild">
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('domelement.props.lastelementchild')/*)">
<xi:fallback/>
</xi:include>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('domelement.props.lastelementchild')/*)"/>
</varlistentry>
<varlistentry xml:id="dom-element.props.childelementcount">
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('domelement.props.childelementcount')/*)">
<xi:fallback/>
</xi:include>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('domelement.props.childelementcount')/*)"/>
</varlistentry>
<varlistentry xml:id="dom-element.props.previouselementsibling">
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('domelement.props.previouselementsibling')/*)">
<xi:fallback/>
</xi:include>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('domelement.props.previouselementsibling')/*)"/>
</varlistentry>
<varlistentry xml:id="dom-element.props.nextelementsibling">
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('domelement.props.nextelementsibling')/*)">
<xi:fallback/>
</xi:include>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('domelement.props.nextelementsibling')/*)"/>
</varlistentry>
<varlistentry xml:id="dom-element.props.children">
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('dom-parentnode.props.children')/*)">
<xi:fallback/>
</xi:include>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('dom-parentnode.props.children')/*)"/>
</varlistentry>
<varlistentry xml:id="dom-element.props.innerhtml">
<term><varname>innerHTML</varname></term>
Expand All @@ -271,6 +247,28 @@
</variablelist>
</section>

<section role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.5.0</entry>
<entry>
Ajout de la méthode <methodname>Dom\Element::getElementsByClassName</methodname>.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</section>

<section role="notes">
&reftitle.notes;
&dom.note.modern.utf8;
Expand Down
29 changes: 26 additions & 3 deletions reference/dom/dom/dom-htmlcollection.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: ae7db14ea8cb8f3041e114f0ef865d86a95f72d6 Maintainer: Fan2Shrek Status: ready -->
<!-- Reviewed: yes -->
<!-- EN-Revision: 38fcf6262ae5eceb1162dc271a510e882b1d4a13 Maintainer: Fan2Shrek Status: ready -->
<reference xml:id="class.dom-htmlcollection" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
<title>La classe Dom\HTMLCollection</title>
<titleabbrev>Dom\HTMLCollection</titleabbrev>
Expand All @@ -10,7 +9,9 @@
<section xml:id="dom-htmlcollection.intro">
&reftitle.intro;
<simpara>
Représente un ensemble statique d'éléments.
Représente un ensemble statique d'éléments. Elle est similaire à
<classname>Dom\NodeList</classname>, mais limitée aux nœuds
<classname>Dom\Element</classname>.
</simpara>
</section>

Expand Down Expand Up @@ -59,6 +60,28 @@
</variablelist>
</section>

<section role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.5.0</entry>
<entry>
Il n'est plus possible de cloner un objet <classname>Dom\HTMLCollection</classname>.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</section>

<section role="notes">
&reftitle.notes;
&dom.note.modern.utf8;
Expand Down
29 changes: 26 additions & 3 deletions reference/dom/dom/dom-namednodemap.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: ae7db14ea8cb8f3041e114f0ef865d86a95f72d6 Maintainer: Fan2Shrek Status: ready -->
<!-- Reviewed: yes -->
<!-- EN-Revision: 38fcf6262ae5eceb1162dc271a510e882b1d4a13 Maintainer: Fan2Shrek Status: ready -->
<reference xml:id="class.dom-namednodemap" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
<title>La classe Dom\NamedNodeMap</title>
<titleabbrev>Dom\NamedNodeMap</titleabbrev>
Expand All @@ -10,7 +9,9 @@
<section xml:id="dom-namednodemap.intro">
&reftitle.intro;
<simpara>
Représente l'ensemble des attributs sur un élément.
Représente l'ensemble des attributs sur un élément. Ceci est l'équivalent
moderne et conforme aux spécifications de
<classname>DOMNamedNodeMap</classname>.
</simpara>
</section>

Expand Down Expand Up @@ -59,6 +60,28 @@
</variablelist>
</section>

<section role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.5.0</entry>
<entry>
Il n'est plus possible de cloner un objet <classname>Dom\NamedNodeMap</classname>.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</section>

<section role="notes">
&reftitle.notes;
&dom.note.modern.utf8;
Expand Down
37 changes: 26 additions & 11 deletions reference/dom/dom/dom-nodelist.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,16 +1,13 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: ae7db14ea8cb8f3041e114f0ef865d86a95f72d6 Maintainer: Fan2Shrek Status: ready -->
<!-- Reviewed: yes -->
<!-- EN-Revision: 38fcf6262ae5eceb1162dc271a510e882b1d4a13 Maintainer: Fan2Shrek Status: ready -->
<reference xml:id="class.dom-nodelist" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
<title>La classe <classname>Dom\NodeList</classname></title>
<titleabbrev>Dom\NodeList</titleabbrev>

<partintro>

<section xml:id="dom-nodelist.intro">
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('domnodelist.intro')/*)">
<xi:fallback/>
</xi:include>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('domnodelist.intro')/*)"/>
<simpara>
Ceci est l'équivalent moderne et conforme aux spécifications de
<classname>DOMNodeList</classname>.
Expand Down Expand Up @@ -43,22 +40,40 @@

<classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
<classsynopsisinfo role="comment">Pas encore documenté</classsynopsisinfo>
<!--<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.dom-nodelist')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[@role='Dom\\NodeList'])">
<xi:fallback/>
</xi:include>-->
<!--<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.dom-nodelist')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[@role='Dom\\NodeList'])"/>-->
</classsynopsis>
</section>

<section xml:id="dom-nodelist.props">
&reftitle.properties;
<variablelist>
<varlistentry xml:id="dom-nodelist.props.length">
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('domnodelist.props.length')/*)">
<xi:fallback/>
</xi:include>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('domnodelist.props.length')/*)"/>
</varlistentry>
</variablelist>
</section>

<section role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.5.0</entry>
<entry>
Il n'est plus possible de cloner un objet <classname>Dom\NodeList</classname>.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</section>
</partintro>

<!-- &reference.dom.dom.entities.nodelist; -->
Expand Down
14 changes: 8 additions & 6 deletions reference/dom/domnamednodemap.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,7 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 2352068d5585a13365f23605208ba872f7512363 Maintainer: yannick Status: ready -->
<!-- Reviewed: no -->
<!-- CREDITS: DAnnebicque -->
<!-- EN-Revision: 38fcf6262ae5eceb1162dc271a510e882b1d4a13 Maintainer: yannick Status: ready -->
<reference xml:id="class.domnamednodemap" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
<title>&class.theclass; <classname>DOMNamedNodeMap</classname></title>
<titleabbrev>DOMNamedNodeMap</titleabbrev>
Expand Down Expand Up @@ -36,9 +34,7 @@
</fieldsynopsis>

<classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.domnamednodemap')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[@role='DOMNamedNodeMap'])">
<xi:fallback/>
</xi:include>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.domnamednodemap')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[@role='DOMNamedNodeMap'])"/>
</classsynopsis>
<!-- }}} -->

Expand Down Expand Up @@ -73,6 +69,12 @@
</row>
</thead>
<tbody>
<row>
<entry>8.5.0</entry>
<entry>
Il n'est plus possible de cloner un objet <classname>DOMNamedNodeMap</classname>.
</entry>
</row>
<row>
<entry>8.0.0</entry>
<entry>
Expand Down
Loading
Loading