Échappement de sortie
Un caractère de string de texte est dénommé échappé lorsqu’il est écrit comme référence de caractère ou référence d’entité. Les deux types de références (caractère et entité) sont délimités par une esperluette au début et un point-virgule à la fin. Par exemple :
•La référence de caractère hexadécimal (ou Unicode) du caractère A est A
•La référence de caractère décimal du caractère A est &# 65;
•La référence d’entité HTML (et XML) du caractère & est &
•La référence de caractère hexadécimal (ou Unicode) du caractère & est &
•La référence de caractère décimal du caractère & est &# 38;
•La référence d’entité HTML (et XML) du caractère < est <
Échappement de sortie
L’échappement de sortie se réfère à la manière dont les caractères qui sont échappés dans l’entrée sont représentés dans la sortie. Un caractère est dit ‘output-escaped’ lorsqu’il est représenté dans la sortie comme référence de caractère ou d’entité. Notez qu’un caractère peut uniquement être output-escaped lorsqu’il est échappé dans l’entrée (voir table ci-dessous pour des exemples). Dans un SPS, l’échappement de sortie peut être activé ou désactivé pour :
•Fragments de texte statique,
•Espace réservé contents, et
•Calculs automatiques
Ceci est fait avec l’attribut disable-output-escaping du groupe des propriétés de Text. La valeur par défaut de cette propriété est no, ce qui signifie que output-escaping ne sera pas désactivé. Ainsi, les caractères qui sont échappés dans l’entrée seront échappés dans la sortie par défaut (voir table ci-dessous pour les exemples).
Pour désactiver l’échappement de sortie, suivez les étapes suivantes :
1.Sélectionnez le (i) texte statique, ou (ii) le fragment de texte statique, (iii) l’espace réservé contents, ou (iv) le calcul automatique pour lequel vous souhaitez désactiver l’échappement de sortie.
2.Dans la barre latérale des Propriétés, sélectionnez le groupe des propriétés Text pour l’item Text et définissez l’attribut disable-output-escaping comme yes pour les différentes sorties individuellement ou pour toutes les sorties. Les valeurs disponibles sont :
•For HTML (pour définir disable-output-escaping comme yes pour la sortie HTML).
•For Authentic (pour définir disable-output-escaping comme yes pour la sortie Authentic). Notez que désactiver l’échappement de sortie pour Authentic View est activé uniquement dans les Enterprise editions d’Authentic View (à savoir, dans les Enterprise editions de StyleVision, Authentic Desktop, Authentic Browser et XMLSpy).
•For RTF (pour définir disable-output-escaping comme yes pour la sortie RTF).
•For PDF (pour définir disable-output-escaping comme yes pour la sortie PDF).
•For Word 2007+ pour définir disable-output-escaping comme yes pour la Word 2007+).
•For all (pour définir disable-output-escaping comme yes pour toutes les sorties à l’exception de Text).
Note : l’échappement de sortie ne s’applique pas à la sortie Text. (Il n’est ni activé ni désactivé.)
Lorsque l’échappement de sortie est désactivé pour un format de sortie particulier (par exemple, sortie HTML), le texte sélectionné ne sera pas échappé dans ce format de sortie, mais sera échappé dans les autres formats de sortie.
Ci-dessous, vous trouverez quelques exemples de texte avec l’échappement de sortie désactivé et/ou activé.
Un texte statique | désactiver-l’échappement de sortie | Texte de message de sortie |
& | non | & |
& | oui | & |
& | non | & |
& | oui | & |
< | non | < |
< | oui | < |
&# 65; | non | &# 65; |
&# 65; | oui | A |
&lt; | non | &lt; |
&lt; | oui | < |
&amp;lt; | oui | < |
&& lt; | oui | &< |
Note : Désactiver-Sortie-Échappement est pris en charge dans Authentic View uniquement dans les produits des Enterprise Editions d’Altova.
Utiliser l’output-escaping désactivé parmi les formats de sortie
Si output-escaping est désactivé, le string de texte peut avoir une signification dans une sortie, mais aucune signification dans toutes les autres sorties. Par exemple, prenez en compte le texte d’entrée suivant, qui a échappé des caractères (en surbrillance) :
<b>Ce texte est en gras.</b>
Si output-escaping est désactivé, la sortie de ce texte sera comme suit :
<b>This text is bold.</b>
Si output-escaping est désactivé pour la sortie HTML et que cette sortie est consultée dans un navigateur (contrairement à un éditeur de texte), le markup sera significatif pour le navigateur HTML et le texte sera affiché en gras comme suit :
This text is bold.
Toutefois, si consulté dans un autre format de sortie, tel un PDF, le markup qui était significatif dans HTML ne sera pas nécessairement important dans cet autre format de sortie. Dans ce cas particulier cité ci-haut, le texte non échappé (échappement de sortie désactivé) sera sorti den format PDF comme suit :
<b>This text is bold.</b>
Comme l’exemple ci-dessus le démontre, le texte de sortie obtenu en désactivant le texte obtenu par ‘disabling output-escaping’ pourrait être interprété comme code dans le format de sortie, mais pas dans un autre. Ceci ne devrait en aucun cas être retenu lorsque vous utilisez la propriété ‘Disable-Output-Escaping’.