X-Git-Url: https://git.llucax.com/mecon/meconlib.git/blobdiff_plain/71acf4950362871b3ad6bc168d08db422edf0509..0768b097733f20adc97c414a107edaf0e469d237:/lib/MECON/HTML/Tabla.php diff --git a/lib/MECON/HTML/Tabla.php b/lib/MECON/HTML/Tabla.php index ca72590..75505e4 100644 --- a/lib/MECON/HTML/Tabla.php +++ b/lib/MECON/HTML/Tabla.php @@ -25,47 +25,61 @@ $Id$ -----------------------------------------------------------------------------*/ require_once 'HTML/Table.php'; +require_once 'MECON/HTML/Image.php'; /** - * Manejo de tablas. - * * Libreria para le manejo de las tablas de los sistemas de intranet. * - * @version $Rev$ - * @author $Author$ */ - -class Tabla extends HTML_Table { - +class MECON_HTML_Tabla extends HTML_Table { + /** * Valores de Configuracion particular * - * @var array + * @var array() $conf + * @access protected */ var $_conf; /** * Atributos de las tablas. * - * @var array + * @var array() attrs + * @access protected */ var $_attrs; /** - * Constructor. + * Íconos e información que va arriba de la tabla. + * + * @var array() + * @access private. + */ + var $_cabecera = array(); + + /** + * Íconos e información que va abajo de la tabla. * + * @var array() + * @access private. + */ + var $_pie = array(); + + /** + * Constructor. * Puede recibir como parametro un string con los atributos que se * quieren dar a la tabla en cuestion. Estos atributos estan * seteados por default segun el archivo de configuracion. + * Ademas puede recibir la indicacion de algun estilo en particular. * - * @param $atributos Atributos diferentes a los estandares para la - * tabla + * @param mixed $atributos Atributos diferentes a los estandares para la tabla + * @param string $estilo Tipo de tabla * * @access public */ - function Tabla($attrs = null) - { - $this->_conf = include 'MECON/HTML/Tabla/conf_Tabla.php'; // Obtengo los valores particulares de configuracion + function MECON_HTML_Tabla($attrs = null, $estilo = 'comun') { + // Obtengo los valores particulares de configuracion. + $this->_conf = include(dirname(__FILE__) . '/Tabla/estilo_' . $estilo . '.php'); // Seteo los atributos para la tabla $this->_attrs = $this->_conf['atributos']['tabla_comun']; //Genero el objeto HTML_Table @@ -87,33 +101,31 @@ class Tabla extends HTML_Table { } } $this->HTML_Table($this->_attrs); + if (isset($attrs['align'])) { + $this->_attrs['align'] = $attrs['align']; + } + } /** - * Agrega una fila del tipo Cabecera - * - * Agrega una fila del tipo cabecera, tomando colores y demas del + * Agrega una fila del tipo cabecera tomando colores y demas del * archivo de configuracion. Recibe como parametro un array con * los datos a incluir en la linea. Agrega tantas columnas como * elementos tenga el array. Si no recibe parametro alguno, * inserta una fila en blanco. Devuelve el identificador de la * fila en donde inserto los datos. * - * @param $contenido Contenido de la fila + * @param array() $contenido Contenido de la fila * * @return int Identificador de Linea - * * @access public * @deprecated */ - function agregarFilaCabecera($contenido = '', $atributos = '') - { + function agregarFilaCabecera($contenido = '', $atributos = '') { return $this->addRow($contenido, 'cabecera'); } /** - * Agrega una fila del tipo Comun - * * Agrega una fila del tipo comun, tomando colores y demas del * archivo de configuracion. Recibe como parametro un array con * los datos a incluir en la linea. Agrega tantas columnas como @@ -121,129 +133,120 @@ class Tabla extends HTML_Table { * inserta una fila en blanco. Devuelve el identificador de la * fila en donde inserto los datos. * - * @param $contenido Contenido de la fila + * @param array() $contenido Contenido de la fila * * @return int Identificador de Linea * * @access public * @deprecated */ - function agregarFila($contenido = '') - { + function agregarFila($contenido = '') { return $this->addRow($contenido, 'comun'); } /** * Modifica el atributo rowSpan a la celda pasada por parametro * - * @param int $fila - * @param int $columna - * @param int $valor + * @param int $fila Identificador de la fila que se quiere modificar + * @param int $columna Identificador de la columna que se quiere modificar + * @param int $valor Atributo a modificar * * @access public * @deprecated */ - function rowSpan($fila, $columna, $valor) - { + function rowSpan($fila, $columna, $valor) { return $this->updateCellAttributes($fila, $columna, 'rowspan="'.$valor.'"'); } /** * Modifica el atributo colSpan a la celda pasada por parametro * - * @param int $fila - * @param int $columna - * @param int $valor + * @param int $fila Identificador de la fila que se quiere modificar + * @param int $columna Identificador de la columna que se quiere modificar + * @param int $valor Atributo a modificar * * @access public * @deprecated */ - function colSpan($fila, $columna, $valor) - { + function colSpan($fila, $columna, $valor) { return $this->updateCellAttributes($fila, $columna, 'colspan="'.$valor.'"'); } /** * Modifica el atributo aling de la celda pasada por parametro * - * @param int $fila - * @param int $columna - * @param string $valor (left, center, right...) + * @param int $fila Identificador de la fila que se quiere modificar + * @param int $columna Identificador de la columna que se quiere modificar + * @param string $valor Atributo a modificar * * @access public * @deprecated */ - function align($fila, $columna, $valor) - { + function align($fila, $columna, $valor) { return $this->updateCellAttributes($fila, $columna, 'align="'.$valor.'"'); } /** * Setea una columna como del tipo cabecera * - * @param int $columna + * @param int $columna Identificador de la columna que se quiere modificar * * @access public * @deprecated */ - function setColCabecera($columna) - { + function setColCabecera($columna) { return $this->updateColAttributes($columna, 'cabecera'); } /** * Setea una columna como del tipo titulo * - * @param int $columna + * @param int $columna Identificador de la columna que se quiere modificar * * @access public * @deprecated */ - function setColTitulo($columna) - { + function setColTitulo($columna) { return $this->updateColAttributes($columna, 'titulo'); } /** * Alinea una columna entera * - * @param int $columna - * @param string $valor + * @param int $columna Identificador de la columna que se quiere modificar + * @param string $valor Valor * * @access public * @deprecated */ - function setColAlign($columna, $valor) - { + function setColAlign($columna, $valor) { return $this->updateColAttributes($columna,'align="'.$valor.'"'); } /** * Cambia el tamanio de una columna entera * - * @param int $columna - * @param string $valor + * @param int $columna Identificadore de la columna que se quiere modificar + * @param string $valor Valor * * @access public * @deprecated */ - function setColWidth($columna, $valor) - { + function setColWidth($columna, $valor) { return $this->updateColAttributes($columna,'width="'.$valor.'"'); } /** * Cambia el color de fondo de una celda * - * @param int $fila - * @param int $columna - * @param string $valor + * @param int $fila Identificador de la fila que se quiere modificar + * @param int $columna Identificador de la columna que se quiere modificar + * @param string $valor Atributo a modificar * * @access public * @deprecated */ - function setCellBgcolor($fila, $columna, $valor) - { + function setCellBgcolor($fila, $columna, $valor) { return $this->updateCellAttributes($fila, $columna,'bgcolor="'.$valor.'"'); } @@ -255,28 +258,61 @@ class Tabla extends HTML_Table { * Si $simple es falso, devuelve el html comun y corriente (con 2 * tablas), si es false devuelve una tabla sola. * - * @param bool $simple + * @param bool $simple Tipo de tabla que se quiere recibir. * * @return string Html * * @access public */ - function toHtml($simple = 0) - { - // Agregar la tabla de fondo. + function toHtml($simple = 0) { if ($simple) { $result = parent::toHtml(); + // Agregar la tabla de fondo. } else { $contenedora = $this->_conf['atributos']['tabla_contenedora']; $contenedora['width'] = $this->getAttribute('width'); + $contenedora['align'] = $this->_attrs['align']; $this->updateAttributes(array('width' => '100%')); $tabla_externa = new HTML_Table($contenedora); $tabla_externa->addRow(array(parent::toHtml()), $this->_conf['atributos']['celda_contenedora']); $result = $tabla_externa->toHtml(); } - - return $result; + // Si tiene pie o cabecera, crea tabla. + if ($this->_cabecera or $this->_pie) { + $tabla_externa = new HTML_Table(array('width'=>'100%','border'=>0)); + } + // Si tiene cabecera, la agrega. + if ($this->_cabecera) { + $tabla_externa->addRow($this->_cabecera, array( + 'valign' => 'middle', + 'width' => '33%', + )); + $tabla_externa->updateCellAttributes(0, 0, array('align' => 'left')); + $tabla_externa->updateCellAttributes(0, 1, array('align' => 'center')); + $tabla_externa->updateCellAttributes(0, 2, array('align' => 'right')); + } + // Si tiene cabecera o pie, agrega la tabla original. + if ($this->_cabecera or $this->_pie) { + //$id = $tabla_externa->addRow($result); + $tabla_externa->addRow(array($result), array( + 'align' => 'center', + 'valign' => 'middle', + 'width' => '100%', + 'colspan' => '3', + )); + } + // Si tiene pie, lo agrega. + if ($this->_pie) { + $id = $tabla_externa->addRow($this->_pie, array( + 'valign' => 'middle', + 'width' => '33%', + )); + $tabla_externa->updateCellAttributes($id, 0, array('align' => 'left')); + $tabla_externa->updateCellAttributes($id, 1, array('align' => 'center')); + $tabla_externa->updateCellAttributes($id, 2, array('align' => 'right')); + } + return ($this->_cabecera or $this->_pie) ? $tabla_externa->toHtml() : $result; } /** @@ -286,15 +322,14 @@ class Tabla extends HTML_Table { * asociativo, se setean los atributos representados por las claves * con los valores. * - * @param int $row - * @param int $col - * @param mixed $attrs + * @param int $row Identificador de la fila que se quiere modificar + * @param int $col Identificador de la columna que se quiere modificar + * @param mixed $attrs Atributo a modificar * * @access public */ - function updateCellAttributes($row, $col, $attrs) - { - return parent::updateCellAttributes($row, $col, $this->_translateAttributes($attrs)); + function updateCellAttributes($row, $col, $attrs) { + return parent::updateCellAttributes($row, $col, $this->_translateAttributes($attrs, false)); } /** @@ -304,15 +339,14 @@ class Tabla extends HTML_Table { * asociativo, se setean los atributos representados por las claves * con los valores. * - * @param int $row - * @param int $col - * @param mixed $attrs + * @param int $row Identificador de la fila que se quiere modificar + * @param int $col Identificador de la columna que se quiere modificar + * @param mixed $attrs Atributo a modificar * * @access public */ - function setCellAttributes($row, $col, $attrs) - { - return parent::setCellAttributes($row, $col, $this->_translateAttributes($attrs)); + function setCellAttributes($row, $col, $attrs) { + return parent::setCellAttributes($row, $col, $this->_translateAttributes($attrs, true)); } /** @@ -321,15 +355,14 @@ class Tabla extends HTML_Table { * Agrega una fila. El contenido es el que viene representado por * el array $content. Recibe los atributos en la variable $attrs * - * @param mixed $content - * @param mixed $attrs + * @param mixed $content Contenido + * @param mixed $attrs Atributos * - * @return int $rowId + * @return int $rowId Identificador de la fila * * @access public */ - function addRow($content, $attrs = 'comun') - { + function addRow($content, $attrs = 'comun') { return parent::addRow($content, $attrs); } @@ -339,22 +372,24 @@ class Tabla extends HTML_Table { * Convierte un atributo HTML al string para pasar a los metodos de HTML_Table * Recibe en $attrs los atributos a modificar. * - * @param string $attrs + * @param mixed $attrs Atributos. + * @param bool $isSet Indica si hay que setear. * - * @return string + * @return array * @access private */ - function _translateAttributes($attrs) - { + function _translateAttributes($attrs, $isSet) { if (!$attrs) { return array(); } if (is_string($attrs)) { $attrs = $this->_parseAttributes($attrs); } - #$rta = array(); - $rta = $this->_conf['atributos']['celda_comun']; - #$sin_estilo = true; + if ($isSet) { + $rta = $this->_conf['atributos']['celda_comun']; + } else { + $rta = array(); + } foreach ($attrs as $attr => $val) { $attr = strtolower($attr); switch ($attr) { @@ -362,7 +397,6 @@ class Tabla extends HTML_Table { case 'comun': case 'cabecera': case 'titulo': - #$sin_estilo = false; $rta = array_merge($rta, $this->_conf['atributos']["celda_$attr"]); break; case 'align': @@ -376,13 +410,13 @@ class Tabla extends HTML_Table { case 'border': case 'cellspacing': case 'cellpadding': + case 'nowrap': $rta[$attr] = $val; break; case 'spacing': case 'padding': $rta["cell$attr"] = $val; break; - case 'nowrap': case 'th': $rta[$attr] = ''; break; @@ -390,13 +424,173 @@ class Tabla extends HTML_Table { trigger_error("No se permite setear el atributo $attr", E_USER_ERROR); } } - // Si no tiene estilo, agrego estilo comun. - #if ($sin_estilo) { - #$rta = $this->_conf['atributos']['celda_comun']; - #} return $rta; } + /** + * Obtiene la Cascade Style Sheet para esta tabla. + * + * @return string Path 'web' a la css. + */ + function getCSS() { + return $this->_conf['css']; + } + + /** + * Setea la cabecera. + * Ejemplo: + * @code + * $tabla->setCabecera(array('Hola', ' ', 'mundo!')); + * @endcode + * + * @param array $cabecera Array de 3 elementos, que son la celda izquierda, + * central y derecha de la cabecera (en ese órden). + */ + function setCabecera($cabecera) { + if (count($pie) != 3) { + $this->raiseError('Parámetro incorrecto: debe ser un array de 3 elementos.'); + } + $this->_cabecera = $cabecera; + } + + /** + * Agrega información a la cabecera de la tabla. + * Ejemplo: + * @code + * $tabla->updateCabecera('Hola', 'izquierda'); + * $tabla->updateCabecera('mundo!', 'derecha'); + * @endcode + * + * @param mixed $cabecera Celda a agregar a la cabecera. Puede ser un string + * o un objeto con un método toHtml(). + * @param string $lugar Lugar en donde poner la cabecera. Puede ser + * 'izquierda', 'centro' o 'derecha'. + */ + function updateCabecera($cabecera, $lugar) { + if (!$this->_cabecera) { + $this->_cabecera = array(' ', ' ', ' '); + } + if ($lugar == 'izquierda') { + $this->_cabecera[0] = $cabecera; + } elseif ($lugar == 'centro') { + $this->_cabecera[1] = $cabecera; + } elseif ($lugar == 'derecha') { + $this->_cabecera[2] = $cabecera; + } else { + $this->raiseError('Parámetro incorrecto: lugar debe ser izquierda, centro o derecha.'); + } + } + + /** + * Setea el pie. + * + * @param array $pie Array de 3 elementos, que son la celda izquierda, + * central y derecha del pie (en ese órden). + * + * @see Ejemplo en setCabecera(). + */ + function setPie($pie) { + if (count($pie) != 3) { + $this->raiseError('Parámetro incorrecto: debe ser un array de 3 elementos.'); + } + $this->_pie = $pie; + } + + /** + * Agrega información al pie de la tabla. + * + * @param mixed $pie Celda a agregar al pie. Puede ser un string + * o un objeto con un método toHtml(). + * @param string $lugar Lugar en donde poner el pie. Puede ser + * 'izquierda', 'centro' o 'derecha'. + * + * @see Ejemplo en updateCabecera(). + */ + function updatePie($pie, $lugar) { + if (!$this->_pie) { + $this->_pie = array(' ', ' ', ' '); + } + if ($lugar == 'izquierda') { + $this->_pie[0] = $pie; + } elseif ($lugar == 'centro') { + $this->_pie[1] = $pie; + } elseif ($lugar == 'derecha') { + $this->_pie[2] = $pie; + } else { + $this->raiseError('Parámetro incorrecto: lugar debe ser izquierda, centro o derecha.'); + } + } + + /** + * Agrega un link predefinido a la cabecera o pie de la tabla. + * Ejemplo: + * @code + * $tabla->addLink('nuevo'); + * $tabla->addLink('volver', new MECON_HTML_Link('atras.php')); + * $tabla->addLink('anterior', new MECON_HTML_Link('previo.php', 'Persona Anterior')); + * $tabla->addLink('siguiente', new MECON_HTML_Link('previo.php', 'Siguiente persona', array('pers' => 'prox'))); + * @endcode + * + * @param string $id Identificador del link predefinido. Puede ser 'volver', + * 'nuevo', 'nuevos', 'anterior' y 'siguiente'. + * @param MECON_HTML_Link $link Link a usar. Si no tiene contenidos, se pone + * uno por defecto. Si es null, se pone como + * link la página actual. + * + */ + function addLink($id, $link = null) { + if (!$link) { + $link = new MECON_HTML_Link($_SERVER['PHP_SELF'], ''); + } + switch ($id) { + case 'nuevo': + $img = new MECON_HTML_Image('/MECON/images/general_nuevo', '-<'); + // Si no tiene titulo, le pone titulo por defecto. + if (!$link->getContents()) { + $link->setContents('Nuevo'); + } + $link->addContents($img); + $this->updateCabecera($link, 'derecha'); + break; + case 'nuevos': + $img = new MECON_HTML_Image('/MECON/images/general_muchos_nuevo', '-<'); + // Si no tiene titulo, le pone titulo por defecto. + if (!$link->getContents()) { + $link->setContents('Nuevos'); + } + $link->addContents($img); + $this->updateCabecera($link, 'derecha'); + break; + case 'siguiente': + $img = new MECON_HTML_Image('/MECON/images/general_posterior', '-<'); + // Si no tiene titulo, le pone titulo por defecto. + if (!$link->getContents()) { + $link->setContents('Siguiente'); + } + $link->addContents($img); + $this->updatePie($link, 'derecha'); + break; + case 'volver': + $img = new MECON_HTML_Image('/MECON/images/general_anterior', '>-'); + // Si no tiene titulo, le pone titulo por defecto. + $cont = $link->getContents() ? $link->getContents() : 'Volver'; + $link->setContents($img); + $link->addContents($cont); + $this->updateCabecera($link, 'izquierda'); + break; + case 'anterior': + $img = new MECON_HTML_Image('/MECON/images/general_anterior', '>-'); + // Si no tiene titulo, le pone titulo por defecto. + $cont = $link->getContents() ? $link->getContents() : 'Anterior'; + $link->setContents($img); + $link->addContents($cont); + $this->updatePie($link, 'izquierda'); + break; + default: + $this->raiseError("No hay un link predefinido llamado '$id'."); + } + } + } ?>