Documentazione completa

• Introduzione
• Temi supportati
• Temi non più attivi
• Box class: Apertura box | Chiusura box | Riga chiave/valore Lista di elementi
• BoxStat class: Aggiunta box statistica
• Table class: Apertura tabella | Chiusura tabella | Aggiunta una riga | Aggiunta più righe
• Form e FormGroup class: Apertura form | Chiusura form | Input e varianti | Textarea e varianti | Checkbox | Radio buttons | Select | Select da Ajax | Select da Recordset | Hidden | Testo semplice | Riempimento form con set di dati | Pulsanti a chiusura form

Introduzione

Tutti i codici qui richiamati possono essere usati standalone così come mostrati oppure nei blade di Laravel includendo lo snippet tra {!! !!}

Temi attualmente attivi e manutenuti

Di seguito l'elenco dei temi attivi e manutenuti:

Temi non più attivi

Di seguito l'elenco dei temi la cui manutenzione non è più attiva, ma sono ancora funzionanti:

Box class

Aggiunge un widget per i temi BS2, un box per i temi BS3 e una card per i temi BS4 e BS5.

Apertura box

La classe base gestisce esclusivamente il contenitore esterno del box (row e col). L'implementazione dell'apertura e della chiusura della box class è demandata alle specifiche estensioni.

Se il $box_col passato è col-xs-12 oppure span12, verrà aggiunto anche un div.row

AdminLTE

Box::open($box_col = 'col-xs-12', $id = null, $border_status = null)
Box::openTitolo($icona, $titolo, $box_col = 'col-xs-12', $id = null,
	$border_status = null)

Inspinia e Angle

Box::open($box_col = 'col-xs-12', $id = null)
Box::openTitolo($icona, $titolo, $box_col = 'col-xs-12', $id = null)

Minimal Art

Box::open($box_col = 'span12', $id = null)
Box::openTitolo($icona, $titolo, $box_col = 'span12', $id = null, $bg_header = null)

TemplateVamp

Box::open($box_col = 'span12', $id = null)
Box::openTitolo($icona, $titolo, $box_col = 'span12', $id = null)

Parametri

Chiusura box

Chiude tutti i contenitori aperti nell'apertura. La classe base deve essere opportunamente estesa nei vari temi per chiudere correttamente eventuali altri contenitori aperti nelle funzioni open e open_titolo.

Box::close()

Riga chiave/valore

Aggiunge una riga in stile chiave/valore per un elenco di elementi (sconsigliato per AdminLTE, vedi Lista di elementi).

Box::row($label, $value, $colclasslabel = 'col-sm-2', $colclassvalue = 'col-sm-10')

Parametri

Esempio

Box::openTitolo('fa fa-user', 'Dettagli utente');
Box::row('Nome', 'Pinco', 'col-4', 'col-8');
Box::row('Cognome', 'Pallino', 'col-4', 'col-8');
Box::row('Email', '[email protected]', 'col-4', 'col-8');
Box::close();

Lista di elementi

Crea una description list <dl> di termini <dt> e descrizioni <dd> (disponibile solo per AdminLTE e Minimal Art).

Box::listOpen($horizontal = true)
Box::listRow($term, $description)
Box::listClose()

Parametri

Esempio

Il risultato è il medesimo dell'esempio precedente.

Box::openTitolo('fa fa-user', 'Dettagli utente');
Box::listOpen();
Box::listRow('Nome', 'Pinco');
Box::listRow('Cognome', 'Pallino');
Box::listRow('Email', '[email protected]');
Box::listClose();
Box::close();

BoxStat class

Aggiunge un piccolo box utile per generare statistiche.

Aggiunta box statistica

Aggiunge un box di statistica al contenitore. È consigliabile che la funzione venga richiamata subito dopo un code.col (vedi esempio sotto).

Ogni tema ha i suoi parametri per l'aggiunta di un box, sotto descritti

AdminLTE

BoxStat::stat($variante, $bg, $icona, $titolo, $valore, $ext = null,
	$boxclass = 'col-12', $link = null, $testo_link = 'Maggiori dettagli',
	$progress_percent = null, $progress_description = null)

Angle

BoxStat::stat($variante, $bg, $icona, $titolo, $valore, $ext = null,
	$boxclass = 'col-12', $link = null, $testo_link = 'Maggiori dettagli')

Bootstrap

BoxStat::stat($variante, $bg, $icona, $titolo, $valore, $ext = null,
	$boxclass = 'col-12', $link = null, $testo_link = null, $progress_percent = null,
	$progress_description = null, $progress_variation = false)

Inspinia

Il tema non è stato ancora documentato.

Minimal Art

Il tema non è stato ancora documentato.

TemplateVamp

Il tema non supporta la classe BoxStat.

Parametri

Esempio

BoxStat::stat(1, 'primary', 'fa fa-users', 'Utenti', 14)
BoxStat::stat(1, 'success', 'fa fa-upload', 'Dati caricati', '180,5', 'Gb', 'col-6')
BoxStat::stat(1, 'info', 'fa fa-money', 'Guadagno', '100.000', '€', 'col-6')

Varianti BoxStat

×

Ogni tema supporta diverse varianti, di seguito la lista completa.

AdminLTE

Note: la variante 3 non supporta la progress bar - solo la variante 3 supporta il link.

Angle

Note: le varianti 2, 3 e 4 non supportano i background -light e -dark - le varianti 2 e 3 non supportano il link.

Bootstrap

Note: la compatibilità è garantita solo con Bootstrap 5.

Minimal Art

Note: solo la variante 2 supporta la progress bar - solo la variante 3 supporta il link.

Table Class

Costruisce e visualizza una tabella con un box, con o senza titolo.

Apertura tabella

Apre una nuova tabella, all'interno di un box con titolo, all'interno di un box senza titolo oppure senza box (disponibile solo per Minimal Art).

Table::open($icona, $titolo, $azioni, $headers, $options = array())
Table::openNoTitle($headers, $options = array())
Table::openNoBox($headers, $options = array()  // Solo Minimal Art

Parametri

array(
	'column1',
	'column2',
	array('column3', 'sort' => 'column')
);

Chiusura tabella

Chiude una tabella aperta, specificando anche eventuali azioni multiple sugli elementi selezionati

Table::close($azioniMultiple = array())

Parametri

Aggiunta una riga

Aggiunge una riga alla tabella con i valori indicati

Table::row($rowValues, $rowOptions = array())

Parametri

Esempio

Table::openNoTitle(['ID', 'Utente', 'Ultimo accesso']);
Table::row([1, 'Pinco Pallino', '24/07/2018 20:42']);
Table::row([2, 'Mario Rossi', '20/07/2018 15:55'], ['class' => 'table-warning']);
Table::close();

array(
	'valore1',
	'valore2',
	array('valore3', 'colspan' => 2),
	array(
		array(
			array('icon' => 'fa fa-remove', 'href' => 'delete', 'class' => 'danger'),
			array('icon' => 'fa fa-pencil', 'href' => 'edit')
		),
		'class' => 'text-right hidden-print',
		'type' => 'buttons'
	)
);

Aggiunta più righe

Con questa funzione è possibile aggiunge più righe insieme in una sola volta, molto utile con recordset.

A differenza delle righe tradizionali dove le colonne vengono sempre mostrate nell'ordine in cui sono definite, con questo sistema è possibile assegnare ad ogni elemento di ogni riga un'etichetta (chiave => valore, così come avviene negli array tradizionali) che saranno poi facilmente ordinati tramite le $keys del 2° parametro.

È anche possibile combinare rows() e row() per esempio per mostrare un recordset (con rows()) e i relativi totali (con un row() singolo).

Per maggiori informazioni si rimanda agli esempi poco più sotto

Table::rows($rows, $keys = array())

Parametri

Esempio standalone

$importi = [500, -300, -100];

// preparo i dati
$righe = [];
$totale = 0;
foreach ($importi as $importo) {
	if ($importo > 0) {
		$righe[] = [
			'operazione' => 'Accredito',
			'importo' => ['str' => '+ € '.$importo, 'val' => $importo],
			'options' => ['class' => 'table-success']
		];
	} else {
		$righe[] = [
			'operazione' => 'Addebito',
			'importo' => ['str' => '- € '.abs($importo), 'val' => $importo]
		];
	}
	$totale += $importo;
}

// creo la tabella
Table::openNoTitle(['Operazione effettuata', 'Importo']);
Table::rows($righe, ['operazione', 'importo.str']);
Table::row(['Totale', ($importo >= 0 ? '+' : '-').' € '.abs($importo)],
	['class' => 'font-weight-bold']);
Table::close();

Esempio 1

Nota: sebbene questo esempio sia leggermente più corto rispetto all'esempio 2, più sotto, si consiglia di seguire l'altro esempio.

// CONTROLLER - recupero i dati
$movimenti = Movimento::all();

// adeguo i dati per la visualizzazione
foreach ($movimenti as &$movimento) {
	if ($movimento->importo > 0) {
		$movimento->operazione = 'Accredito';
		$movimento->importo = '+ € '.$movimento->importo;
		$movimento->options = ['class' => 'table-success'];
	} else {
		$movimento->operazione = 'Accredito';
		$movimento->importo = '- € '.abs($movimento->importo);
	}
	$movimento->data_mov = date('d/m/Y', strtotime($movimento->data_mov));
}

// BLADE - creo la tabella
{!! Table::openNoTitle(['ID', 'Operazione', 'Importo', 'Data']); !!}
{!! Table::rows($movimenti, ['id_mov', 'operazione', 'importo', 'data_mov']); !!}
{!! Table::close(); !!}

Esempio 2 con gli Accessors

Documentazione: Mutators e Accessors

// MODEL
class Movimento extends Model {
	protected $table = 'movimenti';
	protected $primaryKey = 'id_mov';

	function getTipoOpAttrubite() {
		return ($this->importo > 0 ? 'Accredito' : 'Addebito');
	}

	function getImportoStrAttribute() {
		return ($this->importo > 0 ? '+' : '-').' € '.abs($this->importo);
	}

	function getDataMovStrAttribute() {
		return date('d/m/Y', strtotime($this->data_mov));
	}

	function getButtonsAttribute() {
		return [
			[
				['href' => 'adminUtenti.editUser.'.$this->id_mov,
					'icon' => 'fa fa-pencil', 'class' => 'warning'],
				['href' => 'adminUtenti.destroyUser.'.$this->id_mov,
					'icon' => 'fa fa-times', 'class' => 'danger', 'confirm' => true]
			],
			'class' => 'text-right hidden-print',
			'type' => 'buttons'
		];
	}
}

// CONTROLLER - recupero i dati
$movimenti = Movimento::all();

// BLADE - creo la tabella
{!! Table::openNoTitle(['ID', 'Operazione', 'Importo', 'Data', '']); !!}
{!! Table::rows($movimenti, ['id_mov', 'tipo_op', 'importo_str',
	'data_mov_str', 'buttons']); !!}
{!! Table::close(); !!}

Form e FormGroup Class

Costruisce e visualizza un form.

La Form class supporta 3 tipi di form: horizontal (default), vertical e inline. La FormGroup class è una variante della form vertical e prevede il raggruppamento di label e campo in un contenitore di larghezza variabile.

Apertura form

Apre un nuovo form. Viene automaticamente aggiunto un campo hidden con name redirect e valore urlencode($_GET['r']) per semplificare le operazioni di reindirizzamento dopo l'invio del form.

Form::open($action, $multipart = false, $id = "", $get = false,
	$validationClass = "validate-form-custom",
	$form_type = NForm::FORM_TYPE_HORIZONTAL)

FormGroup::open($action, $multipart = false, $id = "", $get = false,
	$validationClass = "validate-form-group")

Parametri

Chiusura form

Chiude un form aperto

Form::close()
FormGroup::close()

Input e varianti

Aggiunge un campo input o una variante basata sul campo input. Nota: il tipo datetimepicker è temporaneamente non disponibile.

Form::input($label, $name, $required = false, $options = array())
Form::email($label, $name, $required = false, $options = array())
Form::password($label, $name, $required = false, $options = array())
Form::file($label, $name, $required = false, $options = array())
Form::datepicker($label, $name, $required = false, $options = array())
Form::datetimepicker($label, $name, $required = false, $options = array())
Form::daterangepicker($label, $name, $required = false, $options = array())
Form::datetimerangepicker($label, $name, $required = false, $options = array())
Form::clockpicker($label, $name, $required = false, $options = array())
Form::touchspin($label, $name, $required = false, $options = array())

FormGroup::input($col, $label, $name, $required = false, $options = array())
FormGroup::email($col, $label, $name, $required = false, $options = array())
FormGroup::password($col, $label, $name, $required = false, $options = array())
FormGroup::file($col, $label, $name, $required = false, $options = array())
FormGroup::datepicker($col, $label, $name, $required = false, $options = array())
FormGroup::datetimepicker($col, $label, $name, $required = false, $options = array())
FormGroup::daterangepicker($col, $label, $name, $required = false, $options = array())
FormGroup::datetimerangepicker($col, $label, $name, $required = false, $options = array())
FormGroup::clockpicker($col, $label, $name, $required = false, $options = array())
FormGroup::touchspin($col, $label, $name, $required = false, $options = array())

Parametri

Textarea e varianti

Aggiunge un campo textarea o una variante basata sul campo textarea

Form::textarea($label, $name, $required = false, $options = array())
Form::wysiwyg($label, $name, $required = false, $options = array())

FormGroup::textarea($col, $label, $name, $required = false, $options = array())
FormGroup::wysiwyg($col, $label, $name, $required = false, $options = array())

Parametri

Checkbox

Aggiunge una o più checkbox.

Checkbox singole

Form::checkbox($label, $name, $required = false, $disabled = false,
	$value = 'on', $options = array())

FormGroup::checkbox($col, $label, $name, $required = false, $disabled = false,
	$value = 'on', $options = array())

Parametri checkbox singole

Checkbox multiple

Form::checkboxes($label, $mainName, $checkboxes, $options = array())

FormGroup::checkboxes($col, $label, $mainName, $checkboxes, $options = array())

Parametri checkbox multiple

Esempi

// Si consiglia di vedere il sorgente HTML di questo esempio
Form::open('save');
Form::checkbox('Newsletter', 'news');
Form::checkboxes('Canali', 'canali', [
	['label' => 'Email',     'name' => 'email'],     // value 'on' di default
	['label' => 'Cellulare', 'name' => 'cellulare']  // value 'on' di default
]);
Form::checkboxes('Aree', 'newsaree', [
	['label' => 'Commerciale',       'value' => 'commerciale'],
	['label' => 'Novità',            'value' => 'novita'],
	['label' => 'Eventi',            'value' => 'eventi'],
	['label' => 'Avvisi importanti', 'value' => 'avvisi']
]);
Form::close();

Radio buttons

Aggiunge una serie di radio buttons. Ufficialmente è una variante di Form::checkboxes() anche se i parametri richiesti differiscono leggermente.

Form::radio($label, $name, $radios, $required = false, $options = array())

FormGroup::radio($col, $label, $name, $radios, $required = false, $options = array())

Parametri

Esempi

// Si consiglia di vedere il sorgente HTML di questo esempio
Form::open('save');
Form::radio('Sesso', 'sesso', ['M' => 'Maschio', 'F' => 'Femmina');
Form::radio('Età', 'eta', [
	['label' => '0-17',  'value' => '0', 'disabled' => true],
	['label' => '18-34', 'value' => '18'],
	['label' => '35+',   'value' => '35']
], true);
Form::close();

Select

Aggiunge una select al form inizializzata come una Select2. La libreria non prevede select pure.

Form::select($label, $name, $values, $required = false, $options = array())

FormGroup::select($col, $label, $name, $values, $required = false,
	$options = array())

Parametri

Esempi

$regioni = ['Abruzzo', 'Basilicata', 'Calabria', 'Campania', 'Emilia Romagna',
	'Friuli Venezia Giulia', 'Lazio', 'Liguria', 'Lombardia', 'Marche', 'Molise',
	'Piemonte', 'Puglia', 'Sardegna', 'Sicilia', 'Toscana', 'Trentino Alto Adige',
	'Umbria', 'Valle d\'Aosta', 'Veneto'];
$interessi = ['Italiano', 'Storia', 'Geografia', 'Lingue straniere',
	'Filosofia', 'Fisica', 'Matematica', 'Storia dell\'arte'];
$fasce_eta = ['13' => '13-17', '18' => '18-29', '30' => '30-39',
	'40' => '40-49', '50' => '50+'];


Form::open('save');

// >> Esempio semplice:
Form::select('Regione', 'regione', $regioni, true, ['labelAsValue' => true]);
// Il valore passato coincide esattamente con il nome della regione
// Vedi jsFiddle - https://jsfiddle.net/giovdi/Lhvt648n

// >> Esempio multiplo:
Form::select('Interessi', 'interessi', $interessi, false,
	['multiple' => true, 'labelAsValue' => true, 'custom' => true]);
// I valori passati coincidono esattamente con gli interessi
// Vedi jsFiddle - https://jsfiddle.net/giovdi/d8xq0yc3

// >> Esempio con valore diverso da etichetta:
Form::select('Fascia età', 'fascia_eta', $fasce_eta);
// Il valore passato, in questo caso, è uno tra 13, 18, 30, 40, 50
// Vedi jsFiddle - https://jsfiddle.net/giovdi/huy05jfo

Form::close();

Select da Ajax

Aggiunge una select al form inizializzata come una Select2 collegata a una origine dati remota (ajax).

Di default, la request ajax deve ritornare un oggetto JSON di tipo {items: [...]}.

Form::selectAjax($label, $name, $ajaxUrl, $keys_labels = 'text',
	$keys_values = 'id', $required = false, $options = array()

FormGroup::selectAjax($col, $label, $name, $ajaxUrl, $keys_labels = 'text',
	$keys_values = 'id', $required = false, $options = array()

Parametri

Esempio

// Si consiglia di vedere il sorgente HTML di questo esempio

// BLADE
{!! Form::open('save'); !!}

// >> Esempio base:
{!! Form::selectAjax('Comune', 'comune', 'comuni.php', 'nome', 'codice'); !!}

// >> Esempio con etichetta complessa:
{!! Form::selectAjax('Comune (prov)', 'comune_prov', 'comuni.php',
	"result.nome + ' (' + result.sigla + ')'", 'codice'); !!}

// >> Esempio con parametro e prepopolamento:
{!! Form::selectAjax('Comuni Bari', 'comuni_bari', 'comuni.php', 'nome', 'codice',
	false, ['paramAjax' => ['provincia' => 'BA'],
	'value' => ['nome' => 'Bari', 'codice' => 'A662']]) !!}

{!! Form::close(); !!}

Select da Recordset

Aggiunge una select al form inizializzata come una Select2 a partire da un recordset. La libreria non prevede select pure.

Form::selectRS($label, $name, $rs, $columns_labels, $columns_values, 
	$required = false, $options = array())

FormGroup::selectRS($col, $label, $name, $rs, $columns_labels, $columns_values, 
	$required = false, $options = array())

Parametri

Esempio

// Si consiglia di vedere il sorgente HTML di questo esempio

// CONTROLLER - recupero i dati
$utenti = Utenti::all();

// BLADE - creo la select
{!! Form::open('save'); !!}
{!! Form::selectRS('Utente', 'id_utente', $utenti,
		['nome', ' ', 'cognome'], 'id_utente', true); !!}
{!! Form::close(); !!}

Hidden

Aggiunge un input di tipo hidden.

Form::hidden($name, $value, $id = null)
FormGroup::hidden($name, $value, $id = null)

Parametri

Testo semplice

Aggiunge un testo HTML semplice in linea con gli altri campi.

Form::html($text)
FormGroup::html($col, $text)

Parametri

Riempimento form con set di dati

Genera uno script jQuery che riempie il form in corso. Va chiamato sempre prima di Form::close().

Form::fillForm($set, $debug = false)

Parametri

Pulsanti a chiusura form

Aggiunge i pulsanti si invio, reset ed eventuali azioni aggiuntive in coda al form.

Form::submitOnlyButtons($save_icon, $save_label, $cancel_btn = true,
	$other_actions = array(), $save_btn_class = 'primary')
	// aggiunge solo i pulsanti senza contenitori
Form::submitCustom($save_icon, $save_label, $cancel_btn = true,
	$other_actions = array(), $save_btn_class = 'primary')
	// aggiunge i pulsanti e i contenitori per allineare i pulsanti ai campi
Form::submit()
	// aggiunge i pulsanti 'Salva' e 'Reset' con i contenitori

Parametri