XSLTProcessor

Un XSLTProcessor applique une transformation de feuille de style XSLT à un document XML pour générer un nouveau document XML. Il fait appel à des méthodes pour charger la feuille de style XSLT, donner des valeurs aux paramètres <xsl:param> et pour appliquer les transformations au document.

Le constructeur n'a pas de paramètre.

new XSLTProcessor()

[Throws] void XSLTProcessor.importStylesheet(Node styleSheet)

Importe une feuille de style XSLT. Si le nœud passé en argument est un nœud de document, vous pouvez passer une transformation XSL complète ou un transformation d'élèment résultant; sinon, il doit s'agir d'un élèment <xsl:stylesheet> ou <xsl:transform>.

[Throws] DocumentFragment XSLTProcessor.transformToFragment(Node source, Document owner)

Transforme la source du nœud en applicant la fonction XSLTProcessor.importStylesheet(). Le document propriétaire du fragment de document résultant est le nœud propriétaire.

[Throws] Document XSLTProcessor.transformToDocument(Node source)

Transforme la source du nœud en appliquant la feuille de style donnée lors de l'importation à l'aide de la fonction XSLTProcessor.importStylesheet ().

L'objet résultant dépend de la méthode de sortie de la feuille de style :

Méthode de sortie	Type de résultat
html	HTMLDocument
xml	XMLDocument
text	XMLDocument avec un seul élèment racine <transformiix:result> avec le texte comme enfant

[Throws] void XSLTProcessor.setParameter(String namespaceURI, String localName, any value)

Définit un paramètre dans la feuille de style XSLT qui a été importée. (Définit la valeur d'un <xsl:param>.) Une valeur nulle pour namespaceURI sera traitée comme une chaîne vide.

[Throws] any XSLTProcessor.getParameter(String namespaceURI, String localName)

Récupére un paramètre de la feuille de style XSLT. Une valeur nulle pour namespaceURI sera traitée comme une chaîne vide.

[Throws] void XSLTProcessor.removeParameter(String namespaceURI, String localName)

Supprime le paramètre s'il a déjà été défni. Le XSLTProcessor utilisera alors la valeur par défaut du paramètre. Si une valeur nulle est donnée pour namespaceURI, elle sera traitée comme une chaîne vide.

void XSLTProcessor.clearParameters()

Supprime tous les paramètres définis dans le XSLTProcessor. Le XSLTProcessor utilisera alors les valeurs par défaut spécifiées dans la feuille de style XSLT.

void XSLTProcessor.reset()

Supprime tous les paramétres et feuilles de style du XSLTProcessor.

Les propriétés suivantes sont [ChromeOnly] et ne sont pas apparentes au contenu Web :

[ChromeOnly] attribute unsigned long XSLTProcessor.flags

Drapeaux qui modifient le comportement du processeur. Pas de réinitialisation en appelant XSLTProcessor.reset(). Valeur par défaut: 0

Possible values are:

Nom	Valeur	Effet
(None)	0	Aucun
DISABLE_ALL_LOADS	1	Désactiver le chargement de documents externes (par ex. <xsl:import> et document())

1. Exemple simple
2. Exemple avancé
3. Exemple additionnel

Ne fait partie d'aucune spécification. Il s'agit d'une interface propriétaire qui provient de Gecko.

• XSLTProcessor.webidl
• nsIXSLTProcessor.idl

• Utilisation de l'interface JavaScript de Mozilla pour les transformations XML