Visualizzazione personalizzata di colonne e campi
Formatta colonne della griglia e campi del form senza toccare i dati sottostanti - pattern, troncamento, tooltip, evidenziazione e popup di sola lettura.
Comporre un pattern di visualizzazione
->column_pattern($field, $pattern) sostituisce il valore visualizzato di una colonna con un template che può richiamare ALTRE colonne della stessa riga tramite {placeholder}. Solo per la visualizzazione - modificare il campo (inline o nel form) mostra/salva comunque il suo vero valore.
$xcrud->column_pattern('customerNumber', 'Customer #{customerNumber} - {city}');| Parametro | Tipo | Predefinito | Descrizione |
|---|---|---|---|
$field | string | - | Colonna il cui valore visualizzato viene sostituito |
$pattern | string | - | Testo del template; {placeholder} fa riferimento a qualsiasi colonna whitelisted della riga |
Troncare testo lungo
->column_cut($field, $length) tronca il testo visualizzato di una colonna a $length caratteri, aggiungendo puntini di sospensione quando viene tagliato. Il valore completo resta disponibile come tooltip al passaggio del mouse, e l'editing inline mostra sempre il valore non troncato.
$xcrud->column_cut('description', 60);| Parametro | Tipo | Predefinito | Descrizione |
|---|---|---|---|
$field | string | - | Colonna da troncare |
$length | int | - | Numero massimo di caratteri mostrati prima dei puntini di sospensione |
Stile e suggerimenti
->column_class($field, $class) aggiunge una classe CSS extra all'intestazione di una colonna e a ogni sua cella (ad es. allineare a destra una colonna numerica). ->column_tooltip($field, $text) aggiunge un'icona di suggerimento al passaggio del mouse accanto a un'intestazione di colonna. ->column_width($field, $width) imposta una larghezza fissa per la colonna (ad es. '200px' o '20%').
$xcrud->column_class('creditLimit', 'text-right');
$xcrud->column_tooltip('creditLimit', 'Maximum outstanding balance allowed.');
$xcrud->column_width('creditLimit', '140px');| Metodo | Parametri | Descrizione |
|---|---|---|
column_class | $field, $class | Classe CSS extra sull'intestazione e sulle celle della colonna |
column_tooltip | $field, $text | Suggerimento al passaggio del mouse sull'intestazione della colonna |
column_width | $field, $width | Larghezza fissa della colonna |
->field_tooltip($field, $text) è l'equivalente lato form - un suggerimento al passaggio del mouse accanto all'etichetta di un campo del form invece che a un'intestazione della griglia.
$xcrud->field_tooltip('creditLimit', 'Maximum outstanding balance allowed.');Evidenziazione condizionale
->highlight($field, $operator, $value, $class) colora lo sfondo di una singola cella quando il suo valore corrisponde a un confronto. ->highlight_row($field, $operator, $value, $class) fa lo stesso per l'intera riga. $operator accetta simboli (=, !=, >, >=, <, <=) o codici (eq, neq, gt, gte, lt, lte, contains, starts, ends).
$xcrud->highlight('creditLimit', 'gt', '100000', 'xcrud-hl-warn');
$xcrud->highlight_row('status', 'eq', 'overdue', 'xcrud-hl-danger');| Parametro | Tipo | Predefinito | Descrizione |
|---|---|---|---|
$field | string | - | Colonna letta dal confronto |
$operator | string | - | Operatore di confronto (simbolo o codice) |
$value | string | - | Valore con cui confrontare |
$class | string | - | Classe CSS applicata quando il confronto corrisponde |
Più regole possono corrispondere alla stessa cella/riga - le classi si accumulano invece di sostituirsi a vicenda. Vedi Rendering personalizzato delle celle: badge e avatar per abbinare l'evidenziazione a markup di badge/avatar.
Popup di sola lettura per valori lunghi
->modal($field) fa sì che la cella di una colonna non modificabile apra il suo valore completo in un popup di sola lettura al clic, invece di non fare nulla o attivare la modifica inline.
$xcrud->modal('description');