admin/doc-fr
1
0
Fork 0
mirror of https://github.com/macintoshplus/doc-fr.git synced 2026-03-28 19:02:10 +01:00
Code Issues Packages Projects Releases Wiki Activity
Files
e8db888c6f5ff14a46a94de0fe1aab89a3c22d60
doc-fr/reference/dom/reference.xml
Yannick Torres 3d20fe648b &php; => PHP 
git-svn-id: https://svn.php.net/repository/phpdoc/fr/trunk@261459 c90b9560-bf6c-de11-be94-00142212c4b1
2008-06-21 20:51:48 +00:00

1353 lines
45 KiB
XML
Raw Blame History

<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.31 $ -->
<!-- EN-Revision: 1.36 Maintainer: yannick Status: ready -->
<!-- Purpose: xml -->
<!-- Membership: bundled, external -->
<!-- Reviewed: yes -->
<reference xml:id="ref.dom" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<title>&Functions; DOM</title>
<partintro>
<section xml:id="dom.intro">
&reftitle.intro;
<para>
L'extension DOM vous permet d'utiliser des documents XML via l'API DOM
de PHP 5.
</para>
<para>
Pour PHP 4, utilisez l'extension <link linkend="ref.domxml">DOM XML</link>.
</para>
<note>
<para>
L'extension DOM utilise l'encodage UTF-8. Utilisez les fonctions
<function>utf8_encode</function> et <function>utf8_decode</function>
pour travailler avec les textes en ISO-8859-1 ou l'extension
<link linkend="ref.iconv">Iconv</link> pour les autres encodages.
</para>
</note>
</section>
<section xml:id="dom.installation">
&reftitle.install;
&no.install;
</section>
<section xml:id='dom.classes'>
&reftitle.classes;
<para>
L'API de ce module suit, autant que possible, les standards <link
xlink:href="&url.dom3.spec;">niveau 3 de DOM</link>.
En conséquent, l'API est pleinement orientée objets. Il est bien d'avoir
les standards DOM sous la main lors de l'utilisation de cette extension.
</para>
<para>
Ce module définit plusieurs classes, qui sont expliquées dans les tableaux suivants.
Les classes avec un équivalent dans les standards sont préfixée par DOM.
</para>
<section xml:id='dom.class.domattr'>
<title><classname>DOMAttr</classname></title>
<para>
Étend <classname>DOMNode</classname>. L'interface
<classname>DOMAttr</classname> représente un attribut dans l'objet
<classname>DOMElement</classname>.
</para>
<section xml:id='dom.class.domattr.constructor'>
&reftitle.constructor;
<itemizedlist>
<listitem>
<para><xref linkend='function.dom-domattr-construct' /> : construit un nouvel objet DOMAttr</para>
</listitem>
</itemizedlist>
</section>
<section xml:id='dom.class.domattr.methods'>
&reftitle.methods;
<itemizedlist>
<listitem>
<para><xref linkend='function.dom-domattr-isid' /> : vérifie si un attribut
est un ID défini</para>
</listitem>
</itemizedlist>
</section>
<section xml:id='dom.class.domattr.properties'>
&reftitle.properties;
<table>
<title/>
<tgroup cols="4">
<thead>
<row>
<entry>Nom</entry>
<entry>Type</entry>
<entry>Lecture seule</entry>
<entry>Description</entry>
</row>
</thead>
<tbody>
<row>
<entry>name</entry>
<entry>string</entry>
<entry>oui</entry>
<entry>Le nom de l'attribut</entry>
</row>
<row>
<entry>ownerElement</entry>
<entry>DOMElement</entry>
<entry>oui</entry>
<entry>L'élément qui contient l'attribut</entry>
</row>
<row>
<entry>schemaTypeInfo</entry>
<entry>bool</entry>
<entry>oui</entry>
<entry>Pas encore implémenté, retourne toujours &null;</entry>
</row>
<row>
<entry>specified</entry>
<entry>bool</entry>
<entry>oui</entry>
<entry>Pas encore implémenté, retourne toujours &null;</entry>
</row>
<row>
<entry>value</entry>
<entry>string</entry>
<entry>non</entry>
<entry>La valeur de l'attribut</entry>
</row>
</tbody>
</tgroup>
</table>
</section>
</section>
<section xml:id='dom.class.domcharacterdata'>
<title><classname>DOMCharacterData</classname></title>
<para>
Étend <classname>DOMNode</classname>.
</para>
<section xml:id='dom.class.domcharacterdata.methods'>
&reftitle.methods;
<itemizedlist>
<listitem>
<para><xref linkend='function.dom-domcharacterdata-appenddata' /> : ajoute une chaîne à la fin des données du noeud</para>
</listitem>
<listitem>
<para><xref linkend='function.dom-domcharacterdata-deletedata' /> : efface une rangée de caractères du noeud</para>
</listitem>
<listitem>
<para><xref linkend='function.dom-domcharacterdata-insertdata' /> : insère une chaîne à une position 16-bit spécifiée</para>
</listitem>
<listitem>
<para><xref linkend='function.dom-domcharacterdata-replacedata' /> : remplace une sous-chaîne d'un noeud DOMCharacterData</para>
</listitem>
<listitem>
<para><xref linkend='function.dom-domcharacterdata-substringdata' /> : extrait
une rangée de données depuis le noeud</para>
</listitem>
</itemizedlist>
</section>
<section xml:id='dom.class.domcharacterdata.properties'>
&reftitle.properties;
<table>
<title/>
<tgroup cols="4">
<thead>
<row>
<entry>Nom</entry>
<entry>Type</entry>
<entry>Lecture seule</entry>
<entry>Description</entry>
</row>
</thead>
<tbody>
<row>
<entry>data</entry>
<entry>string</entry>
<entry>non</entry>
<entry>Le contenu du noeud</entry>
</row>
<row>
<entry>length</entry>
<entry>int</entry>
<entry>oui</entry>
<entry>La longueur du contenu</entry>
</row>
</tbody>
</tgroup>
</table>
</section>
</section>
<section xml:id='dom.class.domcomment'>
<title><classname>DOMComment</classname></title>
<para>
Étend <classname>DOMCharacterData</classname>.
</para>
<section xml:id='dom.class.domcomment.constructor'>
&reftitle.constructor;
<itemizedlist>
<listitem>
<para><xref linkend='function.dom-domcomment-construct' /> : construit un nouvel objet DOMComment</para>
</listitem>
</itemizedlist>
</section>
</section>
<section xml:id='dom.class.domdocument'>
<title><classname>DOMDocument</classname></title>
<para>
Étend <classname>DOMNode</classname>.
</para>
<section xml:id='dom.class.domdocument.constructor'>
&reftitle.constructor;
<itemizedlist>
<listitem>
<para><xref linkend='function.dom-domdocument-construct' /> : construit un nouvel objet DOMDocument</para>
</listitem>
</itemizedlist>
</section>
<section xml:id='dom.class.domdocument.methods'>
&reftitle.methods;
<itemizedlist>
<listitem>
<para><xref linkend='function.dom-domdocument-createattribute' /> : crée un nouvel attribut</para>
</listitem>
<listitem>
<para><xref linkend='function.dom-domdocument-createattributens' /> : crée un nouvel noeud d'attribut avec un espace de nom associé</para>
</listitem>
<listitem>
<para><xref linkend='function.dom-domdocument-createcdatasection' /> : crée un nouveau noeud cdata</para>
</listitem>
<listitem>
<para><xref linkend='function.dom-domdocument-createcomment' /> : crée un nouveau noeud de commentaire</para>
</listitem>
<listitem>
<para><xref linkend='function.dom-domdocument-createdocumentfragment' /> : crée un nouveau fragment de document</para>
</listitem>
<listitem>
<para><xref linkend='function.dom-domdocument-createelement' /> : crée un nouvel élément</para>
</listitem>
<listitem>
<para><xref linkend='function.dom-domdocument-createelementns' /> : crée un nouvel élément avec un espace de noms associé</para>
</listitem>
<listitem>
<para><xref linkend='function.dom-domdocument-createentityreference' /> : crée une nouvelle entité de référence</para>
</listitem>
<listitem>
<para><xref linkend='function.dom-domdocument-createprocessinginstruction' /> : crée un nouveau noeud PI</para>
</listitem>
<listitem>
<para><xref linkend='function.dom-domdocument-createtextnode' /> : crée un nouveau noeud de texte</para>
</listitem>
<listitem>
<para><xref linkend='function.dom-domdocument-getelementbyid' /> : recherche un élément avec un ID précis</para>
</listitem>
<listitem>
<para><xref linkend='function.dom-domdocument-getelementsbytagname' /> : recherche tous les éléments ayant un tag portant un nom donné</para>
</listitem>
<listitem>
<para><xref linkend='function.dom-domdocument-getelementsbytagnamens' /> : recherche tous les éléments ayant un tag portant un nom donné dans un espace de noms spécifié</para>
</listitem>
<listitem>
<para><xref linkend='function.dom-domdocument-importnode' /> : importe un noeud dans le document courant</para>
</listitem>
<listitem>
<para><xref linkend='function.dom-domdocument-load' /> : charge du XML depuis un fichier</para>
</listitem>
<listitem>
<para><xref linkend='function.dom-domdocument-loadhtml' /> : charge du HTML depuis une chaîne de caractères</para>
</listitem>
<listitem>
<para><xref linkend='function.dom-domdocument-loadhtmlfile' /> : charge du HTML depuis un fichier</para>
</listitem>
<listitem>
<para><xref linkend='function.dom-domdocument-loadxml' /> : charge du XML depuis une chaîne de caractères</para>
</listitem>
<listitem>
<para><xref linkend='function.dom-domdocument-normalizedocument' /> : normalise un document</para>
</listitem>
<listitem>
<para><xref linkend='function.dom-domdocument-relaxngvalidate' /> : effectue une validation relaxNG sur le document</para>
</listitem>
<listitem>
<para><xref linkend='function.dom-domdocument-relaxngvalidatesource' /> : effectue une validation relaxNG sur le document</para>
</listitem>
<listitem>
<para><xref linkend='function.dom-domdocument-registernodeclass' /> : enregistre une classe étendue utilisée
pour créer un type d'un noeud de base (non standard DOM)</para>
</listitem>
<listitem>
<para><xref linkend='function.dom-domdocument-save' /> : sauvegarde l'arbre interne XML dans un fichier</para>
</listitem>
<listitem>
<para><xref linkend='function.dom-domdocument-savehtml' /> : sauvegarde le document interne dans une chaîne de caractères en utilisant un formatage HTML</para>
</listitem>
<listitem>
<para><xref linkend='function.dom-domdocument-savehtmlfile' /> : sauvegarde le document interne dans un fichier en utilisant un formatage HTML</para>
</listitem>
<listitem>
<para><xref linkend='function.dom-domdocument-savexml' /> : sauvegarde l'arbre interne XML dans une chaîne de caractères</para>
</listitem>
<listitem>
<para><xref linkend='function.dom-domdocument-schemavalidate' /> : valide un document basé sur un schéma</para>
</listitem>
<listitem>
<para><xref linkend='function.dom-domdocument-schemavalidatesource' /> : valide un document basé sur un schéma</para>
</listitem>
<listitem>
<para><xref linkend='function.dom-domdocument-validate' /> : valide un document en se basant sur sa DTD</para>
</listitem>
<listitem>
<para><xref linkend='function.dom-domdocument-xinclude' /> : remplace les XIncludes dans un objet DOMDocument</para>
</listitem>
</itemizedlist>
</section>
<section xml:id='dom.class.domdocument.properties'>
&reftitle.properties;
<table>
<title/>
<tgroup cols="4">
<thead>
<row>
<entry>Nom</entry>
<entry>Type</entry>
<entry>Lecture seule</entry>
<entry>Description</entry>
</row>
</thead>
<tbody>
<row>
<entry>actualEncoding</entry>
<entry>string</entry>
<entry>oui</entry>
<entry></entry>
</row>
<row>
<entry>config</entry>
<entry>DOMConfiguration</entry>
<entry>oui</entry>
<entry></entry>
</row>
<row>
<entry>doctype</entry>
<entry>DOMDocumentType</entry>
<entry>oui</entry>
<entry>
La déclaration de type de document associée avec ce document.
</entry>
</row>
<row>
<entry>documentElement</entry>
<entry>DOMElement</entry>
<entry>oui</entry>
<entry>
C'est un attribut de convenance qui permet l'accès direct à l'enfant
d'un noeud qui est l'élément document de ce document.
</entry>
</row>
<row>
<entry>documentURI</entry>
<entry>string</entry>
<entry>non</entry>
<entry>
La localisation du document ou &null; si non défini.
</entry>
</row>
<row>
<entry>encoding</entry>
<entry>string</entry>
<entry>non</entry>
<entry></entry>
</row>
<row>
<entry>formatOutput</entry>
<entry>bool</entry>
<entry>non</entry>
<entry></entry>
</row>
<row>
<entry>implementation</entry>
<entry>DOMImplementation</entry>
<entry>oui</entry>
<entry>
L'objet <classname>DOMImplementation</classname> qui représente
ce document.
</entry>
</row>
<row>
<entry>preserveWhiteSpace</entry>
<entry>bool</entry>
<entry>non</entry>
<entry>Ne pas supprimer les espaces redondants. Vaut &true; par défaut.</entry>
</row>
<row>
<entry>recover</entry>
<entry>bool</entry>
<entry>non</entry>
<entry></entry>
</row>
<row>
<entry>resolveExternals</entry>
<entry>bool</entry>
<entry>non</entry>
<entry>
Définir à &true; pour charger les entités externes depuis une déclaration doctype.
Ceci est utile pour inclure des entités correspondant à des caractères dans
vos documents XML.
</entry>
</row>
<row>
<entry>standalone</entry>
<entry>bool</entry>
<entry>non</entry>
<entry></entry>
</row>
<row>
<entry>strictErrorChecking</entry>
<entry>bool</entry>
<entry>non</entry>
<entry>Envoie une DOMException en cas d'erreur. Vaut par défaut &true;.</entry>
</row>
<row>
<entry>substituteEntities</entry>
<entry>bool</entry>
<entry>non</entry>
<entry></entry>
</row>
<row>
<entry>validateOnParse</entry>
<entry>bool</entry>
<entry>non</entry>
<entry>Charge et valide à nouveau la DTD. Vaut par défaut &false;.</entry>
</row>
<row>
<entry>version</entry>
<entry>string</entry>
<entry>non</entry>
<entry></entry>
</row>
<row>
<entry>xmlEncoding</entry>
<entry>string</entry>
<entry>oui</entry>
<entry>
Un attribut spécifiant, en tant que partie de la déclaration XML, l'encodage
de ce document. Il vaut &null; lorsqu'il n'et pas spécifié ou lorsqu'il
n'est pas connu, par exemple, lorsque le document a été créé en mémoire.
</entry>
</row>
<row>
<entry>xmlStandalone</entry>
<entry>bool</entry>
<entry>non</entry>
<entry>
Un attribut spécifiant, en tant que partie de la déclaration XML,
si oui ou non le document est autonome. Il vaut &false; si non spécifié.
</entry>
</row>
<row>
<entry>xmlVersion</entry>
<entry>string</entry>
<entry>non</entry>
<entry>
Un attribut spécifiant, en tant que partie de la déclaration XML, le numéro
de version de ce document. S'il n'y a pas de déclaration et si le document
supporte la fonctionnalité "XML", la valeur sera "1.0".
</entry>
</row>
</tbody>
</tgroup>
</table>
</section>
</section>
<section xml:id='dom.class.domdocumentfragment'>
<title><classname>DOMDocumentFragment</classname></title>
<para>
Étend <classname>DOMNode</classname>.
</para>
<section xml:id='dom.class.domdocumentfragment.methods'>
&reftitle.methods;
<itemizedlist>
<listitem>
<para><xref linkend='function.dom-domdocumentfragment-appendxml' /> -
Ajoute des données raw XML (non standard DOM)</para>
</listitem>
</itemizedlist>
</section>
</section>
<section xml:id='dom.class.domdocumenttype'>
<title><classname>DOMDocumentType</classname></title>
<para>
Étend <classname>DOMNode</classname>
</para>
<para>
Chaque <classname>DOMDocument</classname> a un attribut
<literal>doctype</literal> de valeur soit &null;, soit un objet
<classname>DOMDocumentType</classname>.
</para>
<section xml:id='dom.class.domdocumenttype.properties'>
&reftitle.properties;
<table>
<title/>
<tgroup cols="4">
<thead>
<row>
<entry>Nom</entry>
<entry>Type</entry>
<entry>Lecture seule</entry>
<entry>Description</entry>
</row>
</thead>
<tbody>
<row>
<entry>publicId</entry>
<entry>string</entry>
<entry>oui</entry>
<entry>L'identifiant public du sous-ensemble externe.</entry>
</row>
<row>
<entry>systemId</entry>
<entry>string</entry>
<entry>oui</entry>
<entry>L'identifiant système du sous-ensemble externe. Il peut être
une URI absolue ou non.</entry>
</row>
<row>
<entry>name</entry>
<entry>string</entry>
<entry>oui</entry>
<entry>Le nom de la DTD ; i.e. le nom suivant immédiatement le mot clé
<literal>DOCTYPE</literal></entry>
</row>
<row>
<entry>entities</entry>
<entry>DOMNamedNodeMap</entry>
<entry>oui</entry>
<entry>
Un <classname>DOMNamedNodeMap</classname> contenant
les entités générales, externes et internes, déclarées dans la DTD.
</entry>
</row>
<row>
<entry>notations</entry>
<entry>DOMNamedNodeMap</entry>
<entry>oui</entry>
<entry>
Un <classname>DOMNamedNodeMap</classname> contenant
les notations déclarées dans la DTD.
</entry>
</row>
<row>
<entry>internalSubset</entry>
<entry>string</entry>
<entry>oui</entry>
<entry>
Le sous-ensemble interne en tant que chaîne de caractères ou &null; s'il
n'y en a pas. Ceci ne contient pas les crochets de délimitation.
</entry>
</row>
</tbody>
</tgroup>
</table>
</section>
</section>
<section xml:id='dom.class.domelement'>
<title><classname>DOMElement</classname></title>
<para>
Étend <classname>DOMNode</classname>.
</para>
<section xml:id='dom.class.domelement.constructor'>
&reftitle.constructor;
<itemizedlist>
<listitem>
<para><xref linkend='function.dom-domelement-construct' /> : construit un nouvel objet DOMElement</para>
</listitem>
</itemizedlist>
</section>
<section xml:id='dom.class.domelement.methods'>
&reftitle.methods;
<itemizedlist>
<listitem>
<para><xref linkend='function.dom-domelement-getattribute' /> : retourne la valeur d'un attribut</para>
</listitem>
<listitem>
<para><xref linkend='function.dom-domelement-getattributenode' /> : retourne le noeud d'un attribut</para>
</listitem>
<listitem>
<para><xref linkend='function.dom-domelement-getattributenodens' /> : retourne le noeud d'un attribut</para>
</listitem>
<listitem>
<para><xref linkend='function.dom-domelement-getattributens' /> : retourne la valeur d'un attribut</para>
</listitem>
<listitem>
<para><xref linkend='function.dom-domelement-getelementsbytagname' /> : récupère les éléments par le nom de leurs balises</para>
</listitem>
<listitem>
<para><xref linkend='function.dom-domelement-getelementsbytagnamens' /> : récupère les éléments par leur namespaceURI et leur localName</para>
</listitem>
<listitem>
<para><xref linkend='function.dom-domelement-hasattribute' /> : vérifie si un attribut existe</para>
</listitem>
<listitem>
<para><xref linkend='function.dom-domelement-hasattributens' /> : vérifie si un attribut existe</para>
</listitem>
<listitem>
<para><xref linkend='function.dom-domelement-removeattribute' /> : supprime un attribut</para>
</listitem>
<listitem>
<para><xref linkend='function.dom-domelement-removeattributenode' /> : supprime un attribut</para>
</listitem>
<listitem>
<para><xref linkend='function.dom-domelement-removeattributens' /> : supprime un attribut</para>
</listitem>
<listitem>
<para><xref linkend='function.dom-domelement-setattribute' /> : ajoute un nouvel attribut</para>
</listitem>
<listitem>
<para><xref linkend='function.dom-domelement-setattributenode' /> : ajoute un nouvel attribut à un élément</para>
</listitem>
<listitem>
<para><xref linkend='function.dom-domelement-setattributenodens' /> : ajoute un nouvel attribut à un élément</para>
</listitem>
<listitem>
<para><xref linkend='function.dom-domelement-setattributens' /> : ajoute un nouvel attribut</para>
</listitem>
<listitem>
<para><xref linkend='function.dom-domelement-setidattribute' /> : déclare l'attribut ID</para>
</listitem>
<listitem>
<para><xref linkend='function.dom-domelement-setidattributenode' /> : déclare l'attribut ID</para>
</listitem>
<listitem>
<para><xref linkend='function.dom-domelement-setidattributens' /> : déclare l'attribut ID</para>
</listitem>
</itemizedlist>
</section>
<section xml:id='dom.class.domelement.properties'>
&reftitle.properties;
<table>
<title/>
<tgroup cols="4">
<thead>
<row>
<entry>Nom</entry>
<entry>Type</entry>
<entry>Lecture seule</entry>
<entry>Description</entry>
</row>
</thead>
<tbody>
<row>
<entry>schemaTypeInfo</entry>
<entry>bool</entry>
<entry>oui</entry>
<entry>Pas encore implémenté, retourne toujours &null;</entry>
</row>
<row>
<entry>tagName</entry>
<entry>string</entry>
<entry>oui</entry>
<entry>Le nom de l'élément</entry>
</row>
</tbody>
</tgroup>
</table>
</section>
</section>
<section xml:id='dom.class.domentity'>
<title><classname>DOMEntity</classname></title>
<para>
Étend <classname>DOMNode</classname>
</para>
<para>
Cette interface représente une entité connue, analysée ou non, du document XML.
</para>
<section xml:id='dom.class.domentity.properties'>
&reftitle.properties;
<table>
<title/>
<tgroup cols="4">
<thead>
<row>
<entry>Nom</entry>
<entry>Type</entry>
<entry>Lecture seule</entry>
<entry>Description</entry>
</row>
</thead>
<tbody>
<row>
<entry>publicId</entry>
<entry>string</entry>
<entry>oui</entry>
<entry>
L'identifiant public associé à l'entité si spécifiée, &null; sinon.
</entry>
</row>
<row>
<entry>systemId</entry>
<entry>string</entry>
<entry>oui</entry>
<entry>
L'identifiant système associé à l'entité si spécifiée, &null; sinon.
Ceci peut être une URI absolue ou non.
</entry>
</row>
<row>
<entry>notationName</entry>
<entry>string</entry>
<entry>oui</entry>
<entry>
Pour les entités non-analysées, le nom de la notation pour cette entité.
Pour les entités analysées, ceci vaut &null;.
</entry>
</row>
<row>
<entry>actualEncoding</entry>
<entry>string</entry>
<entry>non</entry>
<entry>
Un attribut spécifiant l'encodage utilisé pour cette entité au moment
de l'analyse, lorsque c'est une entité analysée externe. Ceci vaut &null;
si c'est une entité du sous-ensemble externe ou si elle n'est pas connue.
</entry>
</row>
<row>
<entry>encoding</entry>
<entry>string</entry>
<entry>oui</entry>
<entry>
Un attribut spécifiant, en tant que partie de la déclaration texte, l'encodage
de cette entité, lorsque c'est une entité analysée externe. Ceci vaut
&null; sinon.
</entry>
</row>
<row>
<entry>version</entry>
<entry>string</entry>
<entry>oui</entry>
<entry>
Un attribut spécifiant, en tant que partie de la déclaration texte, le
numéro de version de cette entité, lorsque c'est une entité analysée externe.
Ceci vaut &null; sinon.
</entry>
</row>
</tbody>
</tgroup>
</table>
</section>
</section>
<section xml:id='dom.class.domentityreference'>
<title><classname>DOMEntityReference</classname></title>
<para>
Étend <classname>DOMNode</classname>.
</para>
<section xml:id='dom.class.domentityreference.constructor'>
&reftitle.constructor;
<itemizedlist>
<listitem>
<para><xref linkend='function.dom-domentityreference-construct' /> : construit un nouvel objet DOMEntityReference</para>
</listitem>
</itemizedlist>
</section>
</section>
<section xml:id='dom.class.domexception'>
<title><classname>DOMException</classname></title>
<para>
Les opérations DOM lancent des exceptions sous des circonstances particulières, i.e.,
lorsqu'une opération est impossible à effectuer pour des raisons de logique.
</para>
<para>
Voir aussi <xref linkend="language.exceptions"/>.
</para>
<section xml:id='dom.class.domexception.properties'>
&reftitle.properties;
<table>
<title/>
<tgroup cols="4">
<thead>
<row>
<entry>Nom</entry>
<entry>Type</entry>
<entry>Lecture seule</entry>
<entry>Description</entry>
</row>
</thead>
<tbody>
<row>
<entry>code</entry>
<entry>int</entry>
<entry>oui</entry>
<entry>Un entier indiquant le type d'erreur générée</entry>
</row>
</tbody>
</tgroup>
</table>
</section>
</section>
<section xml:id='dom.class.domimplementation'>
<title><classname>DOMImplementation</classname></title>
<para>
L'interface <classname>DOMImplementation</classname> fournit un nombre
de méthodes pour effectuer des opérations qui sont indépendantes de toute instance
du model objet du document.
</para>
<section xml:id='dom.class.domimplementation.constructor'>
&reftitle.constructor;
<itemizedlist>
<listitem>
<para><xref linkend='function.dom-domimplementation-construct' /> : construit un nouvel objet DOMImplementation</para>
</listitem>
</itemizedlist>
</section>
<section xml:id='dom.class.domimplementation.methods'>
&reftitle.methods;
<itemizedlist>
<listitem>
<para><xref linkend='function.dom-domimplementation-createdocument' /> : crée un objet DOM Document du type spécifié avec ces éléments</para>
</listitem>
<listitem>
<para><xref linkend='function.dom-domimplementation-createdocumenttype' /> : crée un objet DOMDocumentType vide</para>
</listitem>
<listitem>
<para><xref linkend='function.dom-domimplementation-hasfeature' /> : Teste si l'implémentation DOM implémente une fonctionnalité spécifique</para>
</listitem>
</itemizedlist>
</section>
</section>
<section xml:id='dom.class.domnamednodemap'>
<title><classname>DOMNamedNodeMap</classname></title>
<section xml:id='dom.class.domnamednodemap.methods'>
&reftitle.methods;
<itemizedlist>
<listitem>
<para><xref linkend='function.dom-domnamednodemap-getnameditem' /> : retrouve un noeud en spécifiant son nom</para>
</listitem>
<listitem>
<para><xref linkend='function.dom-domnamednodemap-getnameditemns' /> : retrouve un noeud en spécifiant un nom local et une URI d'espace de noms</para>
</listitem>
<listitem>
<para><xref linkend='function.dom-domnamednodemap-item' /> : retrouve un noeud en spécifiant son index</para>
</listitem>
</itemizedlist>
</section>
</section>
<section xml:id='dom.class.domnode'>
<title><classname>DOMNode</classname></title>
<section xml:id='dom.class.domnode.methods'>
&reftitle.methods;
<itemizedlist>
<listitem>
<para><xref linkend='function.dom-domnode-appendchild' /> : ajoute un nouvel enfant à la fin des enfants</para>
</listitem>
<listitem>
<para><xref linkend='function.dom-domnode-clonenode' /> : clone un noeud</para>
</listitem>
<listitem>
<para><xref linkend='function.dom-domnode-hasattributes' /> : vérifie si un noeud possède des attributs</para>
</listitem>
<listitem>
<para><xref linkend='function.dom-domnode-haschildnodes' /> : vérifie si un noeud possède des enfants</para>
</listitem>
<listitem>
<para><xref linkend='function.dom-domnode-insertbefore' /> : ajoute un nouvel enfant juste avant un noeud référencé</para>
</listitem>
<listitem>
<para><xref linkend='function.dom-domnode-isdefaultnamespace' /> : vérifie si l'URI de l'espace de noms spécifiée
est l'espace de noms par défaut</para>
</listitem>
<listitem>
<para><xref linkend='function.dom-domnode-issamenode' /> : indique si deux noeuds sont identiques</para>
</listitem>
<listitem>
<para><xref linkend='function.dom-domnode-issupported' /> : vérifie si une fonctionnalité est supportée par une version spécifique</para>
</listitem>
<listitem>
<para><xref linkend='function.dom-domnode-lookupnamespaceuri' /> : retourne l'URI de l'espace de noms du noeud basé sur le préfixe</para>
</listitem>
<listitem>
<para><xref linkend='function.dom-domnode-lookupprefix' /> : retourne le préfixe de l'espace de noms d'un noeud, basé sur l'URI de l'espace de noms</para>
</listitem>
<listitem>
<para><xref linkend='function.dom-domnode-normalize' /> : normalise le noeud</para>
</listitem>
<listitem>
<para><xref linkend='function.dom-domnode-removechild' /> : supprime un enfant de la liste des enfants</para>
</listitem>
<listitem>
<para><xref linkend='function.dom-domnode-replacechild' /> : remplace un enfant</para>
</listitem>
</itemizedlist>
</section>
<section xml:id='dom.class.domnode.properties'>
&reftitle.properties;
<table>
<title/>
<tgroup cols="4">
<thead>
<row>
<entry>Nom</entry>
<entry>Type</entry>
<entry>Lecture seule</entry>
<entry>Description</entry>
</row>
</thead>
<tbody>
<row>
<entry>nodeName</entry>
<entry>string</entry>
<entry>oui</entry>
<entry>Retourne le nom le plus précis possible pour le type de noeud courant</entry>
</row>
<row>
<entry>nodeValue</entry>
<entry>string</entry>
<entry>non</entry>
<entry>La valeur de ce noeud, dépendant de son type.</entry>
</row>
<row>
<entry>nodeType</entry>
<entry>int</entry>
<entry>oui</entry>
<entry>Récupère le type du noeud. Une des constantes XML_xxx_NODE prédéfinies</entry>
</row>
<row>
<entry>parentNode</entry>
<entry>DOMNode</entry>
<entry>oui</entry>
<entry>Le parent de ce noeud</entry>
</row>
<row>
<entry>childNodes</entry>
<entry>DOMNodeList</entry>
<entry>oui</entry>
<entry>
Un <classname>DOMNodeList</classname> qui contient tous les enfants
de ce noeud. S'il n'y a pas d'enfant, ce sera un
<classname>DOMNodeList</classname> vide.
</entry>
</row>
<row>
<entry>firstChild</entry>
<entry>DOMNode</entry>
<entry>oui</entry>
<entry>
Le premier enfant de ce noeud. S'il n'y pas de tel noeud, ceci retourne
&null;.
</entry>
</row>
<row>
<entry>lastChild</entry>
<entry>DOMNode</entry>
<entry>oui</entry>
<entry>
Le dernier enfant de ce noeud. S'il n'y a pas de tel noeud, ceci retourne
&null;.
</entry>
</row>
<row>
<entry>previousSibling</entry>
<entry>DOMNode</entry>
<entry>oui</entry>
<entry>
Le noeud précédent immédiatement ce noeud. S'il n'y a pas de tel noeud,
ceci retourne &null;.
</entry>
</row>
<row>
<entry>nextSibling</entry>
<entry>DOMNode</entry>
<entry>oui</entry>
<entry>
Le noeud suivant immédiatement ce noeud. S'il n'y a pas de tel noeud,
ceci retourne &null;.
</entry>
</row>
<row>
<entry>attributes</entry>
<entry>DOMNamedNodeMap</entry>
<entry>oui</entry>
<entry>
Un <classname>DOMNamedNodeMap</classname> contenant
les attributs de ce noeud (si c'est un <classname>DOMElement</classname>)
ou &null; sinon.
</entry>
</row>
<row>
<entry>ownerDocument</entry>
<entry>DOMDocument</entry>
<entry>oui</entry>
<entry>
Un objet <classname>DOMDocument</classname> associé à ce noeud.
</entry>
</row>
<row>
<entry>namespaceURI</entry>
<entry>string</entry>
<entry>oui</entry>
<entry>L'URI de l'espace de noms de ce noeud, ou &null; si non spécifié.</entry>
</row>
<row>
<entry>prefix</entry>
<entry>string</entry>
<entry>non</entry>
<entry>
Le préfixe de l'espace de noms de ce noeud, ou &null; si non spécifié.
</entry>
</row>
<row>
<entry>localName</entry>
<entry>string</entry>
<entry>oui</entry>
<entry>
Retourne la partie locale du nom qualifié de ce noeud.
</entry>
</row>
<row>
<entry>baseURI</entry>
<entry>string</entry>
<entry>oui</entry>
<entry>
La base absolue de l'URI de ce noeud ou &null; si l'implémentation
n'est pas arrivée à obtenir une URI absolue.
</entry>
</row>
<row>
<entry>textContent</entry>
<entry>string</entry>
<entry>non</entry>
<entry>
Cet attribut retourne le contenu texte de ce noeud et ses descendants.
</entry>
</row>
</tbody>
</tgroup>
</table>
</section>
</section>
<section xml:id='dom.class.domnodelist'>
<title><classname>DOMNodeList</classname></title>
<para>
</para>
<section xml:id='dom.class.domnodelist.methods'>
&reftitle.methods;
<itemizedlist>
<listitem>
<para><xref linkend='function.dom-domnodelist-item' /> : retourne un noeud spécifié par index</para>
</listitem>
</itemizedlist>
</section>
<section xml:id='dom.class.domnodelist.properties'>
&reftitle.properties;
<table>
<title/>
<tgroup cols="4">
<thead>
<row>
<entry>Nom</entry>
<entry>Type</entry>
<entry>Lecture seule</entry>
<entry>Description</entry>
</row>
</thead>
<tbody>
<row>
<entry>length</entry>
<entry>int</entry>
<entry>oui</entry>
<entry>
Le nombre de noeuds dans la liste. La plage des indices des noeuds
enfants valides est de 0 à <literal>length : 1</literal>
inclusivement.
</entry>
</row>
</tbody>
</tgroup>
</table>
</section>
</section>
<section xml:id='dom.class.domnotation'>
<title><classname>DOMNotation</classname></title>
<para>
Étend <classname>DOMNode</classname>
</para>
<section xml:id='dom.class.domnotation.properties'>
&reftitle.properties;
<table>
<title/>
<tgroup cols="4">
<thead>
<row>
<entry>Nom</entry>
<entry>Type</entry>
<entry>Lecture seule</entry>
<entry>Description</entry>
</row>
</thead>
<tbody>
<row>
<entry>publicId</entry>
<entry>string</entry>
<entry>oui</entry>
<entry></entry>
</row>
<row>
<entry>systemId</entry>
<entry>string</entry>
<entry>oui</entry>
<entry></entry>
</row>
</tbody>
</tgroup>
</table>
</section>
</section>
<section xml:id='dom.class.domprocessinginstruction'>
<title><classname>DOMProcessingInstruction</classname></title>
<para>
Étend <classname>DOMNode</classname>.
</para>
<section xml:id='dom.class.domprocessinginstruction.constructor'>
&reftitle.constructor;
<itemizedlist>
<listitem>
<para><xref linkend='function.dom-domprocessinginstruction-construct' /> : construit un nouvel objet DOMProcessingInstruction</para>
</listitem>
</itemizedlist>
</section>
<section xml:id='dom.class.domprocessinginstruction.properties'>
&reftitle.properties;
<table>
<title/>
<tgroup cols="4">
<thead>
<row>
<entry>Nom</entry>
<entry>Type</entry>
<entry>Lecture seule</entry>
<entry>Description</entry>
</row>
</thead>
<tbody>
<row>
<entry>target</entry>
<entry>string</entry>
<entry>oui</entry>
<entry></entry>
</row>
<row>
<entry>data</entry>
<entry>string</entry>
<entry>non</entry>
<entry></entry>
</row>
</tbody>
</tgroup>
</table>
</section>
</section>
<section xml:id='dom.class.domtext'>
<title><classname>DOMText</classname></title>
<para>
Étend <classname>DOMCharacterData</classname>.
</para>
<section xml:id='dom.class.domtext.constructor'>
&reftitle.constructor;
<itemizedlist>
<listitem>
<para><xref linkend='function.dom-domtext-construct' /> : construit un nouvel objet DOMText</para>
</listitem>
</itemizedlist>
</section>
<section xml:id='dom.class.domtext.methods'>
&reftitle.methods;
<itemizedlist>
<listitem>
<para><xref linkend='function.dom-domtext-iswhitespaceinelementcontent' /> : indique si ce noeud de texte contient des espaces</para>
</listitem>
<listitem>
<para><xref linkend='function.dom-domtext-splittext' /> : sépare le noeud en deux noeuds à une position spécifique</para>
</listitem>
</itemizedlist>
</section>
<section xml:id='dom.class.domtext.properties'>
&reftitle.properties;
<table>
<title/>
<tgroup cols="4">
<thead>
<row>
<entry>Nom</entry>
<entry>Type</entry>
<entry>Lecture seule</entry>
<entry>Description</entry>
</row>
</thead>
<tbody>
<row>
<entry>wholeText</entry>
<entry>string</entry>
<entry>oui</entry>
<entry></entry>
</row>
</tbody>
</tgroup>
</table>
</section>
</section>
<section xml:id='dom.class.domxpath'>
<title><classname>DOMXPath</classname></title>
<para>
</para>
<section xml:id='dom.class.domxpath.constructor'>
&reftitle.constructor;
<itemizedlist>
<listitem>
<para><xref linkend='function.dom-domxpath-construct' /> : construit un nouvel objet DOMXPath</para>
</listitem>
</itemizedlist>
</section>
<section xml:id='dom.class.domxpath.methods'>
&reftitle.methods;
<itemizedlist>
<listitem>
<para><xref linkend='function.dom-domxpath-registernamespace' /> : enregistre l'espace de noms avec l'objet DOMXpath</para>
</listitem>
<listitem>
<para><xref linkend='function.dom-domxpath-evaluate' /> : Évalue l'expression XPath donnée et retourne le résultat écrit</para>
</listitem>
<listitem>
<para><xref linkend='function.dom-domxpath-query' /> : Évalue l'expression XPath donnée</para>
</listitem>
</itemizedlist>
</section>
<section xml:id='dom.class.domxpath.properties'>
&reftitle.properties;
<table>
<title/>
<tgroup cols="4">
<thead>
<row>
<entry>Nom</entry>
<entry>Type</entry>
<entry>Lecture seule</entry>
<entry>Description</entry>
</row>
</thead>
<tbody>
<row>
<entry>document</entry>
<entry>DOMDocument</entry>
<entry></entry>
<entry></entry>
</row>
</tbody>
</tgroup>
</table>
</section>
</section>
</section>
<section xml:id="dom.examples">
&reftitle.examples;
<para>
La plupart des exemples de cette référence requièrent un fichier XML.
Nous utiliserons le fichier <filename>book.xml</filename> qui contient ce qui suit :
</para>
<para>
<example>
<title>chapter.xml</title>
<programlisting role="xml">
<![CDATA[
<?xml version="1.0" encoding="iso-8859-1"?>
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
]>
<book id="listing">
<title>My lists</title>
<chapter id="books">
<title>My books</title>
<para>
<informaltable>
<tgroup cols="4">
<thead>
<row>
<entry>Title</entry>
<entry>Author</entry>
<entry>Language</entry>
<entry>ISBN</entry>
</row>
</thead>
<tbody>
<row>
<entry>The Grapes of Wrath</entry>
<entry>John Steinbeck</entry>
<entry>en</entry>
<entry>0140186409</entry>
</row>
<row>
<entry>The Pearl</entry>
<entry>John Steinbeck</entry>
<entry>en</entry>
<entry>014017737X</entry>
</row>
<row>
<entry>Samarcande</entry>
<entry>Amine Maalouf</entry>
<entry>fr</entry>
<entry>2253051209</entry>
</row>
<!-- TODO: I have a lot of remaining books to add.. -->
</tbody>
</tgroup>
</informaltable>
</para>
</chapter>
</book>
]]>
</programlisting>
</example>
</para>
</section>
&reference.dom.constants;
</partintro>
&reference.dom.entities.functions;
</reference>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->
Reference in New Issue View Git Blame Copy Permalink