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)

Transforms the node source by applying the stylesheet imported using the XSLTProcessor.importStylesheet() function. 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:

Output method	Type de résultat
html	HTMLDocument
xml	XMLDocument
text	XMLDocument with a single root element <transformiix:result> with the text as a child

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

Sets a parameter in the XSLT stylesheet that was imported. (Sets the value of an <xsl:param>.) A null value for namespaceURI is treated the same as an empty string.

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

Gets the value of a parameter from the XSLT stylesheet. A null value for namespaceURI is treated the same as an empty string.

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

Removes the parameter if it was previously set. This will make the XSLTProcessor use the default value for the parameter as specified in the stylesheet. A null value for namespaceURI is treated the same as an empty string.

void XSLTProcessor.clearParameters()

Removes all set parameters from the XSLTProcessor. The XSLTProcessor will then use the defaults specified in the XSLT stylesheet.

void XSLTProcessor.reset()

Removes all parameters and stylesheets from the XSLTProcessor.

Propriétés

Non-Web-exposed properties

The following properties are [ChromeOnly] and not exposed to Web content:

[ChromeOnly] attribute unsigned long XSLTProcessor.flags

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