.. _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 `_
.. raw:: html
.. raw:: html
**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