L'interface DOMConfiguration représente la configuration d'un document et conserve une table des paramètres reconnus.

En utilisant la configuration, il est possible de changer le comportement de la méthode Document.normalizeDocument() tel que le remplacement des noeuds CDATASection par des noeuds textuels ou en spécifiant le type du schéma qui doit être utilisé lors de la validation du document. Il peut être utilisé dans les interfaces DOMParser et DOMSerializer.

Les noms de paramètres utilisés par l'objet DOMConfiguration sont définis dans les spécifications DOM Level 3. Les noms sont insensibles à la casse de caractères.

Paramètre Description
canonical-form applique une forme canonique en accord avec les règles spécifiées par le W3C. Par défaut, la valeur est false.
cdata-sections conserve les noeuds CDATASection dans le document ou les transforme en noeud textuel. Par défaut la valeur est true.
check-character-normalization vérifie si les caractères du document sont complètement normalisés comme défini par le W3C. La valeur par défaut est false.
comments conserve (true) les noeuds Comment dans le document ou les abandonne si le paramètre vaut false. La valeur par défaut est true.
datatype-normalization affiche les valeurs normalisées du schéma dans l'arborescence. La valeur par défaut est false.
element-content-whitespace conserve true tous les espaces blancs du document. La valeur par défaut est true.
entities conserve (true) les noeuds EntityReference dans le document. La valeur par défaut est true.
error-handler contient un objet DOMErrorHandler qui sera appelé pour gérer en cas d'erreur.
infoset conserve (true) dans le document les informations définies dans la recommandation XML Information Set.
namespaces traite les espaces de noms. Par défaut, la valeur est true.
namespace-declarations inclut les attributs de déclaration d'espace de noms spécifiés dans le schéma. La valeur par défauf est true.
normalize-characters normalise complètement les caractères dans le document. La valeur par défaut est false.
schema-location liste les adresses URI séparés par des espaces, qui serviront à la validation du document.
schema-type contient une adresse URI absolue représentant le type de langage de schéma utilisé pour valider le document.
split-cdata-sections découpe les sections CDATA contenant le terminateur ]]>. Par défaut, la valeur est true.
validate précise si le document requiert une validation avec un schéma, une DTD, ou autres. La valeur par défaut est false.
validate-if-schema active la validation seulement si la déclaration pour l'élément racine peut être trouvé dans un schéma ou une DTD. par défaut, la valeur est false.
well-formed vérifie si tous les noeuds sont bien formés en accord avec la version XML utilisé par le document. Par défaut, la valeur est true.
Méthode
Description
boolean canSetParameter(String nom, Object valeur)
vérifie si un paramètre peut supporter la valeur spécifiée.
Object getParameter(String nom)
retourne la valeur du paramètre spécifié.
DOMStringList getParameterNames()
retourne la liste des paramètres supportés par l'objet DOMConfiguration.
void setParameter(String nom, Object valeur)
fixe la valeur d'un paramètre en fonction de son nom.