XSLTProcessor

Non standard: Cette fonctionnalité n'est ni standard, ni en voie de standardisation. Ne l'utilisez pas pour des sites accessibles sur le Web : elle ne fonctionnera pas pour tout utilisateur. Il peut également y avoir d'importantes incompatibilités entre les implémentations et son comportement peut être modifié dans le futur.

Experimental: Cette fonction est expérimentale
Puisque cette fonction est toujours en développement dans certains navigateurs, veuillez consulter le tableau de compatibilité pour les préfixes à utiliser selon les navigateurs.
Il convient de noter qu'une fonctionnalité expérimentale peut voir sa syntaxe ou son comportement modifié dans le futur en fonction des évolutions de la spécification.

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

Syntaxe

Le constructeur n'a pas de paramètre.

new XSLTProcessor()

Méthodes

importStylesheet()

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 une transformation d'élément résultant ; sinon, il doit s'agir d'un élément <xsl:stylesheet> ou <xsl:transform>.

transformToFragment()

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

transformToDocument()

Transforme la source du nœud en appliquant la feuille de style donnée lors de l'importation à l'aide de la fonction 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
setParameter()

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 le paramètre namespaceURI sera traitée comme une chaîne vide.

getParameter()

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

removeParameter()

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

clearParameters()

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

reset()

Supprime tous les paramètres et feuilles de style de l'objet XSLTProcessor.

Exemples

Spécifications

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

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi