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. |