# EDD_HTML_Elements
La classe EDD_HTML_Elements fornisce una serie di metodi di utilità per il rendering di campi HTML comunemente usati con markup, nomi di classe e attributi coerenti.
La classe include metodi per i seguenti tipi di campo:
### product_dropdown()
Questo metodo crea un elemento HTML select con i prodotti al suo interno. I valori sono product_ids e il testo è il titolo del Download.
Esempio:
```
echo EDD()->html->product_dropdown();
```
Questo creerebbe un elenco a discesa di prodotti. Il metodo accetta un input, un array, e ha questi valori predefiniti:
```
$defaults = array(
'name' => 'products',
'id' => 'products',
'class' => '',
'multiple' => false,
'selected' => 0,
'chosen' => false,
'number' => 30,
'bundles' => true,
'placeholder' => sprintf( __( 'Select a %s', 'easy-digital-downloads' ), edd_get_label_singular() )
);
```
Ecco una descrizione di cosa c'è in ogni opzione:
##### name
Questa sarebbe la proprietà "name" dell'elemento del modulo HTML. Predefinito: 'products'.
Esempio:
```
```
##### id
Questa sarebbe la proprietà "id" dell'elemento HTML. Predefinito: 'products'.
Esempio:
```
```
##### class
Questa sarebbe la proprietà "class" dell'elemento HTML. Predefinito: nessuno.
Esempio:
```
```
##### multiple
Questo rende il menu select di tipo "multiple". Predefinito: false.
Esempio: 
##### selected
Questo ti permette di fornire il product_id di un Download e averlo pre-selezionato quando il modulo viene caricato. Predefinito: 0.
##### chosen
Questo attiva il plugin jquery "chosen" sulla tua casella di selezione. Predefinito: false.
Esempi sia chiusi che aperti:
Sotto è mostrato con 'multiple' impostato su true:
##### number
Questo ti permette di impostare un limite al numero di prodotti nella tua lista. Predefinito: 30.
##### bundles
Questo ti permette di decidere se includere i bundle nella tua lista di prodotti. Predefinito: true.
##### placeholder
Questo è il testo che va nella prima riga dell'elenco di selezione, di solito qualcosa come un titolo. Il predefinito è
sprintf( __( 'Select a %s', 'easy-digital-downloads' ), edd_get_label_singular() )
La stringa sopra ha un inglese semplice che dice "Select a " e poi cerca una stringa con %s. Quella stringa è fornita dalla funzione edd_get_label_singular(). edd_get_label_singular() ottiene il nome del tuo tipo di prodotto in forma singolare. edd_get_label_singular() ha come predefinito "Download".
### customer_dropdown()
Questo metodo crea un elemento HTML select con i prodotti al suo interno. I valori sono customer_ids e il testo è Nome Cognome .
Esempio:
```
echo EDD()->html->customer_dropdown();
```
Questo creerebbe un elenco a discesa di clienti. Il metodo accetta un input, un array, e ha questi valori predefiniti:
```
$defaults = array(
'name' => 'customers',
'id' => 'customers',
'class' => '',
'multiple' => false,
'selected' => 0,
'chosen' => true,
'placeholder' => __( 'Select a Customer', 'easy-digital-downloads' ),
'number' => 30
);
```
Ecco una descrizione di cosa c'è in ogni opzione:
##### name
Questa sarebbe la proprietà "name" dell'elemento del modulo HTML. Predefinito: 'customers'.
Esempio:
```
```
##### id
Questa sarebbe la proprietà "id" dell'elemento HTML. Predefinito: 'customers'.
Esempio:
```
```
##### class
Questa sarebbe la proprietà "class" dell'elemento HTML. Predefinito: nessuno.
Esempio:
```
```
##### multiple
Questo rende il menu select di tipo "multiple". Predefinito: false.
Esempio: 
##### selected
Questo ti permette di fornire un customer_id e averlo pre-selezionato quando il modulo viene caricato. Predefinito: 0.
##### chosen
Questo attiva il plugin jquery "chosen" sulla tua casella di selezione. Predefinito: false.
Esempi sia chiusi che aperti: 
##### number
Questo ti permette di impostare un limite al numero di clienti nella tua lista. Predefinito: 30.
##### placeholder
Questo è il testo che va nella prima riga dell'elenco di selezione, di solito qualcosa come un titolo. Il predefinito è "Select a Customer".
### discount_dropdown()
Questo metodo crea un elemento HTML select con un elenco di Sconti al suo interno. I valori sono discount_ids e il testo è il titolo dello Sconto.
Esempio:
```
echo EDD()->html->discount_dropdown();
```
Questo creerebbe un elenco a discesa di sconti.
#### Input
Questo metodo accetta tre valori in input.
##### name
Questo è il nome dell'elemento HTML. Il predefinito è 'edd_discounts'
##### selected
Questo è l'elemento che dovrebbe essere selezionato quando la casella di selezione viene caricata. Il predefinito è non avere nulla selezionato, e l'elemento predefinito sarà il primo sconto nella lista.
##### status
Gli sconti possono essere attivi o inattivi. L'opzione 'status' permette di scegliere uno dei due. Il predefinito è non dichiarare, e tutti gli Sconti vengono caricati.
### category_dropdown()
Questo metodo crea un elemento HTML select con un elenco di categorie di Download al suo interno. I valori sono term_ids e il testo è il titolo della categoria.
Esempio:
```
echo EDD()->html->category_dropdown();
```
Questo creerebbe un elenco a discesa di categorie di Download.
#### Input
Questo metodo accetta due valori in input.
##### name
Questo è il nome dell'elemento HTML. Il predefinito è 'edd_categories'
##### selected
Questo è l'elemento che dovrebbe essere selezionato quando la casella di selezione viene caricata. Il predefinito è non avere nulla selezionato, e la casella di selezione avrà un'opzione intitolata "Tutte le categorie".
### year_dropdown()
Questo metodo crea un elemento HTML select con un elenco di anni al suo interno. Il testo e il valore dell'opzione sono entrambi un anno a 4 cifre.
Esempio:
```
echo EDD()->html->year_dropdown();
```
Questo creerebbe un elenco a discesa di 6 anni, con l'anno corrente selezionato per impostazione predefinita.
#### Input
Questo metodo accetta due valori in input.
##### name
Questo è il nome dell'elemento HTML. Il predefinito è 'year'
##### selected
Questo è l'elemento che dovrebbe essere selezionato quando la casella di selezione viene caricata. Richiede un intero a quattro cifre.
### month_dropdown()
Questo metodo crea un elemento HTML select con un elenco di mesi al suo interno. I valori sono interi non imbottiti e il testo sono abbreviazioni di tre lettere dei mesi.
Esempio:
```
echo EDD()->html->year_dropdown();
```
Questo creerebbe un elenco a discesa di 12 mesi, con il mese corrente selezionato per impostazione predefinita.
#### Input
Questo metodo accetta due valori in input.
##### name
Questo è il nome dell'elemento HTML. Il predefinito è 'month'
##### selected
Questo è l'elemento che dovrebbe essere selezionato quando la casella di selezione viene caricata. Richiede un intero a due cifre.
### select()
Questo metodo crea un elemento HTML select e ti permette di popolarlo con qualsiasi array monodimensionale.
Esempio:
```
echo EDD()->html->select( $args );
```
Il metodo accetta un input, un array, e ha questi valori predefiniti:
```
$args = array(
'options' => array(),
'name' => null,
'class' => '',
'id' => '',
'selected' => 0,
'chosen' => false,
'placeholder' => null,
'multiple' => false,
'show_option_all' => _x( 'All', 'all dropdown items', 'easy-digital-downloads' ),
'show_option_none' => _x( 'None', 'no dropdown items', 'easy-digital-downloads' ),
);
```
Ecco una descrizione di cosa c'è in ogni opzione:
##### options
Questo è un array monodimensionale di cose come questa:
```
$args['options'] = array(
'1' => 'Thing 1',
'2' => 'Thing 2',
'3' => 'Thing 3',
'4' => 'Thing 4',
);
```
Le chiavi dell'array vengono utilizzate come valori delle opzioni di selezione, e i valori dell'array vengono utilizzati come testo delle opzioni di selezione.
##### name
Questa sarebbe la proprietà "name" dell'elemento del modulo HTML. Predefinito: null, richiesto per creare un elemento del modulo utile.
##### id
Questa sarebbe la proprietà "id" dell'elemento HTML. Predefinito: vuoto.
##### class
Questa sarebbe la proprietà "class" dell'elemento HTML. Predefinito: vuoto.
##### multiple
Questo rende il menu select di tipo "multiple". Predefinito: false.
Esempio: 
##### selected
Questo ti permette di fornire una chiave dal tuo array e averla pre-selezionata quando il modulo viene caricato. Predefinito: 0.
##### chosen
Questo attiva il plugin jquery "chosen" sulla tua casella di selezione. Predefinito: false.
Esempi sia chiusi che aperti:
##### placeholder
Questo è il testo che va nella prima riga dell'elenco di selezione, di solito qualcosa come un titolo. Il predefinito è null.
##### show_option_all
Questo crea un'opzione di selezione con un valore "all", e viene inserita nell'elenco degli argomenti in questo modo:
```
'show_option_all' => _x( 'All', 'all dropdown items', 'easy-digital-downloads' ),
```
##### show_option_none
Questo crea un'opzione di selezione con un valore "-1", e viene inserita nell'elenco degli argomenti in questo modo:
```
'show_option_all' => _x( 'None', 'no dropdown items', 'easy-digital-downloads' ),
```
### checkbox()
Questo metodo crea un singolo elemento HTML checkbox.
**Nota:** Questa funzione non crea alcun HTML di wrapping come .
Esempio:
```
```
Il metodo accetta un input, un array, e ha questi valori predefiniti:
```
$args = array(
'name' => null,
'current' => null,
'class' => 'edd-checkbox',
'options' => array(
'disabled' => false,
'readonly' => false
)
);
```
Ecco una descrizione di cosa c'è in ogni opzione:
##### name
Questa sarebbe la proprietà "name" dell'elemento del modulo HTML. Predefinito: null, richiesto per creare un elemento del modulo utile.
**Nota:** il nome viene utilizzato anche per l''id'.
##### current
Questo è il valore preesistente del campo. Viene utilizzato per determinare se la casella di controllo deve essere selezionata per impostazione predefinita.
##### class
Questo è il valore dell'elemento HTML 'class'. Predefinito: 'edd-checkbox'.
##### options
Questo deve essere un array e può contenere due opzioni.
- **disabled** - Imposta il campo su disabilitato o meno con true o false.
- **readonly** - Imposta il campo su readonly o meno con true o false.
### text()
Questo metodo crea un elemento HTML di testo semplice.
Esempio:
```
html->text( $args ); ?>
```
Il metodo accetta un input, un array, e ha questi valori predefiniti:
```
$args = array(
'id' => '',
'name' => 'text',
'value' => NULL,
'label' => NULL,
'desc' => NULL,
'placeholder' => '',
'class' => 'regular-text',
'disabled' => false,
'autocomplete' => '',
'data' => false
);
```
Ecco una descrizione di cosa c'è in ogni opzione:
##### id
Questa sarebbe la proprietà "id" dell'elemento HTML. Predefinito: vuoto.
##### name
Questa sarebbe la proprietà "name" dell'elemento del modulo HTML. Predefinito: "text".
##### value
Questo è il valore preesistente del campo. Viene utilizzato per pre-compilare il campo di testo con questo valore. Predefinito: NULL.
##### label
Questo è il testo racchiuso in un tag . Il tag ha anche una classe "edd-label" e un elemento "for" che utilizza l'id menzionato sopra. Predefinito: NULL.
##### desc
Questo è un testo racchiuso in uno span con una classe "edd-description". Viene posizionato tra l'etichetta e l'input. Predefinito: NULL.
##### placeholder
Questo testo viene inserito nell'elemento "placeholder" del . Il rendering dipende dal browser. [Puoi leggere di più sull'elemento placeholder su w3schools](https://www.w3schools.com/tags/att_input_placeholder.asp). Predefinito: vuoto.
##### class
Questo è il valore dell'elemento HTML 'class'. Predefinito: 'regular-text'.
##### disabled
Questo imposta il campo su disabilitato o meno. Booleano, predefinito: false.
##### autocomplete
Questo imposta l'elemento autocomplete su "on" o "off". Predefinito: vuoto, che equivale a on nella maggior parte dei browser moderni.
##### data
Questo accetta un array e crea elementi HTML data dall'array. Esempio:
```
array(
'price' => '42.00',
'variable-price' => 'no',
);
```
L'array sopra risulterebbe in questo HTML inserito nell'input:
```
data-price="42.00" data-variable-price="no"
```
Predefinito: false.
### textarea()
Questo crea una textarea HTML standard multi-linea.
Esempio:
```
html->textarea( $args ); ?>
```
Il metodo accetta un input, un array, e ha questi valori predefiniti:
```
$args = array(
'name' => 'textarea',
'value' => null,
'label' => null,
'desc' => null,
'class' => 'large-text',
'disabled' => false
);
```
Ecco una descrizione di cosa c'è in ogni opzione.
##### name
Questa sarebbe la proprietà "name" dell'elemento del modulo HTML. Predefinito: "textarea".
##### value
Questo è il valore preesistente del campo. Viene utilizzato per pre-compilare il campo di testo con questo valore. Predefinito: NULL.
##### label
Questo è il testo racchiuso in un tag . Il tag ha anche una classe "edd-label" e un elemento "for" che utilizza l'id menzionato sopra. Predefinito: NULL.
##### desc
Questo è un testo racchiuso in uno span con una classe "edd-description". Viene posizionato dopo il tag textarea. Predefinito: NULL.
##### class
Questo è il valore dell'elemento HTML 'class'. Predefinito: 'large-text'.
##### disabled
Questo imposta il campo su disabilitato o meno. Booleano, predefinito: false.
### ajax_user_search()
Questo metodo crea un campo di testo per la ricerca di utenti EDD. Utilizza ajax per cercare mentre digiti, e ti permette di cliccare per scegliere un risultato per popolare il campo.
**Nota**: questo campo funziona solo nelle pagine di amministrazione di EDD. Non sul front-end di WordPress, e non in altre aree di amministrazione di WordPress.
Esempio:
```
html->ajax_user_search( $args ); ?>
```
Il metodo accetta un input, un array, e ha questi valori predefiniti:
```
$args = array(
'name' => 'user_id',
'value' => NULL,
'placeholder' => __( 'Enter username', 'easy-digital-downloads' ),
'label' => NULL,
'class' => '',
'disabled' => false,
'autocomplete'=>'off',
);
```
Ecco una descrizione di cosa c'è in ogni opzione.
##### name
Questa sarebbe la proprietà "name" dell'elemento del modulo HTML. Predefinito: "user_id".
##### value
Questo è il valore preesistente del campo. Viene utilizzato per pre-compilare il campo di testo con questo valore. Predefinito: NULL.
##### placeholder
Questo testo viene visualizzato nella casella di input nella maggior parte dei browser. Predefinito:
```
__( 'Enter username', 'easy-digital-downloads' )
```
##### label
Questo testo non appare sul front-end del sito, ma viene utilizzato con aria per gli screen reader. Predefinito: NULL.
##### class
Questo è il valore dell'elemento HTML 'class'. Predefinito: vuoto.
##### disabled
Questo imposta il campo su disabilitato o meno. Booleano, predefinito: false.
##### autocomplete
Questo imposta l'elemento autocomplete su "on" o "off". Predefinito: vuoto, che equivale a on nella maggior parte dei browser moderni.