{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 |
| alt | chaîne de caractères | non | “” | Description alternative de l'image |
| href | chaîne de caractères | non | n/a | valeur de l'attribut href, indiquant le lien vers l'image |
| path_prefix | chaîne de caractères | non | n/a | Préfixe pour le chemin de la sortie |
basedirest le dossier de base dans lequel les images sont basées. S'il n'est pas fourni, la variable d'environnement$_ENV['DOCUMENT_ROOT']sera utilisée. Si$securityest activé, le chemin vers l'image doit être présent dans le dossier de sécurité.hrefest la valeur de l'attribut href de l'image. Si le lien est fourni, une balise<a href="LINKVALUE"><a>sera placée autour de la balise de l'image.path_prefixest un préfixe optionnel que vous pouvez fournir. Il est utile si vous voulez fournir un nom de serveur différent pour l'image.Tous les paramètres qui ne sont pas dans la liste ci-dessus sont affichés sous la forme d'une paire 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.
Example 8.11. Exemple avec {html_image}
{html_image file='pumpkin.jpg'}
{html_image file='/path/from/docroot/pumpkin.jpg'}
{html_image file='../path/relative/to/currdir/pumpkin.jpg'}
L'affichage possible du template ci-dessus pourrait être :
<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" />