Important: This documentation covers Yarn 1 (Classic).
For Yarn 2+ docs and migration guide, see yarnpkg.com.

Package detail

jdm_javascript_dom_manipulator

giacomarco173MIT2.4.2

framework javascript

jdm, javascript, dom, manipulator

readme

Jdm

Classe Jdm che fornisce un framework per la manipolazione del DOM. Permette di creare un elemento DOM, aggiungerlo a un genitore, assegnargli delle classi e manipolarlo in modo ricorsivo, se richiesto. I metodi della classe sono concatenabili per facilitare le operazioni sul DOM.

INSTALLAZIONE:

NPM

npm install jdm_javascript_dom_manipulator

Esempio di utilizzo classico (da inserire prima degli script che usano JDM):

<script src="./dist/jdm.js"></script>

Esempio di utilizzo di un modulo ES6 (NB: usa jdm.es.js):

import './dist/jdm.es.js';

USO

JDM('div', container, ['fooClass','barClass'])

COMPARAZIONE:

jQuery:

const $div = $('<div>', { class: 'foo bar' });
const $ul = $('<ul>');
const $li1 = $('<li>').text('Elemento 1');
const $li2 = $('<li>').text('Elemento 2');
const $li3 = $('<li>').text('Elemento 3');
const $li4 = $('<li>').text('Elemento 4');
const $li5 = $('<li>').text('Elemento 5');
$ul.append($li1, $li2, $li3, $li4, $li5);
$div.append($ul);
$('body').append($div);

JavaScript puro:

const div = 'div';
div.classList.add('foo', 'bar');
const ul = document.createElement('ul');
const li1 = document.createElement('li');
li1.textContent = 'Elemento 1';
const li2 = document.createElement('li');
li2.textContent = 'Elemento 2';
const li3 = document.createElement('li');
li3.textContent = 'Elemento 3';
const li4 = document.createElement('li');
li4.textContent = 'Elemento 4';
const li5 = document.createElement('li');
li5.textContent = 'Elemento 5';
ul.append(li1, li2, li3, li4, li5);
div.appendChild(ul);
document.body.appendChild(div);

Jdm:

const domString = `
<div class="foo bar">
    <ul>
        <li> Elemento 1 </li>
        <li> Elemento 2 </li>
        <li> Elemento 3 </li>
        <li> Elemento 4 </li>
        <li> Elemento 5 </li>
    </ul>
</div>`;
const div = JDM(domString, document.body);

Kind: global class

new Jdm([element], [parent], [classList], [deep], [...args])

Crea una nuova istanza della classe Jdm e manipola l'elemento DOM.

Returns: Jdm - - Restituisce il nodo appena creato o manipolato.

Param Type Default Description
[element] HTMLElement | null L'elemento DOM da manipolare. Se non specificato, verrà creato un nuovo nodo.
[parent] HTMLElement | null Il genitore dell'elemento. Se specificato, l'elemento verrà aggiunto come figlio del genitore.
[classList] Array.<string> | null Una lista di classi da aggiungere all'elemento. Se specificato, verranno aggiunte le classi all'elemento.
[deep] boolean true Se impostato su true, i figli dell'elemento verranno manipolati ricorsivamente.
[...args] * | Altri argomenti opzionali che possono essere passati per la manipolazione del nodo.

Example 

const div = JDM('<div>lorem ipsum</div>', document.body, ['my-class'], true);
// Crea un nuovo div con la classe 'my-class' e lo aggiunge al body

//language=html
const domString = `
    <div class="my-class">
        <p> paragraph </p>
    </div>
    `;
JDM(domString, document.body)
// Crea un nuovo div con la classe 'my-class', un paragrafo child e lo aggiunge tutto al body

jdm.jdm_setAttribute(attribute, [value]) ⇒ Jdm

Imposta un attributo su un elemento DOM e genera un evento personalizzato per il cambiamento.

Kind: instance method of Jdm
Chainable
Returns: Jdm - - Restituisce l'elemento DOM su cui l'attributo è stato impostato, consentendo il chaining dei metodi.

Param Type Default Description
attribute string | Il nome dell'attributo da impostare sull'elemento DOM.
[value] string | null null Il valore dell'attributo. Se non fornito, l'attributo sarà impostato su null.

Example 

const div = JDM('<div>lorem ipsum</div>', document.body)
  .jdm_setAttribute('id', 'myDiv')
  .jdm_setAttribute('data-test', 'foo')
  .jdm_setAttribute('counter', 1);

jdm.jdm_getAttribute(attribute) ⇒ string | null

Recupera il valore di un attributo di un elemento DOM.

Kind: instance method of Jdm
Returns: string | null - - Restituisce il valore dell'attributo se esiste, altrimenti null se l'attributo non è presente.

Param Type Description
attribute string Il nome dell'attributo di cui si desidera ottenere il valore.

Example 

const div = JDM('<div>lorem ipsum</div>', document.body)
 .jdm_setAttribute('data-test', 'foo');
const dataTest = div.jdm_getAttribute('data-test')

jdm.jdm_append(elementList) ⇒ Jdm

Aggiunge uno o più elementi figli a un elemento DOM. Se viene fornita una lista di elementi, tutti gli elementi vengono aggiunti all'elemento DOM.

Kind: instance method of Jdm
Returns: Jdm - - Restituisce l'elemento DOM su cui gli elementi sono stati aggiunti, consentendo il chaining dei metodi.

Param Type Description
elementList HTMLElement | Array.<HTMLElement> Un singolo elemento DOM o un array di elementi DOM da aggiungere come figli.

Example 

const p1 = JDM('<p>paragrafo 1</p>');
const p2 = JDM('<p>paragrafo 2</p>');
const div = JDM('<div>lorem ipsum</div>', document.body)
 .jdm_append([p1, p2]); // Aggiunge entrambi i paragrafi come figli del div.

const span = JDM('span');
div.jdm_append(span); // Aggiunge il singolo elemento span come figlio del div.

jdm.jdm_prepend(elementList) ⇒ Jdm

Aggiunge uno o più elementi figli a un elemento DOM. Se viene fornita una lista di elementi, tutti gli elementi vengono aggiunti come figli dell'elemento. Se viene fornito un singolo elemento, questo viene aggiunto come unico figlio.

Kind: instance method of Jdm
Returns: Jdm - - Restituisce l'elemento DOM su cui gli elementi sono stati aggiunti, consentendo il chaining dei metodi.

Param Type Description
elementList HTMLElement | Array.<HTMLElement> Un singolo elemento DOM o un array di elementi DOM da aggiungere come figli.

Example 

const div = JDM('<div><p>paragrafo</p></div>', document.body);
const span = JDM('<span>foo</span>');
div.jdm_prepend(span);
// Risultato
<div>
    <span>foo</span>
    <p>paragrafo</p>
</div>

jdm.jdm_appendBefore(elementList, elementTarget) ⇒ Jdm

Kind: instance method of Jdm
Returns: Jdm - - Restituisce l'elemento DOM davanti al quale sono stati inseriti gli elementList, consentendo il chaining dei metodi.

Param Type Description
elementList HTMLElement | Array.<HTMLElement> Un singolo elemento DOM o un array di elementi DOM da aggiungere come figli.
elementTarget HTMLElement gli elementi di element list verranno inseriti prima di questo elemento

Example 

const div = JDM('<div></div>', document.body);
const span1 = JDM('<span>foo</span>',div);
const span2 = JDM('<span>bar</span>');
const span3 = JDM('<span>test</span>');
span1.jdm_appendBefore([span2, span3]);
// Risultato
<div>
    <span>bar</span>
    <span>test</span>
    <span>foo</span>
</div>

jdm.jdm_appendAfter(elementList, elementTarget) ⇒ Jdm

Kind: instance method of Jdm
Returns: Jdm - - Restituisce l'elemento DOM dietro il quale sono stati inseriti gli elementList, consentendo il chaining dei metodi.

Param Type Description
elementList HTMLElement | Array.<HTMLElement> Un singolo elemento DOM o un array di elementi DOM da aggiungere come figli.
elementTarget HTMLElement gli elementi di element list verranno inseriti dopo questo elemento

Example 

const div = JDM('<div></div>', document.body);
const span1 = JDM('<span>foo</span>',div);
const span2 = JDM('<span>bar</span>');
const span3 = JDM('<span>test</span>');
span1.jdm_appendAfter([span2, span3]);
// Risultato
<div>
    <span>foo</span>
    <span>bar</span>
    <span>test</span>
</div>

jdm.jdm_addId(id) ⇒ Jdm

Aggiunge un attributo id all'elemento DOM specificato.

Kind: instance method of Jdm
Returns: Jdm - - Restituisce l'elemento DOM su cui è stato impostato l'attributo id, consentendo il chaining dei metodi.

Param Type Description
id string Il valore dell'attributo id da impostare sull'elemento DOM.

Example 

const div = JDM('<div>lorem ipsum</div>', document.body)
.jdm_addId('myDiv'); // Imposta l'attributo id="myDiv" sull'elemento div.

jdm.jdm_addClassList(classList) ⇒ Jdm

Aggiunge una o più classi CSS all'elemento DOM. Se viene fornito un array di classi, tutte le classi vengono aggiunte all'elemento. Se viene fornita una singola classe, questa viene aggiunta come unica classe.

Kind: instance method of Jdm
Returns: Jdm - - Restituisce l'elemento DOM su cui le classi sono state aggiunte, consentendo il chaining dei metodi.

Param Type Description
classList string | Array.<string> Una singola classe CSS o un array di classi CSS da aggiungere all'elemento DOM.

Example 

const div = JDM('<div>lorem ipsum</div>', document.body)
 .jdm_addClassList('myClass'); // Aggiunge la classe "myClass" all'elemento div.

const div2 = JDM('<div>lorem ipsum</div>', document.body)
 .jdm_addClassList(['class1', 'class2']); // Aggiunge "class1" e "class2" all'elemento div2.

jdm.jdm_removeClassList(classList) ⇒ Jdm

Rimuove una o più classi CSS dall'elemento DOM. Se viene fornito un array di classi, tutte le classi vengono rimosse dall'elemento. Se viene fornita una singola classe, questa viene rimossa.

Kind: instance method of Jdm
Returns: Jdm - - Restituisce l'elemento DOM su cui le classi sono state rimosse, consentendo il chaining dei metodi.

Param Type Description
classList string | Array.<string> Una singola classe CSS o un array di classi CSS da rimuovere dall'elemento DOM.

Example 

JDM('<div class="foo bar myClass"></div>', document.body)
 .jdm_removeClassList('myClass'); // Rimuove la classe "myClass" dall'elemento.

JDM('<div class="foo bar myClass"></div>', document.body)
 .jdm_removeClassList(['foo', 'bar']); // Rimuove "foo" e "bar" dall'elemento.

jdm.jdm_toggleClassList(classList) ⇒ Jdm

Attiva o disattiva una o più classi CSS su un elemento DOM. Se viene fornito un array di classi, ciascuna classe verrà alternata (aggiunta se non presente, rimossa se presente). Se viene fornita una singola classe, questa verrà alternata.

Kind: instance method of Jdm
Returns: Jdm - - Restituisce l'elemento DOM su cui le classi sono state alternate, consentendo il chaining dei metodi.

Param Type Description
classList string | Array.<string> Una singola classe CSS o un array di classi CSS da alternare sull'elemento DOM.

Example 

const div = JDM('<div>lorem ipsum</div>', document.body)
.jdm_toggleClassList('active'); // Alterna la classe "active" sull'elemento div.

const div2 = JDM('<div>lorem ipsum</div>', document.body)
.jdm_toggleClassList(['class1', 'class2']); // Alterna le classi "class1" e "class2" sull'elemento div2.

jdm.jdm_findClassList(classList, [some]) ⇒ boolean

Permette di cercare una stringa o un array di stringhe all'interno della classe dell'elemento. Normalmente ritorna true se tutti gli elementi di classList sono presenti nella classe dell'elemento Se "some" è impostato a true cerca se sono presenti alcune classi

Kind: instance method of Jdm
Returns: boolean - - ritorna true o false in base alla ricerca AND o OR

Param Type Default Description
classList string | Array.<string> | Una singola classe CSS o un array di classi CSS da cercare.
[some] boolean false Parametro che permette di scegliere se la ricerca è in AND o OR

Example 

const div = JDM('<div class="bar foo test" >lorem ipsum</div>', document.body)
 .jdm_findClassList(["bar", "foo"]) // ritorna true perchè tutte le classi sono presenti

const div = JDM('<div class="bar foo test" >lorem ipsum</div>', document.body)
 .jdm_findClassList(["bar", "var"], true) // ritorna true perchè bar è presente nelle classi

jdm.jdm_empty() ⇒ Jdm

Svuota il contenuto dell'elemento DOM. A seconda del tipo di elemento, il comportamento di "svuotamento" varia:

  • Per gli elementi input di tipo checkbox o radio, deseleziona l'elemento (imposta checked a false).
  • Per gli altri elementi input o textarea, imposta il valore a null (svuotando il campo di testo).
  • Per un elemento form, esegue il reset del modulo (ripristina tutti i campi al loro stato iniziale).
  • Per altri tipi di elementi, rimuove il contenuto HTML dell'elemento (imposta innerHTML a una stringa vuota).

Kind: instance method of Jdm
Returns: Jdm - - Restituisce l'elemento DOM su cui è stato effettuato lo svuotamento, consentendo il chaining dei metodi.
Example 

const inputText = JDM('input', document.body)
 .jdm_empty(); // Imposta il valore dell'input text a null.

const checkbox = JDM('input', document.body)
 .jdm_setAttribute('type', 'checkbox')
 .jdm_empty(); // Deseleziona la checkbox.

const form = JDM('form').jdm_empty(); // Esegue il reset del modulo.

jdm.jdm_destroy() ⇒ Jdm

Rimuove l'elemento DOM dal documento e genera un evento di distruzione. Questo metodo elimina l'elemento DOM rappresentato da this.node dalla struttura del documento. Inoltre, viene generato un evento personalizzato chiamato "destroy".

Kind: instance method of Jdm
Returns: Jdm - - Restituisce l'elemento DOM che è stato rimosso, consentendo il chaining dei metodi.
Example 

const div = JDM('<div>lorem ipsum</div>', document.body)
 .jdm_destroy(); // Rimuove l'elemento div dal documento e genera un evento "destroy".

jdm.jdm_validate() ⇒ Jdm

Verifica la validità dell'elemento input o form secondo le regole di validazione HTML. Dopo la verifica, viene generato un evento personalizzato chiamato "validate", che segnala il risultato della validazione.

Kind: instance method of Jdm
Returns: Jdm - L'elemento DOM su cui è stata effettuata la validazione, consentendo il chaining dei metodi.
Example 

JDM('input', document.body)
 .jdm_setAttribute('required', 'true')
 .jdm_validate(); // Verifica la validità dell'input e genera l'evento "validate".

jdm.jdm_removeAttribute(attribute) ⇒ Jdm

Rimuove un attributo dall'elemento DOM e genera un evento di rimozione dell'attributo. Questo metodo rimuove l'attributo specificato dall'elemento DOM rappresentato da this.node. Inoltre, viene generato un evento personalizzato chiamato "removeAttribute" con il nome dell'attributo rimosso.

Kind: instance method of Jdm
Returns: Jdm - - Restituisce l'elemento DOM su cui l'attributo è stato rimosso, consentendo il chaining dei metodi.

Param Type Description
attribute string Il nome dell'attributo da rimuovere dall'elemento DOM.

Example 

JDM('<div id="foo">lorem ipsum</div>', document.body)
 .jdm_removeAttribute('id'); // Rimuove l'attributo 'id' dall'elemento div.

jdm.jdm_setStyle(style, value) ⇒ Jdm

Imposta un valore per una proprietà di stile CSS su un elemento DOM. Questo metodo applica una dichiarazione di stile CSS all'elemento DOM rappresentato da this.node.

Kind: instance method of Jdm
Returns: Jdm - - Restituisce l'elemento DOM su cui è stato applicato lo stile, consentendo il chaining dei metodi.

Param Type Description
style string Il nome della proprietà di stile CSS da impostare (ad esempio, "color", "backgroundColor").
value string Il valore da assegnare alla proprietà di stile CSS (ad esempio, "red", "10px").

Example 

const div = JDM('<div>lorem ipsum</div>', document.body)
.jdm_setStyle('color', 'red'); // Imposta il colore del testo dell'elemento div su rosso.

jdm.jdm_extendNode(name, [object]) ⇒ Jdm

Estende l'elemento DOM aggiungendo una proprietà personalizzata. Questo metodo assegna un oggetto o un valore alla proprietà name dell'elemento DOM rappresentato da this.node.

Kind: instance method of Jdm
Returns: Jdm - - Restituisce l'elemento DOM su cui è stata aggiunta la proprietà personalizzata, consentendo il chaining dei metodi.

Param Type Default Description
name string | Il nome della proprietà da aggiungere all'elemento DOM.
[object] Object | null L'oggetto o il valore da associare alla proprietà. Può essere qualsiasi tipo di valore, incluso null.

Example 

const div = JDM('<div>lorem ipsum</div>', document.body)
 .jdm_extendNode('customData', { id: 123, name: 'My Div' });
// Aggiunge la proprietà 'customData' all'elemento div con un oggetto come valore.
console.log(div.customData); // { id: 123, name: 'My Div' }

jdm.jdm_innerHTML(value) ⇒ Jdm

Imposta o restituisce il contenuto HTML interno dell'elemento DOM. Questo metodo imposta il valore di innerHTML dell'elemento DOM rappresentato da this.node. Se il parametro value viene fornito, aggiorna il contenuto HTML; altrimenti, restituisce il contenuto HTML attuale.

Kind: instance method of Jdm
Returns: Jdm - - Restituisce l'elemento DOM con il nuovo contenuto HTML impostato, consentendo il chaining dei metodi.

Param Type Description
value string Il contenuto HTML da impostare all'interno dell'elemento DOM. Se non fornito, il metodo restituirà il contenuto HTML corrente.

Example 

JDM('<div>lorem ipsum</div>', document.body)
 .jdm_innerHTML('<p>Dolor sit amet</p>');
// Imposta il contenuto HTML del div con un nuovo paragrafo.

jdm.jdm_binding(el, [event], [twoWayDataBinding]) ⇒ Jdm

Imposta un binding di dati tra l'elemento corrente e un altro o più elementi. Questo metodo consente di sincronizzare i valori tra gli elementi DOM, abilitando il data binding unidirezionale o bidirezionale. Se un valore cambia nell'elemento sorgente (ad esempio un input), il valore dell'elemento di destinazione (ad esempio un altro input o div) viene aggiornato. Se il binding bidirezionale è abilitato, i cambiamenti sono sincronizzati in entrambe le direzioni.

Kind: instance method of Jdm
Returns: Jdm - - Restituisce l'elemento DOM su cui è stato applicato il binding, consentendo il chaining dei metodi.

Param Type Default Description
el HTMLElement | Array.<HTMLElement> | L'elemento o la lista di elementi con cui si desidera stabilire il binding.
[event] string ""input"" Il tipo di evento da ascoltare per attivare il binding. Default è "input".
[twoWayDataBinding] boolean true Se true, attiva il binding bidirezionale. Se false, il binding sarà unidirezionale.

Example 

const input = JDM('input', document.body);
 const output = JDM('input', document.body);
 input.jdm_binding(output, "input", true);
// Crea un binding unidirezionale tra l'input e l'output, che si attiva sull'evento 'change'.

jdm.jdm_onInput([fn]) ⇒ Jdm

Aggiunge un listener per l'evento input all'elemento DOM. Questo metodo consente di eseguire una funzione di callback ogni volta che si verifica un evento di tipo input sull'elemento.

Kind: instance method of Jdm
Returns: Jdm - - Restituisce l'elemento DOM su cui è stato aggiunto l'event listener, consentendo il chaining dei metodi.

Param Type Default Description
[fn] function () => {} La funzione di callback da eseguire quando si verifica l'evento input. La funzione riceverà l'evento come parametro.

Example 

const input = JDM('input', document.body)
 .jdm_onInput((event) => {
  console.log('Input modificato:', input.jdm_getValue());
});
// Aggiunge un listener per l'evento 'input' che stampa il valore dell'input ogni volta che cambia.

jdm.jdm_onChange([fn]) ⇒ Jdm

Aggiunge un listener per l'evento change all'elemento DOM. Questo metodo consente di eseguire una funzione di callback ogni volta che si verifica un evento di tipo change sull'elemento. L'evento change viene attivato quando il valore di un elemento, come un campo di input, viene modificato e l'elemento perde il focus.

Kind: instance method of Jdm
Returns: Jdm - - Restituisce l'elemento DOM su cui è stato aggiunto l'event listener, consentendo il chaining dei metodi.

Param Type Default Description
[fn] function () => {} La funzione di callback da eseguire quando si verifica l'evento change. La funzione riceverà l'evento come parametro.

Example 

const input = JDM('input', document.body)
 .jdm_onChange(() => {
  console.log('Valore cambiato:', input.jdm_getValue());
});
// Aggiunge un listener per l'evento 'change' che stampa il valore dell'input ogni volta che cambia.

jdm.jdm_onSelect([fn]) ⇒ Jdm

Aggiunge un listener per l'evento select all'elemento DOM. Questo metodo consente di eseguire una funzione di callback ogni volta che si verifica un evento di tipo select sull'elemento. L'evento select viene attivato quando una parte del testo all'interno di un elemento, come un campo di input o una textarea, viene selezionata dall'utente.

Kind: instance method of Jdm
Returns: Jdm - - Restituisce l'elemento DOM su cui è stato aggiunto l'event listener, consentendo il chaining dei metodi.

Param Type Default Description
[fn] function () => {} La funzione di callback da eseguire quando si verifica l'evento select. La funzione riceverà l'evento come parametro.

Example 

const input = JDM('<input>', document.body)
 .jdm_onSelect((event) => {
  console.log('Testo selezionato:', input.jdm_getValue());
});
// Aggiunge un listener per l'evento 'select' che stampa il valore del campo di input ogni volta che viene selezionato del testo.

jdm.jdm_onDebounce([fn], [timeout]) ⇒ Jdm

Aggiunge un listener per l'evento input all'elemento DOM con un meccanismo di debounce. Questo metodo permette di eseguire una funzione di callback solo dopo che l'utente ha smesso di digitare per un determinato periodo di tempo. È utile per evitare l'esecuzione ripetitiva di funzioni (come una ricerca o un aggiornamento) mentre l'utente sta digitando, migliorando le prestazioni.

Kind: instance method of Jdm
Returns: Jdm - - Restituisce l'elemento DOM su cui è stato aggiunto l'event listener, consentendo il chaining dei metodi.

Param Type Default Description
[fn] function () => {} La funzione di callback da eseguire quando si verifica l'evento input. La funzione verrà eseguita dopo che l'utente smette di digitare per un periodo di tempo specificato dal parametro timeout.
[timeout] number 300 Il tempo di attesa (in millisecondi) dopo l'ultimo evento input prima che la funzione di callback venga eseguita. Il valore predefinito è 300 millisecondi.

Example 

const input = JDM('input', document.body)
 .jdm_onDebounce(() => {
     console.log('Input debounced:',input.jdm_getValue());
 }, 500);
// Aggiunge un listener per l'evento 'input' con un debounce di 500 millisecondi,
// evitando chiamate troppo frequenti alla funzione di callback mentre l'utente sta digitando.

jdm.jdm_onClick([fn]) ⇒ Jdm

Aggiunge un listener per l'evento click all'elemento DOM. Questo metodo consente di eseguire una funzione di callback ogni volta che si verifica un evento di tipo click sull'elemento. L'evento click viene attivato quando l'utente clicca su un elemento, come un pulsante o un link.

Kind: instance method of Jdm
Returns: Jdm - - Restituisce l'elemento DOM su cui è stato aggiunto l'event listener, consentendo il chaining dei metodi.

Param Type Default Description
[fn] function () => {} La funzione di callback da eseguire quando si verifica l'evento click. La funzione riceverà l'evento come parametro.

Example 

const button = JDM('<button>CLICK</button>', document.body)
 .jdm_onClick((event) => {
     console.log('Button clicked');
 });
// Aggiunge un listener per l'evento 'click' che stampa un messaggio ogni volta che il pulsante viene cliccato.

jdm.jdm_onRightClick([fn]) ⇒ Jdm

Aggiunge un listener per l'evento contextmenu (clic destro) all'elemento DOM. Questo metodo consente di eseguire una funzione di callback ogni volta che si verifica un evento di tipo contextmenu sull'elemento, che viene attivato dal clic destro del mouse (o equivalente, come il tocco prolungato su dispositivi mobili). L'evento contextmenu è tipicamente usato per visualizzare il menu contestuale di un elemento.

Kind: instance method of Jdm
Returns: Jdm - - Restituisce l'elemento DOM su cui è stato aggiunto l'event listener, consentendo il chaining dei metodi.

Param Type Default Description
[fn] function () => {} La funzione di callback da eseguire quando si verifica l'evento contextmenu. La funzione riceverà l'evento come parametro.

Example 

const element = JDM('<div> RIGHT CLICK </div>', document.body).jdm_onRightClick((event) => {
  event.preventDefault(); // Previene il menu contestuale predefinito
  console.log('Clic destro eseguito!');
});
// Aggiunge un listener per l'evento 'contextmenu' che esegue la funzione di callback ogni volta che si fa clic destro sull'elemento.

jdm.jdm_onDoubleClick([fn]) ⇒ Jdm

Aggiunge un listener per l'evento dblclick (doppio clic) all'elemento DOM. Questo metodo consente di eseguire una funzione di callback ogni volta che si verifica un evento di tipo dblclick sull'elemento, che viene attivato quando l'utente fa doppio clic su un elemento. L'evento dblclick è comunemente utilizzato per azioni che richiedono un'interazione più rapida dell'utente, come l'apertura di un file o l'attivazione di una funzionalità.

Kind: instance method of Jdm
Returns: Jdm - - Restituisce l'elemento DOM su cui è stato aggiunto l'event listener, consentendo il chaining dei metodi.

Param Type Default Description
[fn] function () => {} La funzione di callback da eseguire quando si verifica l'evento dblclick. La funzione riceverà l'evento come parametro.

Example 

const element = JDM('<div>Double click</div>', document.body)
 .jdm_onDoubleClick((event) => {
     console.log('Elemento doppiamente cliccato');
 });
// Aggiunge un listener per l'evento 'dblclick' che esegue la funzione di callback ogni volta che l'utente fa doppio clic sull'elemento.

jdm.jdm_onInvalid([fn]) ⇒ Jdm

Aggiunge un listener per l'evento invalid all'elemento DOM. Questo metodo consente di eseguire una funzione di callback ogni volta che si verifica un evento di tipo invalid sull'elemento, che viene attivato quando un elemento di modulo non soddisfa i suoi vincoli di validazione. L'evento invalid viene in genere generato automaticamente dal browser quando un utente invia un modulo con campi non validi.

Kind: instance method of Jdm
Returns: Jdm - - Restituisce l'elemento DOM su cui è stato aggiunto l'event listener, consentendo il chaining dei metodi.

Param Type Default Description
[fn] function () => {} La funzione di callback da eseguire quando si verifica l'evento invalid. La funzione riceverà l'evento come parametro.

Example 

const formString = `
 <form>
     <input name="inputNumeric" type="number" min="1" max="10" required />
     <button type="submit"> Submit </button>
 </form>`;
 const form = JDM(formString, document.body)
 form.jdm_childNode.inputNumeric
     .jdm_onInvalid((e) => {
         console.log('Il campo input è invalido');
     })
// Aggiunge un listener per l'evento 'invalid' che esegue la funzione di callback quando l'input non è valido.

jdm.jdm_onLoad([fn]) ⇒ Jdm

Aggiunge un listener per l'evento load all'elemento DOM. Questo metodo consente di eseguire una funzione di callback ogni volta che si verifica un evento di tipo load sull'elemento, che viene attivato quando l'elemento o le risorse a esso associate sono completamente caricate. L'evento load viene comunemente utilizzato per monitorare il caricamento di immagini, script o altri contenuti multimediali, ma può essere attivato anche quando una pagina o un elemento è stato completamente caricato nel DOM.

Kind: instance method of Jdm
Returns: Jdm - - Restituisce l'elemento DOM su cui è stato aggiunto l'event listener, consentendo il chaining dei metodi.

Param Type Default Description
[fn] function () => {} La funzione di callback da eseguire quando si verifica l'evento load. La funzione riceverà l'evento come parametro.

Example 

const image = JDM('<img src="https://picsum.photos/200/300" alt="test">', document.body)
 .jdm_onLoad(() => {
     console.log('Immagine caricata con successo');
 });
// Aggiunge un listener per l'evento 'load' che esegue la funzione di callback ogni volta che l'immagine è completamente caricata.

jdm.jdm_onError([fn]) ⇒ Jdm

Aggiunge un listener per l'evento error all'elemento DOM. Questo metodo consente di eseguire una funzione di callback ogni volta che si verifica un evento di tipo error sull'elemento, che viene attivato quando si verifica un errore durante il caricamento di risorse o altre operazioni. L'evento error viene comunemente utilizzato per gestire errori di caricamento, come quando un'immagine non riesce a caricarsi o quando un file JavaScript o CSS non può essere caricato correttamente.

Kind: instance method of Jdm
Returns: Jdm - - Restituisce l'elemento DOM su cui è stato aggiunto l'event listener, consentendo il chaining dei metodi.

Param Type Default Description
[fn] function () => {} La funzione di callback da eseguire quando si verifica l'evento error. La funzione riceverà l'evento come parametro.

Example 

const imgElement = JDM('<img src="invalidUrl" alt="invalid url">', document.body)
     .jdm_onError(() => {
         console.log('Si è verificato un errore nel caricamento dell\'immagine');
     });
// Aggiunge un listener per l'evento 'error' che esegue la funzione di callback ogni volta che si verifica un errore nel caricamento dell'immagine.

jdm.jdm_onSubmit([fn]) ⇒ Jdm

Aggiunge un listener per l'evento submit all'elemento DOM. Questo metodo consente di eseguire una funzione di callback ogni volta che si verifica un evento di tipo submit sull'elemento, che viene attivato quando un modulo viene inviato. L'evento submit viene generato quando un utente invia un modulo, sia tramite il pulsante di invio che premendo il tasto "Enter" in un campo del modulo.

Kind: instance method of Jdm
Returns: Jdm - - Restituisce l'elemento DOM su cui è stato aggiunto l'event listener, consentendo il chaining dei metodi.

Param Type Default Description
[fn] function () => {} La funzione di callback da eseguire quando si verifica l'evento submit. La funzione riceverà l'evento come parametro. Se necessario, la funzione di callback può chiamare event.preventDefault() per prevenire l'invio del modulo.

Example 

const formString = `
 <form>
     <input name="inputNumeric" type="number" min="1" max="10" required />
     <button type="submit"> Submit </button>
 </form>`;
 const form = JDM(formString, document.body)
     .jdm_onSubmit((e)=> {
         e.preventDefault();
         console.log('submit');
     })
// Aggiunge un listener per l'evento 'submit' che esegue la funzione di callback ogni volta che il modulo viene inviato.

jdm.jdm_setValue(value, [tooBoolean]) ⇒ Jdm

Imposta il valore di un elemento DOM. Se l'elemento è una checkbox, un radio button o un modulo, il valore verrà impostato di conseguenza. Se l'elemento è un modulo (<form>), verranno impostati i valori di tutti i campi del modulo, compresi i checkbox e i radio buttons. Inoltre, è possibile forzare il valore a essere trattato come booleano tramite il parametro tooBoolean.

Kind: instance method of Jdm
Returns: Jdm - - Restituisce l'elemento DOM su cui è stato impostato il valore, consentendo il chaining dei metodi.

Param Type Default Description
value any | Il valore da impostare sull'elemento DOM. Il tipo di valore dipende dall'elemento e dal contesto.
[tooBoolean] boolean true Se impostato su true, tenterà di convertire il valore in booleano. Se il valore non è convertibile in booleano, verrà mantenuto il valore originale. Se impostato su false, il valore non verrà modificato.

Example 

const checkboxElement = JDM('<input type="checkbox">', document.body)
 .jdm_setValue(true);
// Imposta il valore di una checkbox su 'true', facendo in modo che sia selezionata.

const data = {
 inputNumeric: 1,
 name: 'foo',
 surname : 'bar'
 }

const formString = `
 <form>
     <input name="inputNumeric" type="number" min="1" max="10"/>
     <input name="name" type="text"/>
     <input name="surname" type="text"/>
     <button type="submit"> Submit </button>
 </form>`;
 const form = JDM(formString, document.body)
     .jdm_setValue(data);
// Imposta i valori del modulo, inclusi i checkbox e altri input.

jdm.jdm_getValue() ⇒ any

Ottiene il valore di un elemento DOM. A seconda del tipo di elemento, il valore verrà restituito in modo appropriato:

  • Input (checkbox, radio): restituisce il valore checked dell'elemento.
  • Form: restituisce un oggetto JSON con i valori di tutti i campi del modulo, supportando strutture di dati complesse come array e oggetti.
  • Select: restituisce il valore selezionato dell'elemento <select>.
  • Altri input (testo, numero, range): restituisce il valore dell'elemento come una stringa.

Kind: instance method of Jdm
Returns: any - - Il valore dell'elemento DOM. Se l'elemento è un modulo, restituisce un oggetto JSON con i dati del modulo.
Example 

const checkboxValue = JDM('<input type="checkbox" checked>', document.body)
 .jdm_getValue();
console.log(checkboxValue); // log true

const data = {
 inputNumeric: 1,
 name: 'foo',
 surname: 'bar'
}

const formString = `
<form>
  <input name="inputNumeric" type="number" min="1" max="10"/>
  <input name="name" type="text"/>
  <input name="surname" type="text"/>
  <button type="submit"> Submit </button>
</form>`;
const form = JDM(formString, document.body)
 .jdm_setValue(data);
 console.log(form.jdm_getValue());
// Restituisce un oggetto JSON con i dati del modulo, es.
// { inputNumeric: '1', name: 'foo', surname: 'bar' }

const selectString = `
<select name="foo">
 <option value="foo">foo</option>
 <option value="bar" selected>bar</option>
</select>`;
const select = JDM(selectString, document.body);
console.log(select.jdm_getValue()); // log 'bar'

jdm.jdm_genEvent(name, [data], [propagateToParents]) ⇒ Jdm

Genera un evento personalizzato per l'elemento DOM associato, utilizzando il metodo di generazione evento definito nella libreria _common. L'evento può essere propagato ai genitori, se necessario.

Kind: instance method of Jdm
Returns: Jdm - - Restituisce il nodo dell'elemento su cui è stato generato l'evento, per consentire il chaining.

Param Type Default Description
name string | Il nome dell'evento da generare. Può essere qualsiasi stringa che rappresenta un tipo di evento personalizzato.
[data] Object | null I dati da associare all'evento. Questi dati vengono passati come parte dell'oggetto evento. Può essere null se non sono necessari dati aggiuntivi.
[propagateToParents] boolean true Un valore booleano che indica se l'evento deve essere propagato ai genitori dell'elemento. Il valore predefinito è true.

Example 

const element = JDM('<input>', document.body)
 .jdm_addEventListener('customEvent', (event)=> {
     console.log(event.detail)
})
element.jdm_genEvent('customEvent', { message: 'Evento generato!' });

jdm.jdm_addEventListener(name, [fn]) ⇒ Jdm

Aggiunge un listener per un evento specificato sull'elemento DOM associato. Consente di eseguire una funzione di callback quando l'evento si verifica.

Kind: instance method of Jdm
Returns: Jdm - - Restituisce il nodo dell'elemento a cui è stato aggiunto l'evento, per consentire il chaining.

Param Type Default Description
name string | Il nome dell'evento per cui aggiungere il listener (es. "click", "input", ecc.).
[fn] function () => {} La funzione di callback che viene eseguita quando l'evento si verifica. Il valore predefinito è una funzione vuota.

Example 

const element = JDM('<div>Click me</div>', document.body)
 .jdm_addEventListener('click', () => {
     console.log('Click!');
 })
 .jdm_addEventListener('contextmenu', () => {
     console.log('Right Click!');
 })

jdm.jdm_removeEventListener(name, [fn]) ⇒ Jdm

Rimuove un listener per un evento specificato sull'elemento DOM associato. Questo metodo permette di interrompere l'esecuzione della funzione di callback quando l'evento si verifica.

Kind: instance method of Jdm
Returns: Jdm - - Restituisce il nodo dell'elemento da cui è stato rimosso l'evento, per consentire il chaining.

Param Type Default Description
name string | Il nome dell'evento per cui rimuovere il listener (es. "click", "input", ecc.).
[fn] function () => {} La funzione di callback che era stata precedentemente aggiunta come listener. Il valore predefinito è una funzione vuota.

Example 

// Rimuovi un listener per l'evento 'click' su un elemento
const element = JDM('<div>lorem ipsum</div>', document.body);
const clickHandler = () => { console.log('Elemento cliccato!'); };
element.jdm_addEventListener('click', clickHandler);
// Dopo un certo punto, rimuoviamo il listener
element.jdm_removeEventListener('click', clickHandler);

// Rimuovi un listener per l'evento 'input' su un elemento con funzione di callback predefinita
element.jdm_removeEventListener('input');

jdm.jdm_extendChildNode() ⇒ Jdm

Estende l'elemento corrente con i nodi figli definiti in jdm_childNode. Se l'elemento ha nodi figli associati a jdm_childNode, questi vengono aggiunti come proprietà dell'elemento stesso.

NB:questo metodo NON funziona sui form

Kind: instance method of Jdm
Returns: Jdm - - Restituisce il nodo dell'elemento a cui sono stati estesi i figli, per consentire il chaining.
Example 

const domString = `
 <div class="foo">
     <div data-name="element1"> Element 1</div>
     <div data-name="element2"> Element 2</div>
     <div data-name="element3"> Element 3</div>
 </div>`;
 const div = JDM(domString, document.body)
  .jdm_extendChildNode();
  console.log(div.element1);
  console.log(div.element2);
  console.log(div.element3);

jdm.jdm_clearAnimations() ⇒ Jdm

Rimuove tutte le animazioni attive sul nodo e ripristina lo stile iniziale.

Kind: instance method of Jdm
Returns: Jdm - - Restituisce il nodo per consentire il chaining.
Example 

JDM(`<div class="foo animated"> Test </div>`, document.body)
     .jdm_clearAnimations();

jdm.jdm_fadeIn([callbackFn], [option]) ⇒ Jdm

Applica un'animazione di fade-in sul nodo.

Kind: instance method of Jdm
Returns: Jdm - - Restituisce il nodo dell'elemento a cui sono stati estesi i figli, per consentire il chaining.

Param Type Default Description
[callbackFn] function | Funzione da eseguire al termine dell'animazione.
[option] Partial.<AnimationOption> new AnimationOption() Opzioni dell'animazione.

Example 

JDM(`<div class="foo"> FadeIn </div>`, document.body)
     .jdm_fadeIn(()=> {console.log('test')}, {duration: 2000, direction: 'alternate', iterations:'Infinity'})

jdm.jdm_fadeInDown([callbackFn], [option]) ⇒ Jdm

Applica un'animazione tipo fadeInDown al nodo .

Kind: instance method of Jdm
Returns: Jdm - - Restituisce il nodo dell'elemento a cui sono stati estesi i figli, per consentire il chaining.

Param Type Default Description
[callbackFn] function | Funzione da eseguire al termine dell'animazione.
[option] Partial.<AnimationOption> new AnimationOption() Opzioni dell'animazione.

Example 

JDM(`<div class="foo"> FadeInDown </div>`, document.body)
     .jdm_fadeInDown(() => console.log('done'), { duration: 1000, easing: 'ease-out' });

jdm.jdm_fadeInUp([callbackFn], [option]) ⇒ Jdm

Applica un'animazione tipo fadeInUp al nodo .

Kind: instance method of Jdm
Returns: Jdm - - Restituisce il nodo dell'elemento a cui sono stati estesi i figli, per consentire il chaining.

Param Type Default Description
[callbackFn] function | Funzione da eseguire al termine dell'animazione.
[option] Partial.<AnimationOption> new AnimationOption() Opzioni dell'animazione.

Example 

JDM(`<div class="foo"> FadeInUp </div>`, document.body)
     .jdm_fadeInUp(() => console.log('Fade in up concluso'), { duration: 800 });

jdm.jdm_fadeInLeft([callbackFn], [option]) ⇒ Jdm

Applica un'animazione tipo fadeInLeft al nodo .

Kind: instance method of Jdm
Returns: Jdm - - Restituisce il nodo dell'elemento a cui sono stati estesi i figli, per consentire il chaining.

Param Type Default Description
[callbackFn] function | Funzione da eseguire al termine dell'animazione.
[option] Partial.<AnimationOption> new AnimationOption() Opzioni dell'animazione.

Example 

JDM(`<div class="foo"> FadeInLeft </div>`, document.body)
     .jdm_fadeInLeft(() => console.log('Fade in left concluso'), { duration: 800 });

jdm.jdm_fadeInRight([callbackFn], [option]) ⇒ Jdm

Applica un'animazione tipo fadeInRight al nodo .

Kind: instance method of Jdm
Returns: Jdm - - Restituisce il nodo dell'elemento a cui sono stati estesi i figli, per consentire il chaining.

Param Type Default Description
[callbackFn] function | Funzione da eseguire al termine dell'animazione.
[option] Partial.<AnimationOption> new AnimationOption() Opzioni dell'animazione.

Example 

JDM(`<div class="foo"> FadeInRight </div>`, document.body)
     .jdm_fadeInRight(() => console.log('Fade in right concluso'), { duration: 800 });

jdm.jdm_fadeOut([callbackFn], [option]) ⇒ Jdm

Applica un'animazione di fade-out sul nodo.

Kind: instance method of Jdm
Returns: Jdm - - Restituisce il nodo dell'elemento a cui sono stati estesi i figli, per consentire il chaining.

Param Type Default Description
[callbackFn] function | Funzione da eseguire al termine dell'animazione.
[option] Partial.<AnimationOption> new AnimationOption() Opzioni dell'animazione.

Example 

JDM(`<div class="foo"> FadeOut </div>`, document.body)
     .jdm_fadeOut(()=> {console.log('test')}, {duration: 2000, direction: 'alternate', iterations:'Infinity'})

jdm.jdm_fadeOutRight([callbackFn], [option]) ⇒ Jdm

Applica un'animazione di fade out right sul nodo.

Kind: instance method of Jdm
Returns: Jdm - - Restituisce il nodo dell'elemento a cui sono stati estesi i figli, per consentire il chaining.

Param Type Default Description
[callbackFn] function | Funzione da eseguire al termine dell'animazione.
[option] Partial.<AnimationOption> new AnimationOption() Opzioni dell'animazione.

Example 

JDM(`<div class="foo"> FadeOutRight </div>`, document.body)
     .jdm_fadeOutRight(()=> {console.log('test')}, {duration: 2000, direction: 'alternate', iterations:'Infinity'})

jdm.jdm_fadeOutUp([callbackFn], [option]) ⇒ Jdm

Applica un'animazione di fade out up sul nodo.

Kind: instance method of Jdm
Returns: Jdm - - Restituisce il nodo dell'elemento a cui sono stati estesi i figli, per consentire il chaining.

Param Type Default Description
[callbackFn] function | Funzione da eseguire al termine dell'animazione.
[option] Partial.<AnimationOption> new AnimationOption() Opzioni dell'animazione.

Example 

JDM(`<div class="foo"> FadeOutUp </div>`, document.body)
     .jdm_fadeOutUp(()=> {console.log('test')}, {duration: 2000, direction: 'alternate', iterations:'Infinity'})

jdm.jdm_fadeOutDown([callbackFn], [option]) ⇒ Jdm

Applica un'animazione di fade out down sul nodo.

Kind: instance method of Jdm
Returns: Jdm - - Restituisce il nodo dell'elemento a cui sono stati estesi i figli, per consentire il chaining.

Param Type Default Description
[callbackFn] function | Funzione da eseguire al termine dell'animazione.
[option] Partial.<AnimationOption> new AnimationOption() Opzioni dell'animazione.

Example 

JDM(`<div class="foo"> FadeOutDown </div>`, document.body)
     .jdm_fadeOutDown(()=> {console.log('test')}, {duration: 2000, direction: 'alternate', iterations:'Infinity'})

jdm.jdm_fadeOutLeft([callbackFn], [option]) ⇒ Jdm

Applica un'animazione di fade out left sul nodo.

Kind: instance method of Jdm
Returns: Jdm - - Restituisce il nodo dell'elemento a cui sono stati estesi i figli, per consentire il chaining.

Param Type Default Description
[callbackFn] function | Funzione da eseguire al termine dell'animazione.
[option] Partial.<AnimationOption> new AnimationOption() Opzioni dell'animazione.

Example 

JDM(`<div class="foo"> FadeOutLeft </div>`, document.body)
     .jdm_fadeOutLeft(()=> {console.log('test')}, {duration: 2000, direction: 'alternate', iterations:'Infinity'})

jdm.jdm_bounce([callbackFn], [option]) ⇒ Jdm

Applica un'animazione tipo bounce al nodo (come in animate.css).

Kind: instance method of Jdm
Returns: Jdm - - Restituisce il nodo dell'elemento a cui sono stati estesi i figli, per consentire il chaining.

Param Type Default Description
[callbackFn] function | Funzione da eseguire al termine dell'animazione.
[option] Partial.<AnimationOption> new AnimationOption() Opzioni dell'animazione.

Example 

JDM(`<div class="foo"> Bounce </div>`, document.body)
     .jdm_bounce(() => console.log('Bounce completato!'), { duration: 1000 });

jdm.jdm_tada([callbackFn], [option]) ⇒ Jdm

Applica un'animazione tipo tada al nodo (come in animate.css).

Kind: instance method of Jdm
Returns: Jdm - - Restituisce il nodo dell'elemento a cui sono stati estesi i figli, per consentire il chaining.

Param Type Default Description
[callbackFn] function | Funzione da eseguire al termine dell'animazione.
[option] Partial.<AnimationOption> new AnimationOption() Opzioni dell'animazione.

Example 

JDM(`<div class="foo"> Tada </div>`, document.body)
     .jdm_tada(() => console.log('Tada completato!'), { duration: 1000 });

jdm.jdm_zoomIn([callbackFn], [option]) ⇒ Jdm

Applica un'animazione di zoom-in e fade-in al nodo.

Kind: instance method of Jdm
Returns: Jdm - - Restituisce il nodo dell'elemento a cui sono stati estesi i figli, per consentire il chaining.

Param Type Default Description
[callbackFn] function | Funzione da eseguire al termine dell'animazione.
[option] Partial.<AnimationOption> new AnimationOption() Opzioni dell'animazione.

Example 

JDM(`<div class="foo"> ZoomIn </div>`, document.body)
     .jdm_zoomIn(() => console.log('ZoomIn completato!'), { duration: 1000 });

jdm.jdm_zoomOut([callbackFn], [option]) ⇒ Jdm

Applica un'animazione di zoom-out e fade-out al nodo.

Kind: instance method of Jdm
Returns: Jdm - - Restituisce il nodo dell'elemento a cui sono stati estesi i figli, per consentire il chaining.

Param Type Default Description
[callbackFn] function | Funzione da eseguire al termine dell'animazione.
[option] Partial.<AnimationOption> new AnimationOption() Opzioni dell'animazione.

Example 

JDM(`<div class="foo"> ZoomOut </div>`, document.body)
     .jdm_zoomOut(() => console.log('ZoomOut!'), { duration: 1000 });

jdm.jdm_rotation([callbackFn], [deg], [option]) ⇒ Jdm

Applica un'animazione di rotazione all'elemento.

Kind: instance method of Jdm
Returns: Jdm - - Restituisce il nodo dell'elemento a cui sono stati estesi i metodi, per consentire il chaining.

Param Type Default Description
[callbackFn] function | Funzione da eseguire al termine dell'animazione.
[deg] number 360 Gradi di rotazione da applicare (positivi in senso orario, negativi in senso antiorario).
[option] Partial.<AnimationOption> new AnimationOption() Opzioni dell'animazione.

Example 

JDM(`<div class="foo"> Rotate </div>`, document.body)
     .jdm_rotation(() => console.log('Rotazione completata'), 180, { duration: 1000 });