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 $attrs  Atributos de la imágen.
  70      */
  71     function MECON_HTML_Icon($nombre, $link = null, $alt = null, $attrs = array())
  72     {
  73         switch ($nombre) {
  74             default:
  75                 $src = "/MECON/images/general_$nombre";
  76         }
  77         if (is_null($alt)) {
  78             $alt = '(' . strtoupper($nombre{0}) . ')';
  79         }
  80         parent::MECON_HTML_Image($src, $alt, $attrs);
  81         $this->setLink($link);
  82     }
  83
  84     /**
  85      * Converts to HTML output.
  86      *
  87      * @return string
  88      */
  89     function toHtml()
  90     {
  91         if (is_null($this->_link)) {
  92             return parent::toHtml();
  93         } else {
  94             $link = $this->getLink();
  95             return $link->toHtml();
  96         }
  97     }
  98
  99     /**
 100      * Gets image location.
 101      */
 102     function getSrc()
 103     {
 104         return $this->getAttribute('src');
 105     }
 106
 107     /**
 108      * Sets image location.
 109      *
 110      * @param  string $src Image location.
 111      */
 112     function setSrc($src)
 113     {
 114         $this->updateAttributes(array('src' => $src));
 115     }
 116
 117     /**
 118      * Gets image alternate text.
 119      */
 120     function getAlt()
 121     {
 122         return $this->getAttribute('alt');
 123     }
 124
 125     /**
 126      * Establece el link a donde apunta el ícono.
 127      *
 128      * @param $link Nuevo link.
 129      */
 130     function setLink($link)
 131     {
 132         if (!is_a($link, 'mecon_html_link') and !is_null($link)) {
 133             $this->_link = new MECON_HTML_Link($link);
 134         } else {
 135             $this->_link = $link;
 136         }
 137     }
 138
 139     /**
 140      * Obtiene el link a donde apunta el ícono.
 141      * @param $full Si es true, devuelve el link con la imagen incluida, si
 142      *              es false devuelve solo el link.
 143      */
 144     function getLink($full = true)
 145     {
 146         $link = $this->_link;
 147         if (!$full or is_null($link)) {
 148             return $link;
 149         }
 150         $link->addContents(new MECON_HTML_Image($this->getSrc(),
 151             $this->getAlt(), $this->getAttributes()));
 152         return $link;
 153     }
 154
 155 }
 156
 157 ?>