.. _widgetpedia/elements/html/div:

div
===




Il ``div`` è l'elemento html più semplice che ci sia. Può essere utilizzato per mostrare in un qualsiasi spazio un contenuto in forma testuale di qualsiasi natura o come contenitore di altri widget. È preceduto da un'etichetta *lbl* e può contenere un testo inserito come stringa o un valore specificato in un determinato path::

  fb = pane.formbuilder(cols=2, margin='10px')
        fb.div('Compila i seguenti parametri',colspan=2)
        
  fb = pane.formbuilder(cols=2, margin='10px')
        fb.data('.name', 'John Brown')
        fb.div('^.name', lbl='Nome')
        
Segue lista di alcuni div speciali e dei parametri più utilizzati. Si noti che la lista è da intendersi indicativa e non esaustiva, in quanto al div possono essere assegnati *tutti* i parametri di stile utilizzabili in html, con il solo accorgimento che invece di utilizzare il trattino alto si dovrà utilizzare il trattino basso (es: *border_style* invece di *border-style*)

Semaphore
---------
Il div può essere utilizzato per visualizzare un campo booleano a tre stati (vero, falso, nullo) sotto forma di semaforo. La sintassi per questo tipo di utilizzo è la seguente::

  fb.div('^.iscritto_newsletter', lbl='Iscritto alla newsletter', format='semaphore', dtype='B')
  
O nella sua forma più compatta::

  fb.semaphore('^.iscritto_newsletter', lbl='Iscritto alla newsletter')

Per una trattazione più esaustiva si rimanda all'articolo dedicato sul nostro Blog: `Come usare i semafori con i booleani a tre stati <https://www.genropy.org/blog/come-usare-i-semafori-con-i-booleani-a-tre-stati>`_

.. raw:: html

    <hr>

.. raw:: html

 <hr>

**Parametri:**

+------------------------+------+--------------------------------------------------+
|     Nome parametro     | Tipo |                   Descrizione                    |
+========================+======+==================================================+
|style                   |T     |Permette di passare tutti gli attributi di stile  |
|                        |      |html come unico parametro                         |
+------------------------+------+--------------------------------------------------+
|value                   |T     |Il valore del div, può essere una stringa testuale|
|                        |      |o un valore presente a un determinato path        |
+------------------------+------+--------------------------------------------------+
|lbl                     |T     |L'etichetta testuale che precede il contenuto del |
|                        |      |div                                               |
+------------------------+------+--------------------------------------------------+
|font_size               |T     |Dimensione del carattere                          |
+------------------------+------+--------------------------------------------------+
|font_weight             |T     |Peso del font                                     |
+------------------------+------+--------------------------------------------------+
|font_style              |T     |Stile del font                                    |
+------------------------+------+--------------------------------------------------+
|margin                  |T     |Definizione dei margini                           |
+------------------------+------+--------------------------------------------------+
|padding                 |T     |Definizione dei padding                           |
+------------------------+------+--------------------------------------------------+
|border\_                |T     |Definizione dei bordi                             |
+------------------------+------+--------------------------------------------------+
|                                 *Html Parametri*                                 |
+------------------------+------+--------------------------------------------------+
|_class                  |T     |Permette di assegnare una specifica classe CSS al |
|                        |      |widget                                            |
+------------------------+------+--------------------------------------------------+
|height                  |T     |Permette di assegnare un'altezza al widget        |
+------------------------+------+--------------------------------------------------+
|width                   |T     |Permette di assegnare una larghezza al widget     |
+------------------------+------+--------------------------------------------------+
|border                  |T     |Permette di assegnare un bordo al widget          |
+------------------------+------+--------------------------------------------------+
|rounded                 |L     |Permette di assegnare un arrotondamento al widget |
+------------------------+------+--------------------------------------------------+
|background              |T     |Permette di assegnare uno sfondo al widget        |
+------------------------+------+--------------------------------------------------+
|                                 *HTML Parametri*                                 |
+------------------------+------+--------------------------------------------------+
|disabled                |B     |Permette di disabilitare il campo. Es:            |
|                        |      |disabled=True                                     |
+------------------------+------+--------------------------------------------------+

.. sectionauthor:: Davide Paci

.. raw:: html

   <p style="font-size:0.8em;">Data di pubblicazione 09-02-2021</p>