.. _widgetpedia/elements/html/button:

button
======




Il bottone altro non è che il classico bottone HTML, al clic del quale è possibile innescare un'azione. Il bottone riceve come parametro una ``label``, generalmente implicita, e tutta una serie di *kwargs*.

.. raw:: html

 <div class="gnrexamplebox">
            <a class="gnrexamplebox_title" onclick='gnrExampleIframe(this.nextElementSibling,{"height": 200, "width": "100%", "examples_root": "https://dev.genropy.org/webpages/docu_examples", "examples_root_local": "", "example_folder": "widgetpedia/elements/html/button", "parsstring": "?_source_viewer=stack&_source_toolbar=f&cm_theme=night", "example_label": "Esempio di bottone semplice ", "example_name": "_base_"} );'>
                Esempio di bottone semplice 
            </a>
            <div></div>
        </div> 
        

.. hint::
  Da una recente *release* di luglio 2021 è diventato possibile collegare direttamente qualsiasi  :ref:`controller<widgetpedia/elements/datastore_elements/controllers>`  a un *button* o *lightbutton*. L'innesco avverrà automaticamente al clic sul bottone, senza quindi la necessità di utilizzare il meccanismo *publish/subscribe* o l'attributo ``fired_``. Si rimanda all'ultimo esempio in questa sezione.
  
slotButton
----------
Un tipo particolare di bottone è lo *slotButton*, nel quale la label funge da **tooltip**.

.. raw:: html

 <div class="gnrexamplebox">
            <a class="gnrexamplebox_title" onclick='gnrExampleIframe(this.nextElementSibling,{"height": 200, "width": "100%", "examples_root": "https://dev.genropy.org/webpages/docu_examples", "examples_root_local": "", "example_folder": "widgetpedia/elements/html/button", "parsstring": "?_source_viewer=stack&_source_toolbar=f&cm_theme=night", "example_label": "slotbutton ", "example_name": "slotbutton"} );'>
                slotbutton 
            </a>
            <div></div>
        </div> 
        

lightButton
-----------
Un altro tipo particolare di bottone è invece il *lightButton*, che ha come caratteristica la **totale assenza di stili**: di conseguenza, appare come un semplice  :ref:`widget "a"<widgetpedia/elements/html/a>` , ovvero un testo che può però innescare un'azione. In alcuni casi può essere utile utilizzare il *lightbutton* per poterne personalizzare al meglio lo stile senza partire da quelli standard del bottone di default.

.. raw:: html

 <div class="gnrexamplebox">
            <a class="gnrexamplebox_title" onclick='gnrExampleIframe(this.nextElementSibling,{"height": 200, "width": "100%", "examples_root": "https://dev.genropy.org/webpages/docu_examples", "examples_root_local": "", "example_folder": "widgetpedia/elements/html/button", "parsstring": "?_source_viewer=stack&_source_toolbar=f&cm_theme=night", "example_label": "lightButton con dataController ", "example_name": "lightbutton"} );'>
                lightButton con dataController 
            </a>
            <div></div>
        </div> 
        

.. raw:: html

 <hr>

**Parametri:**

+------------------------+------+--------------------------------------------------+
|     Nome parametro     | Tipo |                   Descrizione                    |
+========================+======+==================================================+
|label                   |T     |Il testo del bottone, generalmente definito in    |
|                        |      |forma implicita (es: 'Launch')                    |
+------------------------+------+--------------------------------------------------+
|showLabel               |B     |Se impostato a False il bottone non mostrerà      |
|                        |      |l'etichetta                                       |
+------------------------+------+--------------------------------------------------+
|iconClass               |T     |Permette di definire l'icona da usare all'interno |
|                        |      |del bottone                                       |
+------------------------+------+--------------------------------------------------+
|_delay                  |L     |Permette di indicare un ritardo prima dell'innesco|
|                        |      |in millisecondi (es: _delay=50)                   |
+------------------------+------+--------------------------------------------------+
|ask                     |T     |(Deprecato, sostituito da parametro "_ask" del    |
|                        |      |controller)                                       |
+------------------------+------+--------------------------------------------------+
|action                  |T     |(Deprecato, permette di innescare l'azione del    |
|                        |      |bottone (es: action='FIRE .get_result'))          |
+------------------------+------+--------------------------------------------------+
|                                 *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 |
+------------------------+------+--------------------------------------------------+
|style                   |T     |Permette di assegnare uno stile (da esprimersi    |
|                        |      |come serie di attributi CSS) 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