Xml Dtd Entités XPath Xsl 1

Xsl Stylesheet : Instructions

 apply-imports  apply-templates  attribute  call-template  choose  comment  copy  copy-of  element  fallback  for-each  if  message  number  otherwise  processing-instruction  sort  text  transform  value-of  variable  when  with-param  liens

Balise Attributs Contenu Résumé
apply-imports aucun
Demande l'application des modèles d'une feuille de style importée en plus de ceux de la feuille courante.
apply-templates
  • select=node-set-expression
  • mode=qname
Par défaut, appelle et traite les enfants du noeud courant.
Si l'attribut select est précisé, ce sont les noeuds visés qui sont traités ; ceux-ci ne sont pas obligatoirement descendants du noeud courant.
Note : cette instruction n'est autorisée que dans un template de type "select" et non "name".
Le contenu sort permet de préciser l'ordre de présentation des noeuds.
Le contenu with-param permet de passer une variable dont la valeur sera récupérée via param.
attribute
  • name={qname}
  • namespace={uri-reference}
valeur de l'attribut Crée un attribut qui sera ajouté à l'élément créé par element dont cette balise est descendante.
call-template
  • name=qname
Appelle une règle modèle de type name.
Le contenu with-param permet de passer une ou plusieurs variables.
choose aucun Etablit un traitement sélectif (tel que switch/case).
Le premier bloc enfant when dont le test est vrai sera exécuté.
Seul le premier test when vrai est exécuté.
En l'absence de test valable, le bloc otherwise (optionnel) sera exécuté.
comment aucun Le commentaire lui-même Crée un commentaire dans le fichier résultat.
Le contenu de la balise sera recopié encadré par les séparateurs <!-- et -->
copy
  • use-attribute-sets=qnames
Les noeuds à copier Duplique les noeuds présents dans la balise :
  • Soit les noeuds de la source appelés par un apply-template
  • Soit des noeuds de la feuille de style
L'attribut use-attribute-sets permet d'ajouter une collection d'attributs aux noeuds générés à partir de l'arbre source.
copy-of
  • select=expression
vide Crée une copie conforme du ou des noeud(s) désigné(s) par l'expression.
La descendance et les attributs sont également recopiés.
Lorsque l'expression ne désigne pas un ensemble de noeuds, le résultat est traduit en chaîne de caractères reproduite dans le résultat.
element
  • name={qname}
  • namespace={uri-reference}
  • use-attribute-sets=qnames
  • attribute
  • Tout contenu à intégrer à l'élément créé
Permet de créer un élément résultat. Les attributs peuvent être précisés via l'attribut use-attribute-sets ou en utilisant des balises attribute imbriquées.
fallback aucun modèle (idem template) Définit un traitement de reprise dans le cas de l'utilisation de fonctions externes.
for-each
  • select=node-set-expression
Etablit une boucle de traitement de la collection de noeuds rendue par l'expression passée.
Le contenu correspond à un template.
if
  • test=boolean-expression
instructions N'appelle le contenu (de forme template) que si le test spécifié est vrai.
Il n'y a pas d'instruction else ; utiliser à nouveau if avec la fonction not().
message
  • terminate="yes"|"no"
message Permet d'envoyer un message au moteur de transformation. Généralement, celui-ci redirigera le message vers la console ou vers un fichier de log.
number
  • level="single"|"multiple"|"any"
  • count=pattern
  • from=pattern
  • value=number-expression
  • format={string}
  • lang={nmtoken}
  • letter-value={"alphabetic"|"traditional"}
  • grouping-separator={char}
  • grouping-size={number}
vide Permet d'encoder un nombre en chaîne de caractères, en spécifiant le format à utiliser.
otherwise aucun instructions Utilisé dans une construction choose pour désigner l'action à effectuer si aucun des tests when n'a été concluant (facultatif).
param
  • name=qname
  • select=expression
contenu du paramètre param est à la fois un élément de premier niveau et une instruction.
Lorsqu'elle est utilisée dans un template nommé, cette instruction permet de récupérer un paramètre qui a été défini par with-param dans call-template.
processing-instruction
  • name={ncname}
paramètres Génère une instruction de traitement dans le résultat.
<?name paramètres?>
sort
  • select=string-expression
  • lang={nmtoken}
  • data-type={"text"|"number"|qname-but-not-ncname}
  • order={"ascending"|"descending"}
  • case-order={"upper-first"|"lower-first"}
vide Utilisée en tant qu'enfant d'autres instructions pour spécifier l'ordre d'apparition des noeuds.
text
  • disable-output-escaping="yes"|"no"
Le texte à insérer dans le document en sortie Permet de générer directement du texte dans le résultat.
L'option disable-output-escaping permet, lorsqu'elle est à "yes", de générer des caractères < et > :
<xsl:text disable-output-escaping="yes">&lt;&gt;</xsl:text> génèrera : <>
transform
  • id=id
  • extension-element-prefixes=tokens
  • exclude-result-prefixes=tokens
  • version=number
éléments de premier niveau Autre nom pour stylesheet
value-of
  • select=string-expression
  • disable-output-escaping="yes"|"no"
vide Insère un noeud textuel dans l'arbre résultat à partir de l'espression passée à select.
L'expression est convertie en chaîne de caractère par la fonction XPath string().
Voir l'instruction text pour l'option disable-output-escaping.
variable
  • name=qname
  • select=expression
contenu de la variable variable est à la fois un élément de premier niveau et une instruction.
when
  • test=boolean-expression
instructions Utilisé à l'intérieur d'une instruction choose pour définir un bloc de traitement conditionnel.
Seul le premier bloc rendant un test vrai est exécuté.
with-param
  • name = qname
  • select = expression
contenu du paramètre s'il n'est pas passé via select Utilisée comme enfant d'une balise call-template pour spécifier un paramètre à passer.
Le paramètre sera récupéré par le modèle par param.

Liens internes
Liens externes