* Cada elemento del array es a su vez un array cuyo primer elemento es el
* formato del texto a agregar (tipo printf()) y el segundo es un array con los
* campos de la DB a utilizar para ese formato en una fila dada.
+ * Cuando se utiliza una callback para "dibujar" el campo, el campo puede
+ * ser un array de campos de la base que se quiere pasar a la callback.
*/
var $_prependRowsData = array();
$this->addRowsResult($result, $campos, $obj);
}
} else {
- $id = $this->addRow(array(new MECON_HTML_Error("No se encontraron {$this->_desc}.")));
- $this->updateCellAttributes($id, 0, array('colspan' => count($campos)));
+ $id = $this->addRow(array(
+ new MECON_HTML_Error("No se encontraron {$this->_desc}.")));
+ $this->updateCellAttributes($id, 0,
+ array('colspan' => count($campos)
+ + count($this->_prependRowsData)
+ + count($this->_appendRowsData)));
}
}
* array('nombre', 'nombre', 'apellido'));
* // Agrega resultados de la tabla.
* $tabla->addRows($result, array('nombre', 'apellido'));
+ *
+ *
+ * //Ejemplo utilizando una funcion callback con varios parametros obtenidos
+ * //de la DB.
+ * $tabla->addRowsData (
+ * 'Mi nombre es: %s, por lo tanto %s', //Formato de la columna a agregar.
+ * array( //Array de campos a incluir en el formato
+ * 'nombre', //El dato de este campo reemplazara el primer %s
+ * //El resultado de la llamada a la funcion nombre_callback que tomo
+ * //como paramteros los campos de la db que estan dentro del array
+ * //reemplazara al segundo %s
+ * array(array('nombre', 'apellido'), 'nombre_callback')
+ * )
+ * );
+ *
* $tabla->display();
+ *
+ * // Funcion callback para darle formato al campo 'activo'.
+ * // En este caso devuelve 'checked' para indicar que el checkbox está
+ * // activado si activo es true.
+ * function checked_callback($activo) {
+ * return $activo ? 'checked' : '';
+ * }
+ *
+ * //Funcion callback que acepta mas de un parametro en un array
+ * function nombre_callback($parametros) {
+ * if ($parametros['nombre'] == 'Juan Carlos' &&
+ * $parametros['apellido'] == 'Gomez') {
+ * return 'soy Charly';
+ * }
+ * else {
+ * return 'no soy Charly';
+ * }
+ * }
+ *
* @endcode
*
* @param mixed $format Si es un string, especifica el formato a usar al
* un campo a usar:
* @code $tabla->addRowsData('%s',
* array('campo1', 'campo2'); @endcode
- * o un array cuyo primer elemento es el nombre del
- * campo a usar y el segundo argumento es una funcion
- * callback a llamar con el valor del campo como
+ * o un array cuyo primer elemento es un string o un
+ * array con los nombres de los campos de la db a utilizar
+ * y el segundo argumento es una funcion
+ * callback a llamar con el valor del campo (o los
+ * campos si se paso un array de campos) como
* argumento para darle formato:
* @code $tabla->addRowsData('%s',
- * array('campo1', 'campo2', array('campo3', 'callback_campo3'))));
- * function callback_campo3($campo3) {
- * return strtoupper($campo3);
+ * array('campo1', array(array('campo2', 'campo3'), 'callback_campo_2_3'))));
+ * function callback_campo_2_3($campos) {
+ * return strtoupper($campos['campo2']) . ', ' . strtolower($campos['campo3']);
* } @endcode
+ * Para ver un ejemplo de una callback con muchos
+ * parametros ver la descripcion detallada de esta funcion.
* Si no se encuentra la funcion callback, se toma como
* un string para formatear el campo con sprintf():
* @code $tabla->addRowsData('%s', array('campo1',
*
* @param array $data Datos sobre la columna, en el formato especificado
* para un elemento del array usado en _prependRowsData.
- * @param mixed $row Fila de un resultado de una base de dotos. Puede ser un
+ * @param mixed $row Fila de un resultado de una base de datos. Puede ser un
* array asociativo o un objeto (en cuyo caso cada campo
* debe ser un atributo del mismo).
*
list($campo, $callback) = $campo;
}
if (is_array($row)) {
- $campo = $row[$campo]; // Es un campo de un array.
- } else {
- $campo = $row->$campo; // Es un atributo de un objeto.
+ if (is_array($campo)) {
+ foreach ($campo as $c) {
+ $tmp[$c] = $row[$c];
+ }
+ $campo = $tmp;
+ }
+ else {
+ $campo = $row[$campo]; // Es un campo de un array.
+ }
+ } else { //$row es un objeto
+ if (is_array($campo)) {
+ foreach ($campo as $c) {
+ $tmp[$c] = $row->$c;
+ }
+ $campo = $tmp;
+ }
+ else {
+ $campo = $row->$campo; // Es un atributo de un objeto.
+ }
}
// Si usa callback, cambio el campo por el resultado del
// llamado a su callback.
- if (isset($callback) and function_exists($callback)) {
- $campo = $callback($campo);
+ if (isset($callback)) {
+ if(function_exists($callback)) {
+ $campo = $callback($campo);
+ } else {
+ //Si no existe la funcion de callback usa el callback como
+ //formato y los campos como argumentos para el sprintf
+ array_unshift($campo, $callback);
+ $campo = call_user_func_array('sprintf', $campo);
+ }
}
// Agrego argumento procesado a la lista de argumentos.
$args[] = $campo;
projects / mecon / meconlib.git / blobdiff