Balise #IMAGE_PAR_DEFAUT

Cette balise génère à la volée des images dont on peut préciser la taille et la couleur. Elle s’utilise par exemple lors du développement d’un site, lorsqu’il manque des images. On la place alors dans la partie alternative de boucles requérant ces images, et elle sera appelée chaque fois qu’une image requise n’a pas été trouvée par la boucle.

Cas d’utilisation

Imaginons le cas d’un site où l’on ait absolument besoin d’une série d’images d’une certaine taille par exemple pour alimenter un slider. Imaginons que ces images ne soient pas encore présentes sur le site.

Créons un squelette de slider qui tente dans un premier temps de récupérer les images requises (de largeur 960px par exemple) depuis la bibliothèque dans une boucle [1] :

<BOUCLE_a_la_une_image(DOCUMENTS){id_article}{extension IN png,jpg,gif}{0,1}{largeur >= 960}>
  [(#FICHIER
    |image_passe_partout{960,260}|image_recadre{960,260}
    |inserer_attribut{alt,""})]
</BOUCLE_a_la_une_image>
...

Ajoutons une partie alternative à la boucle afin de traiter les cas où les images requises ne sont pas encore en bae. La balise #IMAGE_PAR_DEFAUT sera appelée en lieu et place du fichier manquant :

...
  [(#IMAGE_PAR_DEFAUT{960,260}
    |image_passe_partout{960,260}|image_recadre{960,260}
    |inserer_attribut{alt,""})]
<//B_a_la_une_image>

Paramètres

Outre les dimensions de l’image à fabriquer, on peut passer à la balise #IMAGE_PAR_DEFAUT d’autres paramères :
-  un texte (court...)
-  une couleur pour le fond (par défaut gris #cccccc...)
-  une couleur pour le texte (par défaut #444444...)

Exemples d’appel

Voici quelques exemples d’appel avec les résultats produits :

#IMAGE_PAR_DEFAUT{300,200,'',#009AFE,#717286}

#IMAGE_PAR_DEFAUT{300,200,'Pouet'}

Pour de petites images :

#IMAGE_PAR_DEFAUT{108,108,'Silhouette',#e6d39b,#4682C8}

Et pour des images plus grandes [2] :

#IMAGE_PAR_DEFAUT{960,260,'Un texte vraiment très très long, voire trop long',#e6d39b,#4682C8}

Footnotes

[1Les filtres sur la boucle document et sur la balise #FICHIER sont donnés à titre d’exemple et n’influent pas sur le comportement de la balise

[2Dans le cas présent sur Contrib les images sont réduites pour ne pas nuire à la mise en forme

Afin d’éviter que des images alternatives issues de la balise #IMAGE_PAR_DEFAUT n’apparaissent par mégarde aux yeux des visiteurs, il est recommandé de désactiver ce plugin sur les sites en production.

updated on 2 October 2019

Discussion

Une discussion

Comment on this article

Who are you?
  • [Log in]

To show your avatar with your message, register it first on gravatar.com (free et painless) and don’t forget to indicate your Email addresse here.

Enter your comment here

This form accepts SPIP shortcuts {{bold}} {italic} -*list [text->url] <quote> <code> and HTML code <q> <del> <ins>. To create paragraphs, just leave empty lines.

Add a document

Follow the comments: RSS 2.0 | Atom