Smarty - le moteur et compilateur de template PHP
Précédent	Chapitre 8. Fonctions utilisateur	Suivant

{html_image}

{html_image} est une fonction utilisateur qui génère la balise HTML pour une image. La hauteur et la longueur de l'image sont calculés automatiquement depuis le fichier image si aucune n'est spécifiée.

Nom attribut	Type	Requis	Défaut	Description
file	chaîne de caractères	Oui	n/a	nom/chemin des images
height	chaîne de caractères	Non	Hauteur de l'image actuelle	Hauteur de l'image à afficher
width	chaîne de caractères	Non	Longueur de l'image actuelle	Longueur de l'image à afficher
basedir	chaîne de caractères	non	racine du serveur web	répertoire depuis lequel baser le calcul des chemins relatifs
link	chaîne de caractères	non	n/a	lien sur lequel l'image pointe
path_prefix	string	no	n/a	préfixe pour le chemin de la sortie

basedir est le répertoire de base depuis lequel seront calculés les chemins relatifs. Si non spécifié, la racine du serveur web est utilisé (variable d'environnement DOCUMENT_ROOT). Si $security est activé, l'image doit se situer dans un répertoire sécurisé.

href est la valeur de l'attribut 'href' à laquelle lier l'image. Si link est défini, une balise <a href="LINKVALUE"><a> est placée autour de l'image.

path_prefix est un préfixe optionnel que vous ouvez donné pour le chemin de sortie. Ceci est pratique si vous voulez fournir un nom de serveur différent pour l'image.

Tous les paramètres qui ne sont pas listés ci-dessus seront affichés en tant que paires nom/valeur dans la balise <img> créée.

Note technique : {html_image} requiert un accès au disque dur pour lire l'image et calculer ses dimensions. Si vous n'utilisez pas un cache, il est généralement préférable d'éviter d'utiliser html_image et de laisser les balises images statiques pour de meilleures performances.

Exemple 8-9. html_image

Où index.tpl est :
-------------------
{html_image file="pumpkin.jpg"}
{html_image file="/path/from/docroot/pumpkin.jpg"}
{html_image file="../path/relative/to/currdir/pumpkin.jpg"}

Sortie possible :

<img src="pumpkin.jpg" alt="" width="44" height="68" />
<img src="/path/from/docroot/pumpkin.jpg" alt="" width="44" height="68" />
<img src="../path/relative/to/currdir/pumpkin.jpg" alt="" width="44" height="68" />

Précédent	Sommaire	Suivant
{html_checkboxes}	Niveau supérieur	{html_options}