Zona

Una toba_zona es un conjunto de items agrupados alrededor de un dato común llamado Editable. Un ejemplo típico serían las operaciones que giran en torno a un cliente específico. La zona permite agrupar estas operaciones, acceder de una a la otra en forma simple y mostrar un layout gráfico similar en ellas.

El editable puede ser un id de una entidad, un array de valores, una fecha, lo que sea significativo y común a las operaciones que participan. Cuando la zona posee un editable se dice que está cargada (contrariamente si no lo posee está descargada), sólo cuando la zona está cargada muestra sus barras gráficas conteniendo por defecto un menú y una sección descriptiva del editable. La descripción del editable se puede cargar manualmente a través de la herencia o a través de un método php determinado en la definición.

La zona se puede cargar de dos formas:

• Explícitamente dentro del proceso de un pedido de página utilizando el método toba_zona::cargar
• Implícitamente pasando el editable en la URL. Esto se puede hacer:
  • Creando una URL nueva usando toba::vinculador().
  • Modificando un vinculo existente que forma parte de un evento.

Ejemplo

Casi siempre hay una operación que es la encargada de cargar el editable. Por ejemplo a través de un cuadro podemos incluir un evento selección y escucharlo en el ci de la operación:

    <?php
        function evt__cuadro__seleccion($seleccion)
        {
            toba::zona()->cargar($seleccion);
        }
    ?>

A partir de la carga del editable toda navegación entre los ítems de la zona (los iconcitos de la parte superior-derecha) arrastran el editable.

Finalmente existe un método sencillo de descargar la zona:

    toba::zona()->resetear();

Un ejemplo completo se puede encontrar en el proyecto Referencia, ítem Referencia > Zona > Listado Personas.