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()
. 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 pournamespaceURI
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 pournamespaceURI
, elle sera traitée comme une chaîne vide. void
XSLTProcessor.clearParameters()
-
Supprime tous les paramètres définis dans le
XSLTProcessor
. LeXSLTProcessor
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
-
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>
etdocument()
)
Exemples
Spécifications
Ne fait partie d'aucune spécification. Il s'agit d'une interface propriétaire qui provient de Gecko.
Gecko IDL
Compatibilité des navigateurs
BCD tables only load in the browser