document.createElementNS

Résumé

Crée un élément avec l'URI de l'espace de nom spécifié, et un nom qualifié.

Syntaxe

element = document.createElementNS(namespaceURI, qualifiedName);

• element est l'element créé.
• namespaceURI est une chaîne de caractères qui spécifie l'URI de l'espace de nom à associer à l'élément. La propriété namespaceURI de l'élément créé est initialisée avec la valeur de namespaceURI. (voir ci-dessous la secion "URIs d'espaces de nom valides")
• qualifiedName est une chaîne de caractères qui spécifie le type de l'élément à créer. La propriété nodeName de l'élément créé est initialisée avec la valeur de qualifiedName

URIs d'espaces de nom valides

• HTML - Utiliser https://www.w3.org/1999/xhtml
• SVG - Utiliser https://www.w3.org/2000/svg
• XBL - Utiliser https://www.mozilla.org/xbl
• XUL - Utiliser https://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul

Exemple

Cet exemple crée un nouvel élément <div> dans l'espace de nom XHTML et l'ajoute à l'élément vbox. Bien que ce ne soit pas un document XUL très utile, cela montre l'utilisation d'éléments de deux espaces de nom différents au sein d'un même document :

<?xml version="1.0"?>
<page xmlns="https://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul"
      xmlns:html="https://www.w3.org/1999/xhtml"
      title="||Working with elements||"
      onload="init()">

<script type="text/javascript"><![CDATA[
 var container;
 var newdiv;
 var txtnode;

 function init(){
   container = document.getElementById("ContainerBox");
   newdiv = document.createElementNS("https://www.w3.org/1999/xhtml","div");
   txtnode = document.createTextNode("This is text that was constructed dynamically with createElementNS and createTextNode then inserted into the document using appendChild.");
   newdiv.appendChild(txtnode);
   container.appendChild(newdiv);
 }

]]></script>

 <vbox id='ContainerBox' flex='1'>
  <html:div>
   The script on this page will add dynamic content below:
  </html:div>
 </vbox>

</page>

Notes

Cet exemple utilise un script interne, ce qui n'est pas recommandé dans les documents XHTML. Cet exemple particulier est en fait un document XUL intégrant du XHTML. Cependant, la recommandation s'applique quand même. Le script intégré ne cause aucun problème pour ce court exemple, mais pour un projet sérieux, vous devriez apprendre à Utiliser correctement CSS et JavaScript dans les documents XHTML.

Pour créer un élément sans spécifier d'URI d'espace de nom, utilisez la méthode createElement.

Spécifications

• DOM 2 Core: createElementNS
• Espaces de nom en XML

Voir aussi

• document.createElement
• document.createTextNode
• element.namespaceURI