.. _widgetpedia/grids/cells:

Cells
=====

.. toctree::
   :maxdepth: 1
   :titlesonly:


   cell
   fieldcell



I widget di tipo *cella* si occupano di mostrare dei valori nelle celle di una griglia.

Il loro utilizzo è possibile all'interno di tutte le  :ref:`Grids<widgetpedia/grids/grid>`  di Genropy, nel `TableHandler <https://docs.genropy.org/tablehandler/>`_, nelle `Stampe di griglie <https://docs.genropy.org/stampe/stampe_risorsa/tipi_stampa/multipagina_con_griglia/gridStruct.html>`_.

.. raw:: html

 <hr>

**Parametri:**

+------------------------+------+--------------------------------------------------+
|     Nome parametro     | Tipo |                   Descrizione                    |
+========================+======+==================================================+
|width                   |T     |Consente di definire l'eventuale larghezza di una |
|                        |      |colonna, il valore può essere espresso in px o em.|
+------------------------+------+--------------------------------------------------+
|name                    |T     |è il titolo della colonna che voglio mostrare     |
|                        |      |nell'header, se sto usando fieldcell il suo valore|
|                        |      |di default è letto dagli attributi name_short e   |
|                        |      |name_long della colonna corrispondente, nella     |
|                        |      |definizione del model.                            |
+------------------------+------+--------------------------------------------------+
|text_align              |T     |consente di allineare il testo a sinistra (left,  |
|                        |      |default o center o right)                         |
+------------------------+------+--------------------------------------------------+
|format                  |T     |è una stringa che rappresenta il pattern di       |
|                        |      |formattazione che voglio dare ad un dato di tipo  |
|                        |      |data o numerico. Ad esempio  ``#,###.00``         |
+------------------------+------+--------------------------------------------------+
|dtype                   |T     |è il tipo di dato nella solita codifica. Se si usa|
|                        |      |fieldcell non serve perché il dtype è ricavato dal|
|                        |      |model.                                            |
+------------------------+------+--------------------------------------------------+
|columnset               |T     |ha uno scopo di esclusiva organizzazione visiva   |
|                        |      |e/o logica dei dati e ne consente una maggiore    |
|                        |      |leggibilità in quanto le colonne appartenenti allo|
|                        |      |stesso columnset vengono visualmente raggruppate  |
|                        |      |sotto una sorta di cappelletto colorato           |
+------------------------+------+--------------------------------------------------+
|sort                    |T     |Permette di stabilire il criterio di ordinamento  |
|                        |      |(a=Ascendente, d=discendente) della griglia basato|
|                        |      |sulla colonna in cui viene dichiarato. Ha la      |
|                        |      |precedenza rispetto all'ordinamento eventualmente |
|                        |      |definito nel metodo th_order, che invece è        |
|                        |      |definito a livello di classe View.                |
+------------------------+------+--------------------------------------------------+
|calculated              |B     |Se a un cell assegniamo il parametro              |
|                        |      |calculated=True, la colonna sarà considerata      |
|                        |      |"calcolata" e non sarà quindi presente nelle query|
+------------------------+------+--------------------------------------------------+
|formula                 |T     |Per un cell calcolato, permette di inserire una   |
|                        |      |sintassi javascript per il calcolo (es:           |
|                        |      |formula='voto_si?popolazione_residente:0')        |
+------------------------+------+--------------------------------------------------+
|totalize                |B     |Se impostato a True, specifica se totalizzare i   |
|                        |      |valori della colonna. Alternativamente, in caso   |
|                        |      |per esempio di colonne calcolate, può contenere   |
|                        |      |indicazione dei valori da totalizzare (es:        |
|                        |      |totalize='#FORM.record.mill_si')                  |
+------------------------+------+--------------------------------------------------+
|_customGetter           |T     |Permette di customizzare il contenuto della cella |
|                        |      |e modificarlo tramite un contenuto js (per i      |
|                        |      |dettagli si rimanda alla sezione dedicata)        |
+------------------------+------+--------------------------------------------------+
|rowTemplate             |T     |Permette di modificare la modalità di             |
|                        |      |visualizzazione della cella, inserendo            |
|                        |      |direttamente codice html (es: rowTemplate="<div>$r|
|                        |      |agione_sociale</div><div>$indirizzo</div>")       |
+------------------------+------+--------------------------------------------------+
|semaphore               |B     |Se impostato a True, le celle di tipo booleano    |
|                        |      |verranno mostrate con un semaforo verde se Vero,  |
|                        |      |rosso se Falso                                    |
+------------------------+------+--------------------------------------------------+
|tick                    |B     |Se impostato a True, le celle di tipo booleano    |
|                        |      |verranno mostrate con un segno di spunta se Vero. |
+------------------------+------+--------------------------------------------------+
|three_state             |B     |Se impostato a True, il semaphore avrà tre stati  |
|                        |      |anziché due (rosso e verde più il giallo per i    |
|                        |      |valori nulli)                                     |
+------------------------+------+--------------------------------------------------+
|                                 *CSS Parametri*                                  |
+------------------------+------+--------------------------------------------------+
|classes                 |T     |Le classi css da assegnare alla colonna per intero|
+------------------------+------+--------------------------------------------------+
|cellClasses             |T     |Le classi css da assegnare alle celle             |
+------------------------+------+--------------------------------------------------+
|headerClasses           |T     |Le classi css da assegnare alle testate delle     |
|                        |      |colonne                                           |
+------------------------+------+--------------------------------------------------+

.. sectionauthor:: Davide Paci