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.

Syntaxe

Le constructeur n'a pas de paramètre.

new XSLTProcessor()

Méthodes

[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(). The owner document of the resulting document fragment is the owner node.

[Throws] Document XSLTProcessor.transformToDocument(Node source)

Transforms the node source applying the stylesheet given importing using the XSLTProcessor.importStylesheet() function.

The resultant object depends on the output method of the stylesheet:

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.

Propriétés

Propriétés non-apparentes au Web

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

[ChromeOnly] attribute unsigned long XSLTProcessor.flags

Flags that tweak the behavior of the processor. Not reset by calling 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())

Exemples

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

Spécifications

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

Gecko IDL

• XSLTProcessor.webidl
• nsIXSLTProcessor.idl

Compatibilité des navigateur

Voir aussi

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