lib/MECON/HTML/Icon.php

   1 <?php /* vim: set binary expandtab tabstop=4 shiftwidth=4 textwidth=80:
   2 -------------------------------------------------------------------------------
   3                              Ministerio de Economía
   4                                     meconlib
   5 -------------------------------------------------------------------------------
   6 This file is part of meconlib.
   7
   8 meconlib is free software; you can redistribute it and/or modify it under
   9 the terms of the GNU General Public License as published by the Free
  10 Software Foundation; either version 2 of the License, or (at your option)
  11 any later version.
  12
  13 meconlib is distributed in the hope that it will be useful, but WITHOUT
  14 ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
  15 FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
  16
  17 You should have received a copy of the GNU General Public License; if not,
  18 write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330,
  19 Boston, MA  02111-1307  USA
  20 -------------------------------------------------------------------------------
  21 Creado:  mar mar 16 15:55:32 ART 2004
  22 Author:  Leandro Lucarella <llucar@mecon.gov.ar>
  23 -------------------------------------------------------------------------------
  24 $Id$
  25 -----------------------------------------------------------------------------*/
  26
  27 require_once 'MECON/HTML/Link.php';
  28 require_once 'MECON/HTML/Image.php';
  29
  30 /**
  31  * Ícono.
  32  *
  33  * Básicamente es una imágen con un link.
  34  * Ejemplo:
  35  * @code
  36  * require_once 'MECON/HTML/Icon.php';
  37  * require_once 'MECON/HTML/Link.php';
  38  * // Crea un ícono de IR sin link.
  39  * $icono1 = new MECON_HTML_Icon('ir');
  40  * // Crea un ícono de ELIMINAR que apunta a 'algun/lugar'.
  41  * $icono2 = new MECON_HTML_Icon('eliminar', 'algun/lugar');
  42  * // Crea un ícono de NUEVO que apunta a 'algun/lugar?id=3&cant=10', tiene el
  43  * // texto alternativo '>>' y 1 píxel de borde.
  44  * $icono3 = new MECON_HTML_Icon('nuevo',
  45  *     new MECON_HTML_Link('algun/lugar', '', array('id' => 3, $cant => 10)),
  46  *     '>>', array('border' => 1));
  47  * // Muestra todos los íconos.
  48  * $icon1->display();
  49  * echo $icon2->toHtml();
  50  * $icon3->display();
  51  * @endcode
  52  *
  53  * @access public
  54  */
  55 class MECON_HTML_Icon extends MECON_HTML_Image {
  56
  57     /**
  58      * Link a donde apunta la imagen.
  59      * @private
  60      */
  61     var $_link;
  62
  63     /**
  64      * Constructor.
  65      *
  66      * @param $nombre Nombre de la imágen.
  67      * @param $link   Link a donde apunta. Si es null, no tiene un link.
  68                       Puede ser un link o un MECON_HTML_Link.
  69      * @param $alt    Texto alternativo para la imagen.
  70      * @param $attrs  Atributos de la imágen.
  71      */
  72     function MECON_HTML_Icon($nombre, $link = null, $alt = null, $attrs = array())
  73     {
  74         switch ($nombre) {
  75             default:
  76                 $src = "/MECON/images/general_$nombre";
  77         }
  78         if (is_null($alt)) {
  79             $alt = '(' . strtoupper($nombre{0}) . ')';
  80         }
  81         parent::MECON_HTML_Image($src, $alt, $attrs);
  82         $this->setLink($link);
  83     }
  84
  85     /**
  86      * Converts to HTML output.
  87      *
  88      * @return string
  89      */
  90     function toHtml()
  91     {
  92         if (is_null($this->_link)) {
  93             return parent::toHtml();
  94         } else {
  95             $link = $this->getLink();
  96             return $link->toHtml();
  97         }
  98     }
  99
 100     /**
 101      * Gets image location.
 102      */
 103     function getSrc()
 104     {
 105         return $this->getAttribute('src');
 106     }
 107
 108     /**
 109      * Sets image location.
 110      *
 111      * @param  string $src Image location.
 112      */
 113     function setSrc($src)
 114     {
 115         $this->updateAttributes(array('src' => $src));
 116     }
 117
 118     /**
 119      * Gets image alternate text.
 120      */
 121     function getAlt()
 122     {
 123         return $this->getAttribute('alt');
 124     }
 125
 126     /**
 127      * Establece el link a donde apunta el ícono.
 128      *
 129      * @param $link Nuevo link.
 130      */
 131     function setLink($link)
 132     {
 133         if (!is_a($link, 'mecon_html_link') and !is_null($link)) {
 134             $this->_link = new MECON_HTML_Link($link);
 135         } else {
 136             $this->_link = $link;
 137         }
 138     }
 139
 140     /**
 141      * Obtiene el link a donde apunta el ícono.
 142      * @param $full Si es true, devuelve el link con la imagen incluida, si
 143      *              es false devuelve solo el link.
 144      */
 145     function getLink($full = true)
 146     {
 147         $link = $this->_link;
 148         if (!$full or is_null($link)) {
 149             return $link;
 150         }
 151         $link->addContents(new MECON_HTML_Image($this->getSrc(),
 152             $this->getAlt(), $this->getAttributes()));
 153         return $link;
 154     }
 155
 156 }
 157
 158 ?>