Interacturar con las Vistas

Las vistas XML permite controlar los objetos de la pantalla de manera simple. Vamos a ver algunos ejemplos de como acceder y variar la configuración desde nuestro controlador de una columna y de su widget. Primero recordar dos conceptos, que los controladores extendidos son contenedores de vistas ($this->views) y que el proceso de carga se realiza según el patrón:

  • Añadir vista: Carga la configuración de la vista para el usuario activo.
  • Cargar datos: Se realiza la lectura de los datos del modelo de la vista.
  • Pintado de la vista: Mediante plantilla de twig se compone y visualiza la vista al usuario.

Hay dos procesos donde estan cargados los datos de configuración de la vista pudiendo alterarlos antes de que el usuario reciba la vista.

Seleccionar columnas

Una vez cargada la vista, para poder modificar la configuración de una columna y/o de su widget primero debemos acceder o seleccionar la columna. Para esto la vista tiene dos métodos donde obtenemos un objeto de la clase ColumnItem:

  • columnForField: Devuelve la columna que tiene el fieldname igual al indicado.
  • columnForName: Devuelve la columna que tiene por 'name' el indicado.
// Establece el tamaño de la columna en 6 y amplia el nivel de seguridad a 50
$column1 = $this->views['Nombre_de_Vista']->columnForField('Nombre_del_campo');
$column1->numColumns = 6;
$column1->level = 50;

// Establece una longitud máxima de los datos a 50 caracteres
$column2 = $this->views['Nombre_de_Vista']->columnForName('Nombre_de_la_columna');
$column2->widget->maxLenght = 50;

Apagar y encender columnas

Aunque podemos activar y desactivar columnas mediante la propiedad readOnly del widget de la columna (es decir, seleccionamos la columna y accedemos a la propiedad del widget), existe un método más directo desde la vista. Para ello usaremos el método disableColumn informando del name de la columna en el archivo xml y de si deseamos que esté o no en disabled.

// Disable mediante Widget (NO RECOMENDADO)
$column = $this->views['Nombre_de_Vista']->columnForField('Nombre_del_campo');
$column->widget->readonly = 'true';

// Disable mediante Vista (RECOMENDADO)
$this->views['Nombre_de_Vista']->disableColumn('Nombre_de_la_columna', true);

Seleccionar filtros en ListController

Para controladores que heredan de ListController es posible personalizar o alterar los filtros añadidos a una vista. Debemos seleccionar la vista y luego seleccionar el filtro consultando la propiedad filters que contiene un array con cada uno de los filtros definidos (un array de BaseFilter). Para seleccionar el filtro utilizaremos el nombre que indicamos como key al añadirlo a la vista.

// Ejemplo de carga manual de valores en filtros de tipo select
$companyFilter = $this->views['ListEmployee']->filters['company'];
$companyFilter->options['values'] = $this->codeModel->all('empresas', 'idempresa', 'nombre');

$departmentsFilter = $this->views['ListEmployee']->filters['company'];
$departmentsFilter->options['values'] = $this->codeModel->all('departments', 'id', 'name');

// Ejemplo de captura del valor del filtro
$companyFilter = $this->views['ListEmployee']->filters['company'];
if ($companyFilter->value !== '') {
    [ ... nuestras instrucciones php ... ]
}

Añadir botones de acción

También puede añadir un botón de acción simplemente usando el método addButton(). Por ejemplo este botón que redirige al controlador EditProducto.

$this->addButton('ListProducto', [
        'action' => 'EditProducto',
        'icon' => 'fas fa-plus',
        'label' => 'new',
        'type' => 'link'
]);

Tiene más detalles sobre los botones en la sección de row actions.


  Siguiente

Necesita identificarse para continuar con esta acción. Haga clic en iniciar sesión o cree una cuenta.

Iniciar sesión
neorazorx_1
neorazorx_1
4718 Puntos 8 años
Fecha de creación 19-10-2018 00:00:00
Última actualización 14-10-2019
Contador de visitas 1179
Curso básico de usuario

Con este curso aprenderá a gestionar el día a día de su negocio con FacturaScripts 2021: hacer facturas, albaranes, pedidos y presupuestos. Gestionar clientes, proveedores y tarifas. Y a realizar la regularización de impuestos (trimestre de IVA). ¿A quién va dirigido? A cualquier usuario que ya tenga FacturaScripts instalado en su PC o hosting y quiera aprender rápidamente el manejo diario del programa. ¿Qué incluye? 18 lecciones con 17 vídeos explicativos.

214 4,99 €
Curso básico de programación

Con este curso aprenderá cómo crear un plugin sencillo para FacturaScripts 2021: añadir nuevas páginas, tablas y columnas. Para entender este curso no se necesita mucha experiencia en programación, le enseñaremos los básico para modelar problemas sencillos. ¿A quién va dirigido? A cualquier persona con unos conocimientos muy básicos de programación. ¿Qué incluye? 18 lecciones con 14 vídeos explicativos.

214 8,99 €
Sesiones de programación 2021

Esta es una recopilación de vídeos y documentación de pequeños desarrollos sobre FacturaScripts 2021 y sus plugins. Perfecto para expandir tus conocimientos de programación. ¿A quién va dirigido? A personas que ya hayan superado el curso básico de programación y busquen ampliar sus conocimientos. ¿Qué incluye? 9 lecciones con 9 vídeos explicativos (más de 5 horas de vídeos) y el código fuente de los ejemplos. Novedades mensuales: Este curso se amplía cada mes con nuevas lecciones.

34 14,99 €

Copyright (c) 2013-2021 FacturaScripts