smarty template engine
Friday, July 25, 2008  
download | documentation | faq | forum | mailing lists | changelog | contribs 


search for in the  


html_image

Nome AttributoTipoObbligatorioDefaultDescrizione
filestringanessunonome/percorso dell'immagine
borderstringano0dimensione del bordo dell'immagine
heightstringanoaltezza effettiva dell'immaginealtezza con cui visualizzare l'immagine
widthstringanolarghezza effettiva dell'immaginelarghezza con cui visualizzare l'immagine
basedirstringanodoc root del web serverdirectory di base per percorsi relativi
altstringano""descrizione alternativa dell'immagine
hrefstringanonessunovalore di href per il link dell'immagine

html_image è una funzione utente che genera un tag HTML per una immagine. L'altezza e la larghezza, quando non indicate, vengono calcolate automaticamente dal file dell'immagine.

basedir è la directory di riferimento per percorsi relativi. Se non viene indicata, viene usata come base la document root del web server (variabile di ambiente DOCUMENT_ROOT). Se la security è abilitata, il percorso dell'immagine deve trovarsi in una directory considerata sicura.

href è l'indirizzo del link a cui collegare l'immagine. Se viene fornito, verrà creato un tag <a href="LINKVALUE"><a> attorno al tag image.

Tutti i parametri non compresi nella lista qui sopra vengono stampati come coppie nome/valore all'interno del tag <img> generato.

Nota tecnica: html_image richiede un accesso al disco per leggere il file dell'immagine e calcolarne altezza e larghezza. Se non usate il caching dei template, è generalmente consigliabile evitare html_image e lasciare i tag image statici per ottenere prestazioni ottimali.

Esempio 8-7. esempio di html_image

<?php

require('Smarty.class.php');
$smarty = new Smarty;
$smarty->display('index.tpl');

?>

dove index.tpl è:

{html_image file="pumpkin.jpg"}
{html_image file="/path/from/docroot/pumpkin.jpg"}
{html_image file="../path/relative/to/currdir/pumpkin.jpg"}

un possibile output potrebbe essere:

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



 

credits 

Smarty Copyright © 2002-2008
New Digital Group, Inc.

All rights reserved.