new Jdm(elementopt, parentopt, classListopt, deepopt, …argsopt) → {JDM}
Crea una nuova istanza della classe Jdm e manipola l'elemento DOM.
Parameters:
| Name | Type | Attributes | Default | Description |
|---|---|---|---|---|
element |
HTMLElement
|
null
|
<optional> |
null | L'elemento DOM da manipolare. Se non specificato, verrà creato un nuovo nodo. |
parent |
HTMLElement
|
null
|
<optional> |
null | Il genitore dell'elemento. Se specificato, l'elemento verrà aggiunto come figlio del genitore. |
classList |
Array.<string>
|
null
|
<optional> |
null | Una lista di classi da aggiungere all'elemento. Se specificato, verranno aggiunte le classi all'elemento. |
deep |
boolean
|
<optional> |
true | Se impostato su `true`, i figli dell'elemento verranno manipolati ricorsivamente. |
args |
*
|
<optional> <repeatable> |
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 bodyMethods
jdm_addClassList(classList) → {HTMLElement}
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.
Parameters:
| Name | Type | Description |
|---|---|---|
classList |
string
|
Array.<string>
|
Una singola classe CSS o un array di classi CSS da aggiungere all'elemento DOM. |
Returns:
- Type:
-
HTMLElement
- Restituisce l'elemento DOM su cui le classi sono state aggiunte, consentendo il chaining dei metodi.
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_addEventListener(name, fnopt) → {Node}
Aggiunge un listener per un evento specificato sull'elemento DOM associato.
Consente di eseguire una funzione di callback quando l'evento si verifica.
Parameters:
| Name | Type | Attributes | Default | Description |
|---|---|---|---|---|
name |
string
|
Il nome dell'evento per cui aggiungere il listener (es. "click", "input", ecc.). | ||
fn |
function
|
<optional> |
() => {} | La funzione di callback che viene eseguita quando l'evento si verifica. Il valore predefinito è una funzione vuota. |
Returns:
- Type:
-
Node
- Restituisce il nodo dell'elemento a cui è stato aggiunto l'evento, per consentire il chaining.
Example
const element = JDM('<div>Click me</div>', document.body)
.jdm_addEventListener('click', () => {
console.log('Click!');
})
.jdm_addEventListener('contextmenu', () => {
console.log('Right Click!');
})jdm_addId(id) → {HTMLElement}
Aggiunge un attributo `id` all'elemento DOM specificato.
Parameters:
| Name | Type | Description |
|---|---|---|
id |
string
|
Il valore dell'attributo `id` da impostare sull'elemento DOM. |
Returns:
- Type:
-
HTMLElement
- Restituisce l'elemento DOM su cui è stato impostato l'attributo `id`, consentendo il chaining dei metodi.
Example
const div = JDM('<div>lorem ipsum</div>', document.body)
.jdm_addId('myDiv'); // Imposta l'attributo id="myDiv" sull'elemento div.jdm_append(elementList) → {HTMLElement}
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.
Parameters:
| Name | Type | Description |
|---|---|---|
elementList |
HTMLElement
|
Array.<HTMLElement>
|
Un singolo elemento DOM o un array di elementi DOM da aggiungere come figli. |
Returns:
- Type:
-
HTMLElement
- Restituisce l'elemento DOM su cui gli elementi sono stati aggiunti, consentendo il chaining dei metodi.
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_binding(el, eventopt, twoWayDataBindingopt) → {HTMLElement}
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.
Parameters:
| Name | Type | Attributes | Default | Description |
|---|---|---|---|---|
el |
HTMLElement
|
Array.<HTMLElement>
|
L'elemento o la lista di elementi con cui si desidera stabilire il binding. | ||
event |
string
|
<optional> |
"input" | Il tipo di evento da ascoltare per attivare il binding. Default è "input". |
twoWayDataBinding |
boolean
|
<optional> |
true | Se `true`, attiva il binding bidirezionale. Se `false`, il binding sarà unidirezionale. |
Returns:
- Type:
-
HTMLElement
- Restituisce l'elemento DOM su cui è stato applicato il binding, consentendo il chaining dei metodi.
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_destroy() → {HTMLElement}
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".
Returns:
- Type:
-
HTMLElement
- 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_empty() → {HTMLElement}
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).
Returns:
- Type:
-
HTMLElement
- 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_extendChildNode() → {Node}
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
Returns:
- Type:
-
Node
- 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_extendNode(name, objectopt) → {HTMLElement}
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`.
Parameters:
| Name | Type | Attributes | Default | Description |
|---|---|---|---|---|
name |
string
|
Il nome della proprietà da aggiungere all'elemento DOM. | ||
object |
Object
|
null
|
<optional> |
null | L'oggetto o il valore da associare alla proprietà. Può essere qualsiasi tipo di valore, incluso `null`. |
Returns:
- Type:
-
HTMLElement
- Restituisce l'elemento DOM su cui è stata aggiunta la proprietà personalizzata, consentendo il chaining dei metodi.
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_fadeIn(optionopt, callbackopt)
Applica un'animazione di fade-in sul nodo.
Parameters:
| Name | Type | Attributes | Default | Description |
|---|---|---|---|---|
option |
object
|
<optional> |
new AnimationOption() | Opzioni dell'animazione. |
callback |
function
|
<optional> |
Funzione da eseguire al termine dell'animazione. |
jdm_genEvent(name, dataopt, propagateToParentsopt) → {Node}
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.
Parameters:
| Name | Type | Attributes | Default | Description |
|---|---|---|---|---|
name |
string
|
Il nome dell'evento da generare. Può essere qualsiasi stringa che rappresenta un tipo di evento personalizzato. | ||
data |
Object
|
null
|
<optional> |
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
|
<optional> |
true | Un valore booleano che indica se l'evento deve essere propagato ai genitori dell'elemento. Il valore predefinito è `true`. |
Returns:
- Type:
-
Node
- Restituisce il nodo dell'elemento su cui è stato generato l'evento, per consentire il chaining.
Example
const element = JDM('<input>', document.body)
.jdm_addEventListener('customEvent', (event)=> {
console.log(event.detail)
})
element.jdm_genEvent('customEvent', { message: 'Evento generato!' });jdm_getAttribute(attribute) → {string|null}
Recupera il valore di un attributo di un elemento DOM.
Parameters:
| Name | Type | Description |
|---|---|---|
attribute |
string
|
Il nome dell'attributo di cui si desidera ottenere il valore. |
Returns:
- Type:
-
string|null
- Restituisce il valore dell'attributo se esiste, altrimenti `null` se l'attributo non è presente.
Example
const div = JDM('<div>lorem ipsum</div>', document.body)
.jdm_setAttribute('data-test', 'foo');
const dataTest = div.jdm_getAttribute('data-test')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 `
Returns:
- Type:
-
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_innerHTML(value) → {HTMLElement}
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.
Parameters:
| Name | Type | Description |
|---|---|---|
value |
string
|
Il contenuto HTML da impostare all'interno dell'elemento DOM. Se non fornito, il metodo restituirà il contenuto HTML corrente. |
Returns:
- Type:
-
HTMLElement
- Restituisce l'elemento DOM con il nuovo contenuto HTML impostato, consentendo il chaining dei metodi.
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_onChange(fnopt) → {HTMLElement}
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.
Parameters:
| Name | Type | Attributes | Default | Description |
|---|---|---|---|---|
fn |
function
|
<optional> |
() => {} | La funzione di callback da eseguire quando si verifica l'evento `change`. La funzione riceverà l'evento come parametro. |
Returns:
- Type:
-
HTMLElement
- Restituisce l'elemento DOM su cui è stato aggiunto l'event listener, consentendo il chaining dei metodi.
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_onClick(fnopt) → {HTMLElement}
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.
Parameters:
| Name | Type | Attributes | Default | Description |
|---|---|---|---|---|
fn |
function
|
<optional> |
() => {} | La funzione di callback da eseguire quando si verifica l'evento `click`. La funzione riceverà l'evento come parametro. |
Returns:
- Type:
-
HTMLElement
- Restituisce l'elemento DOM su cui è stato aggiunto l'event listener, consentendo il chaining dei metodi.
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_onDebounce(fnopt, timeoutopt) → {HTMLElement}
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.
Parameters:
| Name | Type | Attributes | Default | Description |
|---|---|---|---|---|
fn |
function
|
<optional> |
() => {} | 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
|
<optional> |
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. |
Returns:
- Type:
-
HTMLElement
- Restituisce l'elemento DOM su cui è stato aggiunto l'event listener, consentendo il chaining dei metodi.
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_onDoubleClick(fnopt) → {HTMLElement}
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à.
Parameters:
| Name | Type | Attributes | Default | Description |
|---|---|---|---|---|
fn |
function
|
<optional> |
() => {} | La funzione di callback da eseguire quando si verifica l'evento `dblclick`. La funzione riceverà l'evento come parametro. |
Returns:
- Type:
-
HTMLElement
- Restituisce l'elemento DOM su cui è stato aggiunto l'event listener, consentendo il chaining dei metodi.
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_onError(fnopt) → {HTMLElement}
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.
Parameters:
| Name | Type | Attributes | Default | Description |
|---|---|---|---|---|
fn |
function
|
<optional> |
() => {} | La funzione di callback da eseguire quando si verifica l'evento `error`. La funzione riceverà l'evento come parametro. |
Returns:
- Type:
-
HTMLElement
- Restituisce l'elemento DOM su cui è stato aggiunto l'event listener, consentendo il chaining dei metodi.
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_onInput(fnopt) → {HTMLElement}
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.
Parameters:
| Name | Type | Attributes | Default | Description |
|---|---|---|---|---|
fn |
function
|
<optional> |
() => {} | La funzione di callback da eseguire quando si verifica l'evento `input`. La funzione riceverà l'evento come parametro. |
Returns:
- Type:
-
HTMLElement
- Restituisce l'elemento DOM su cui è stato aggiunto l'event listener, consentendo il chaining dei metodi.
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_onInvalid(fnopt) → {HTMLElement}
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.
Parameters:
| Name | Type | Attributes | Default | Description |
|---|---|---|---|---|
fn |
function
|
<optional> |
() => {} | La funzione di callback da eseguire quando si verifica l'evento `invalid`. La funzione riceverà l'evento come parametro. |
Returns:
- Type:
-
HTMLElement
- Restituisce l'elemento DOM su cui è stato aggiunto l'event listener, consentendo il chaining dei metodi.
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_onLoad(fnopt) → {HTMLElement}
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.
Parameters:
| Name | Type | Attributes | Default | Description |
|---|---|---|---|---|
fn |
function
|
<optional> |
() => {} | La funzione di callback da eseguire quando si verifica l'evento `load`. La funzione riceverà l'evento come parametro. |
Returns:
- Type:
-
HTMLElement
- Restituisce l'elemento DOM su cui è stato aggiunto l'event listener, consentendo il chaining dei metodi.
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_onRightClick(fnopt) → {HTMLElement}
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.
Parameters:
| Name | Type | Attributes | Default | Description |
|---|---|---|---|---|
fn |
function
|
<optional> |
() => {} | La funzione di callback da eseguire quando si verifica l'evento `contextmenu`. La funzione riceverà l'evento come parametro. |
Returns:
- Type:
-
HTMLElement
- Restituisce l'elemento DOM su cui è stato aggiunto l'event listener, consentendo il chaining dei metodi.
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_onSelect(fnopt) → {HTMLElement}
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.
Parameters:
| Name | Type | Attributes | Default | Description |
|---|---|---|---|---|
fn |
function
|
<optional> |
() => {} | La funzione di callback da eseguire quando si verifica l'evento `select`. La funzione riceverà l'evento come parametro. |
Returns:
- Type:
-
HTMLElement
- Restituisce l'elemento DOM su cui è stato aggiunto l'event listener, consentendo il chaining dei metodi.
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_onSubmit(fnopt) → {HTMLElement}
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.
Parameters:
| Name | Type | Attributes | Default | Description |
|---|---|---|---|---|
fn |
function
|
<optional> |
() => {} | 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. |
Returns:
- Type:
-
HTMLElement
- Restituisce l'elemento DOM su cui è stato aggiunto l'event listener, consentendo il chaining dei metodi.
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_prepend(elementList) → {HTMLElement}
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.
Parameters:
| Name | Type | Description |
|---|---|---|
elementList |
HTMLElement
|
Array.<HTMLElement>
|
Un singolo elemento DOM o un array di elementi DOM da aggiungere come figli. |
Returns:
- Type:
-
HTMLElement
- Restituisce l'elemento DOM su cui gli elementi sono stati aggiunti, consentendo il chaining dei metodi.
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_removeAttribute(attribute) → {HTMLElement}
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.
Parameters:
| Name | Type | Description |
|---|---|---|
attribute |
string
|
Il nome dell'attributo da rimuovere dall'elemento DOM. |
Returns:
- Type:
-
HTMLElement
- Restituisce l'elemento DOM su cui l'attributo è stato rimosso, consentendo il chaining dei metodi.
Example
JDM('<div id="foo">lorem ipsum</div>', document.body)
.jdm_removeAttribute('id'); // Rimuove l'attributo 'id' dall'elemento div.jdm_removeClassList(classList) → {HTMLElement}
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.
Parameters:
| Name | Type | Description |
|---|---|---|
classList |
string
|
Array.<string>
|
Una singola classe CSS o un array di classi CSS da rimuovere dall'elemento DOM. |
Returns:
- Type:
-
HTMLElement
- Restituisce l'elemento DOM su cui le classi sono state rimosse, consentendo il chaining dei metodi.
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_removeEventListener(name, fnopt) → {Node}
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.
Parameters:
| Name | Type | Attributes | Default | Description |
|---|---|---|---|---|
name |
string
|
Il nome dell'evento per cui rimuovere il listener (es. "click", "input", ecc.). | ||
fn |
function
|
<optional> |
() => {} | La funzione di callback che era stata precedentemente aggiunta come listener. Il valore predefinito è una funzione vuota. |
Returns:
- Type:
-
Node
- Restituisce il nodo dell'elemento da cui è stato rimosso l'evento, per consentire il chaining.
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_setAttribute(attribute, valueopt) → {HTMLElement}
Imposta un attributo su un elemento DOM e genera un evento personalizzato per il cambiamento.
Parameters:
| Name | Type | Attributes | Default | Description |
|---|---|---|---|---|
attribute |
string
|
Il nome dell'attributo da impostare sull'elemento DOM. | ||
value |
string
|
null
|
<optional> |
null | Il valore dell'attributo. Se non fornito, l'attributo sarà impostato su `null`. |
Returns:
- Type:
-
HTMLElement
- Restituisce l'elemento DOM su cui l'attributo è stato impostato, consentendo il chaining dei metodi.
Example
const div = JDM('<div>lorem ipsum</div>', document.body)
.jdm_setAttribute('id', 'myDiv')
.jdm_setAttribute('data-test', 'foo')
.jdm_setAttribute('counter', 1);jdm_setStyle(style, value) → {HTMLElement}
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`.
Parameters:
| Name | 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"). |
Returns:
- Type:
-
HTMLElement
- Restituisce l'elemento DOM su cui è stato applicato lo stile, consentendo il chaining dei metodi.
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_setValue(value, tooBooleanopt) → {HTMLElement}
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 (`
Parameters:
| Name | Type | Attributes | Default | Description |
|---|---|---|---|---|
value |
any
|
Il valore da impostare sull'elemento DOM. Il tipo di valore dipende dall'elemento e dal contesto. | ||
tooBoolean |
boolean
|
<optional> |
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. |
Returns:
- Type:
-
HTMLElement
- Restituisce l'elemento DOM su cui è stato impostato il valore, consentendo il chaining dei metodi.
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_toggleClassList(classList) → {HTMLElement}
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.
Parameters:
| Name | Type | Description |
|---|---|---|
classList |
string
|
Array.<string>
|
Una singola classe CSS o un array di classi CSS da alternare sull'elemento DOM. |
Returns:
- Type:
-
HTMLElement
- Restituisce l'elemento DOM su cui le classi sono state alternate, consentendo il chaining dei metodi.
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_validate() → {HTMLElement}
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.
Returns:
- Type:
-
HTMLElement
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".