<?xml version="1.0" encoding="utf-8"?>

<refentry xml:id="domnode.insertbefore" xmlns="http://docbook.org/ns/docbook">

<refnamediv>

<refname>DOMNode::insertBefore</refname>

<refpurpose>

Ajoute un nouveau fils avant un nœud de référence.

</refpurpose>

</refnamediv>

<refsect1 role="description">

&reftitle.description;

<methodsynopsis role="DOMNode">

<modifier>public</modifier> <type class="union"><type>DOMNode</type><type>false</type></type><methodname>DOMNode::insertBefore</methodname>

<methodparam><type>DOMNode</type><parameter>node</parameter></methodparam>

<methodparam choice="opt"><type class="union"><type>DOMNode</type><type>null</type></type><parameter>child</parameter><initializer>&null;</initializer></methodparam>

</methodsynopsis>

<para>

Cette fonction insère un nouveau nœud juste avant le nœud de référence.

Si l'on compte faire des modifications plus tard sur l'enfant ajouté, il faut

utiliser le nœud retourné.

</para>

<para>

Lors de l'utilisation d'un nœud existant, il sera déplacé.

</para>

</refsect1>

<refsect1 role="parameters">

&reftitle.parameters;

<para>

<variablelist>

<varlistentry>

<term><parameter>node</parameter></term>

<listitem>

<para>

Le nouveau nœud.

</para>

</listitem>

</varlistentry>

<varlistentry>

<term><parameter>child</parameter></term>

<listitem>

<para>

Le nœud référencé. Si non spécifié, <parameter>node</parameter>

sera ajouté aux fils.

</para>

</listitem>

</varlistentry>

</variablelist>

</para>

</refsect1>

<refsect1 role="returnvalues">

&reftitle.returnvalues;

<para>

Le nœud inséré ou &false; en cas d'erreur.

</para>

</refsect1>

<refsect1 role="errors">

&reftitle.errors;

<simpara>

Peut lancer une <exceptionname>DOMException</exceptionname> avec les

codes d'erreur suivants :

</simpara>

<para>

<variablelist>

<varlistentry>

<term><constant>DOM_NO_MODIFICATION_ALLOWED_ERR</constant></term>

<listitem>

<para>

Levé si le nœud est en lecture seule ou si le parent précédent le nœud à

insérer est en lecture seule.

</para>

</listitem>

</varlistentry>

<varlistentry>

<term><constant>DOM_HIERARCHY_REQUEST_ERR</constant></term>

<listitem>

<para>

Levé si ce nœud est d'un type qui n'autorise pas de fils du type du nœud

<parameter>node</parameter>, ou si le nœud à ajouter est un des ancêtres

de ce nœud ou ce nœud lui-même.

</para>

</listitem>

</varlistentry>

<varlistentry>

<term><constant>DOM_WRONG_DOCUMENT_ERR</constant></term>

<listitem>

<para>

Levé si <parameter>node</parameter> a été créé depuis un document

différent que celui qui a créé ce nœud.

</para>

</listitem>

</varlistentry>

<varlistentry>

<term><constant>DOM_NOT_FOUND_ERR</constant></term>

<listitem>

<para>

Levé si <parameter>child</parameter> n'est pas un fils de ce nœud.

</para>

</listitem>

</varlistentry>

</variablelist>

</para>

</refsect1>

<refsect1 role="seealso">

&reftitle.seealso;

<para>

<simplelist>

<member><methodname>DOMNode::appendChild</methodname></member>

</simplelist>

</para>

</refsect1>

</refentry>