.. _widgetpedia/tools/mdeditor:

MDEditor
========




MDEditor è un editor di testo *markdown*. Presenta un'interfaccia di editing nel più classico formato *markdown* oppure in stile "what you see is what you get", affiancate o presentate in due *tab* distinti.

.. 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/tools/mdeditor", "parsstring": "?_source_viewer=stack&_source_toolbar=f&cm_theme=night", "example_label": "MDEditor base ", "example_name": "mdeditor"} );'>
                MDEditor base 
            </a>
            <div></div>
        </div> 
        

Esiste anche una modalità ``viewer``, in sola lettura, che non presenta la bottoniera degli stili ma che può essere usata per mostrare blocchi di testo già formattati

.. 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/tools/mdeditor", "parsstring": "?_source_viewer=stack&_source_toolbar=f&cm_theme=night", "example_label": "MDEditor con viewer ", "example_name": "viewer"} );'>
                MDEditor con viewer 
            </a>
            <div></div>
        </div> 
        

Reference
---------
Toast UI Editor: https://ui.toast.com/tui-editor

.. raw:: html

 <hr>

**Parametri:**

+------------------------+------+--------------------------------------------------+
|     Nome parametro     | Tipo |                   Descrizione                    |
+========================+======+==================================================+
|value                   |T     |Il valore del campo di testo (es: value='^.text').|
|                        |      |N.B. Se il valore specificato è una Bag e non     |
|                        |      |viene specificato un htmlpath, verranno creati    |
|                        |      |all'interno della Bag due nodi, un nodo "text" e  |
|                        |      |un nodo "html"                                    |
+------------------------+------+--------------------------------------------------+
|htmlpath                |T     |Il path per il contenuto html salvato dall'editor |
|                        |      |(es: htmlpath='.htmltext')                        |
+------------------------+------+--------------------------------------------------+
|width                   |T     |La larghezza dell'editor (es: width='800px')      |
+------------------------+------+--------------------------------------------------+
|height                  |T     |L'altezza dell'editor (es: height='100%')         |
+------------------------+------+--------------------------------------------------+
|placeholder             |T     |Il classico testo di anteprima di un widget       |
+------------------------+------+--------------------------------------------------+
|usageStatistics         |B     |Le statistiche di utilizzo, di default False      |
+------------------------+------+--------------------------------------------------+
|viewer                  |B     |Invece di caricare tutto l'editor, carica solo    |
|                        |      |l'elemento viewer per l'anteprima                 |
+------------------------+------+--------------------------------------------------+
|removeToolbarItems      |T     |La lista di elementi della toolbar dell'editor che|
|                        |      |si desidera rimuovere (es:                        |
|                        |      |removeToolbarItems=['image', 'code'])             |
+------------------------+------+--------------------------------------------------+
|insertToolbarItems      |T     |La lista di elementi della toolbar dell'editor che|
|                        |      |si desidera aggiungere (es:                       |
|                        |      |insertToolbarItems=['image', 'code'])             |
+------------------------+------+--------------------------------------------------+
|maxLength               |L     |Il numero massimo di caratteri consentiti.        |
|                        |      |Comparirà indicato il numero di caratteri         |
|                        |      |rimanenti in alto a destra nell'editor (es:       |
|                        |      |maxLength=1024)                                   |
+------------------------+------+--------------------------------------------------+
|initialEditType         |T     |Permette di indicare quale dei due tab aprire di  |
|                        |      |default, l'editor "markdown" o quello "wysiwyg"   |
+------------------------+------+--------------------------------------------------+
|hideModeSwitch          |B     |Se impostato a True, nasconderà la toolbar        |
|                        |      |inferiore per scegliere la modalità               |
+------------------------+------+--------------------------------------------------+
|previewStyle            |T     |È possibile scegliere tra la modalità preview     |
|                        |      |"tab" o "vertical" (affiancata). Se impostato a   |
|                        |      |"hidden", il tab Preview verrà rimosso del tutto  |
+------------------------+------+--------------------------------------------------+
|colorSyntax             |B     |Se impostato a True mostrerà il selettore per la  |
|                        |      |scelta del colore (di default False)              |
+------------------------+------+--------------------------------------------------+

.. sectionauthor:: Davide Paci

.. raw:: html

   <p style="font-size:0.8em;">Data di pubblicazione 20-08-2024</p>