Le composant org.ametys.cms.transformation.xslt.ResolveURIComponent permet de résoudre des urls d'objet (fichiers, images, pages, contenus,...) depuis vos XSL.
Comment utiliser ces méthodes ?
Ajouter le namespace dans l'entête des fichiers XSL:
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" ... xmlns:resolver="org.ametys.cms.transformation.xslt.ResolveURIComponent" ... extension-element-prefixes="... resolver...">
De sorte à pouvoir appeler n'importe quelle méthodes définies ci-dessous, en utilisant ametys:functionName(argument1, argument2, ...)
Exemple :
<img src="{resolver:resolveBoundedImage(@type, @uri, 350, 200)}" alt="{@altText}"/>
Les méthodes
- resolve
- resolveImage
- resolveBoundedImage
- resolveCroppedImage
- resolveImageAsBase64(String type, String uri, int height, int width)
- resolveBoundedImageAsBase64
- resolveCroppedImageAsBase64
resolve
Description :
Retourne l'url d'un fichier, d'une page, d'un contenu, ...
La méthode peut-être appelée avec 2, 3 ou 4 arguments
Arguments :
|
Nom |
Type |
Obligatoire |
Description |
|---|---|---|---|
|
type |
String |
oui |
Type de fichier.
|
|
uri |
String |
oui |
URI du fichier ou objet. Pour un attribute de contenu, l'uri attend est le chemin de la données et l'identifiant du contenu (ex: illustration/image?objectId=content://uuid-uuid-uuid-uuid) |
|
download |
Boolean |
non |
"true" pour obtenir une url de téléchargement |
|
absolute |
Boolean |
non |
"true" pour obtenir une url absolue |
resolveImage
Description :
Retourne l'url d'une image dans une dimension imposée.
La méthode peut-être appelée avec 4, 5 ou 6 arguments
Arguments :
|
Nom |
Type |
Obligatoire |
Description |
|---|---|---|---|
|
type |
String |
oui |
Type de fichier.
|
|
uri |
String |
oui |
URI de l'image Pour un attribute de contenu, l'uri attend est le chemin de la données et l'identifiant du contenu (ex: illustration/image?objectId=content://uuid-uuid-uuid-uuid) |
|
height |
int |
oui |
Hauteur de l'image |
|
width |
int |
oui |
Largeur de l'image |
|
download |
Boolean |
non |
"true" pour obtenir une url de téléchargement |
|
absolute |
Boolean |
non |
"true" pour obtenir une url absolue |
resolveBoundedImage
Description :
Retourne l'url d'une image avec un cadre imposé (pas de déformation de l'image, pas de recadrage de l'image)
La méthode peut-être appelée avec 4, 5 ou 6 arguments
Arguments :
|
Nom |
Type |
Obligatoire |
Description |
|---|---|---|---|
|
type |
String |
oui |
Type de fichier.
|
|
uri |
String |
oui |
URI de l'image Pour un attribute de contenu, l'uri attend est le chemin de la données et l'identifiant du contenu (ex: illustration/image?objectId=content://uuid-uuid-uuid-uuid) |
|
maxHeight |
int |
oui |
Hauteur maximum de l'image (hauteur du cadre) |
|
maxWidth |
int |
oui |
Largeur maximum de l'image (largeur du cadre) |
|
download |
Boolean |
non |
"true" pour obtenir une url de téléchargement |
|
absolute |
Boolean |
non |
"true" pour obtenir une url absolue |
resolveCroppedImage
Description :
Retourne l'url d'une image dans une dimension imposée avec recadrage de l'image si nécessaire (pas de déformation de l'image)
La méthode peut-être appelée avec 4, 5 ou 6 arguments
Arguments :
|
Nom |
Type |
Obligatoire |
Description |
|---|---|---|---|
|
type |
String |
oui |
Type de fichier.
|
|
uri |
String |
oui |
URI de l'image Pour un attribute de contenu, l'uri attend est le chemin de la données et l'identifiant du contenu (ex: illustration/image?objectId=content://uuid-uuid-uuid-uuid) |
|
croppedHeight |
int |
oui |
Hauteur de l'image |
|
croppedWidth |
int |
oui |
Largeur de l'image |
|
download |
Boolean |
non |
"true" pour obtenir une url de téléchargement |
|
absolute |
Boolean |
non |
"true" pour obtenir une url absolue |
resolveImageAsBase64(String type, String uri, int height, int width)
Description :
Retourne l'url d'une image en base64 dans une dimension imposée (déformation de l'image possible)
La méthode possède 4 arguments
Arguments :
|
Nom |
Type |
Obligatoire |
Description |
|---|---|---|---|
|
type |
String |
oui |
Type de fichier.
|
|
uri |
String |
oui |
URI de l'image Pour un attribute de contenu, l'uri attend est le chemin de la données et l'identifiant du contenu (ex: illustration/image?objectId=content://uuid-uuid-uuid-uuid) |
|
height |
int |
oui |
Hauteur de l'image |
|
width |
int |
oui |
Largeur de l'image |
resolveBoundedImageAsBase64
Description :
Retourne l'url d'une image en base64 dans un cadre imposé (pas de déformation de l'image, pas de recadrage)
La méthode possède 4 arguments
Arguments :
|
Nom |
Type |
Obligatoire |
Description |
|---|---|---|---|
|
type |
String |
oui |
Type de fichier.
|
|
uri |
String |
oui |
URI de l'image Pour un attribute de contenu, l'uri attend est le chemin de la données et l'identifiant du contenu (ex: illustration/image?objectId=content://uuid-uuid-uuid-uuid) |
|
maxHeight |
int |
oui |
Hauteur maximum de l'image |
|
maxWidth |
int |
oui |
Largeur maximum de l'image |
resolveCroppedImageAsBase64
Description :
Retourne l'url d'une image en base64 dans une dimension imposée avec recadrage de l'image si nécessaire (pas de déformation de l'image)
La méthode possède 4 arguments
Arguments :
|
Nom |
Type |
Obligatoire |
Description |
|---|---|---|---|
|
type |
String |
oui |
Type de fichier.
|
|
uri |
String |
oui |
URI de l'image Pour un attribute de contenu, l'uri attend est le chemin de la données et l'identifiant du contenu (ex: illustration/image?objectId=content://uuid-uuid-uuid-uuid) |
|
croppedHeight |
int |
oui |
Hauteur de l'image |
|
croppedWidth |
int |
oui |
Largeur de l'image |
Retour en haut