Questa pagina mostra come aggiungere e personalizzare un elemento della dashboard LookML di type: text con i parametri della dashboard LookML in un file dashboard.lkml.
Per informazioni sull'aggiunta di testo a una dashboard tramite la UI di Looker, consulta la pagina della documentazione Creazione di dashboard definite dall'utente.
Esempio di utilizzo
## BASIC PARAMETERS
name: element_name
type: text
height: N
width: N
top: N
left: N
row: N
col: N
## TEXT PARAMETERS
title_text: title text
subtitle_text: subtitle text
body_text: body text
Definizioni dei parametri
| Nome parametro | Descrizione | |
|---|---|---|
| Parametri di base | ||
name (per gli elementi) |
Crea un elemento | |
type (per gli elementi) |
Determina il tipo di visualizzazione da utilizzare nell'elemento. | |
height (per gli elementi) |
Definisce l'altezza di un elemento in unità di tile_size per i dashboard layout: tile e layout: static. |
|
width (per gli elementi) |
Definisce la larghezza di un elemento in unità di tile_size per i dashboard layout: tile e layout: static |
|
top |
Definisce la posizione dall'alto verso il basso di un elemento in unità di tile_size per i dashboard layout: static |
|
left |
Definisce la posizione da sinistra a destra di un elemento in unità di tile_size per i dashboard layout: static |
|
row |
Definisce la posizione dall'alto verso il basso di un elemento in unità di righe per i dashboard layout: newspaper |
|
col |
Definisce la posizione da sinistra a destra di un elemento in unità di colonne per i dashboard layout: newspaper |
|
| Parametri di testo | ||
title_text |
Specifica un titolo per un elemento del dashboard di type: text |
|
subtitle_text |
Specifica un sottotitolo per un elemento del dashboard di type: text |
|
body_text |
Specifica il testo del corpo per un elemento della dashboard di type: text |
|
Parametri di base
Quando definisci un elemento del dashboard LookML di type: text, devi specificare i valori per almeno i parametri name e type.
name
Questa sezione si riferisce al parametro
nameche fa parte di un elemento del dashboard.
namepuò essere utilizzato anche come parte di un filtro della dashboard, come descritto nella pagina della documentazione Parametri della dashboard.
Ogni dichiarazione name crea un nuovo elemento della dashboard e gli assegna un nome. I nomi degli elementi devono essere univoci. A volte i nomi vengono citati nel parametro elements quando utilizzi i dashboard layout: grid.
- name: orders_by_date
type
Questa sezione si riferisce al parametro
typeche fa parte di un elemento del dashboard.
typepuò essere utilizzato anche come parte di un filtro della dashboard, come descritto nella pagina della documentazione Parametri della dashboard.
typepuò essere utilizzato anche nell'ambito di un'unione, come descritto nella pagina della documentazione relativa al parametrotype(per le unioni).
typepuò essere utilizzato anche come parte di una dimensione, come descritto nella pagina della documentazione Tipi di dimensioni, filtri e parametri.
typepuò essere utilizzato anche come parte di una misura, come descritto nella pagina della documentazione Tipi di misure.
Il parametro type determina il tipo di visualizzazione da utilizzare nell'elemento.
- name: element_name
type: text | looker_grid | table | single_value | looker_single_record |
looker_column | looker_bar | looker_scatter | looker_line | looker_area |
looker_pie | looker_donut_multiples | looker_funnel | looker_timeline |
looker_map | looker_google_map | looker_geo_coordinates | looker_geo_choropleth | looker_waterfall | looker_wordcloud | looker_boxplot
Per una panoramica dei diversi tipi di elementi delle dashboard LookML, consulta la pagina di documentazione type (per le dashboard LookML).
height
Questa sezione si riferisce al parametro
heightche fa parte di un elemento del dashboard.
heightpuò essere utilizzato anche nell'ambito di una riga del dashboard, come descritto nella pagina della documentazione Parametri del dashboard.
Per le dashboard con layout tile o static
Il parametro height definisce l'altezza di un elemento, in unità di tile_size (definita in pixel), per i dashboard layout: tile e layout: static.
Ad esempio, il seguente codice specifica tile_size: 100 e height: 4, rendendo l'elemento orders_by_date alto 400 pixel.
- dashboard: sales_overview
tile_size: 100
...
elements:
- name: orders_by_date
height: 4
...
Per le dashboard con layout newspaper
Il parametro height definisce l'altezza di un elemento, in unità di riga, per i dashboard layout: newspaper.
Un prospetto con layout a giornale ha un'altezza predefinita dell'elemento di 6 righe, ovvero circa 300 pixel. L'altezza minima è di una riga per i dashboard con un parametro preferred viewer impostato su dashboards-next. L'altezza minima è di 2 righe per i dashboard con un parametro preferred viewer impostato su dashboards.
Ad esempio, il seguente codice imposta un elemento in modo che sia alto 12 righe, ovvero il doppio degli altri elementi impostati sul valore predefinito:
- dashboard: sales_overview
layout: newspaper
...
elements:
- name: orders_by_date
height: 12
...
width
Questa sezione si riferisce al parametro
widthche fa parte di un elemento del dashboard.
widthpuò essere utilizzato anche nell'ambito di una dashboard, come descritto nella pagina della documentazione Parametri della dashboard.
Il parametro width definisce la larghezza di un elemento, in unità di tile_size, per i dashboard layout: tile e layout: static.
Ad esempio, il seguente codice specifica tile_size: 100 e width: 4, rendendo l'elemento orders_by_date largo 400 pixel.
- dashboard: sales_overview
tile_size: 100
...
elements:
- name: orders_by_date
width: 4
...
Il parametro width definisce la larghezza di un elemento, in unità di colonne, per i dashboard layout: newspaper.
Una dashboard con layout a giornale ha una larghezza predefinita di 24 colonne.
Ad esempio, il seguente codice imposta l'elemento sulla metà della larghezza del dashboard:
- dashboard: sales_overview
layout: newspaper
...
elements:
- name: orders_by_date
width: 12
...
top
Il parametro top definisce la posizione dall'alto verso il basso di un elemento, in unità di tile_size, per i dashboard layout: static.
Ad esempio, il seguente codice specifica tile_size: 100 e top: 4, posizionando il bordo superiore dell'elemento orders_by_date a 400 pixel dalla parte superiore del dashboard.
- dashboard: sales_overview
tile_size: 100
...
elements:
- name: orders_by_date
top: 4
...
left
Il parametro left definisce la posizione da sinistra a destra di un elemento, in unità di tile_size, per i dashboard layout: static.
Ad esempio, il seguente codice specifica tile_size: 100 e left: 4, posizionando il bordo sinistro dell'elemento orders_by_date a 400 pixel dal lato sinistro della dashboard.
- dashboard: sales_overview
tile_size: 100
...
elements:
- name: orders_by_date
left: 4
...
row
Per i dashboard layout: newspaper, il parametro row definisce la riga in cui viene posizionato il bordo superiore di un elemento.
Una dashboard inizia con la riga 0 nella parte superiore della dashboard. Una dashboard con layout a giornale ha un'altezza predefinita degli elementi di 6 righe, il che significa che gli elementi della dashboard nella parte superiore di una dashboard (row: 0) occuperanno per impostazione predefinita le righe 0-5.
Ogni riga è alta 50 pixel, il che significa che l'altezza predefinita di 6 righe è di 300 pixel.
Ad esempio, il seguente codice imposta un elemento da inserire nella seconda riga di elementi nella dashboard, supponendo che gli elementi siano impostati all'altezza predefinita:
- dashboard: sales_overview
layout: newspaper
...
elements:
- name: orders_by_date
row: 6
...
col
Per i dashboard layout: newspaper, il parametro col definisce la colonna in cui viene posizionato il bordo sinistro dell'elemento.
Le dashboard sono suddivise in 24 colonne. Una dashboard inizia con la colonna 0 a sinistra. Una dashboard con layout di giornale ha una larghezza predefinita degli elementi di 8 colonne, il che significa che gli elementi della dashboard a sinistra di una dashboard (col: 0) occuperanno per impostazione predefinita le colonne 0-7.
Ad esempio, il seguente codice imposta un elemento da inserire nella terza colonna degli elementi nel dashboard:
- dashboard: sales_overview
layout: newspaper
...
elements:
- name: orders_by_date
col: 16
...
Parametri di testo
Il codice LookML della dashboard generato dai riquadri di testo creati con l'opzione Testo nell'interfaccia utente di Looker non utilizzerà i parametri
title_textosubtitle_text.
I parametri descritti in questa sezione possono essere utilizzati per aggiungere contenuti a un elemento del dashboard LookML di type: text.
title_text
Il parametro title_text specifica il testo che verrà visualizzato in un elemento type: text con la dimensione del carattere più grande disponibile. Viene visualizzato nella parte superiore del riquadro.
title_text: title text
subtitle_text
Il parametro subtitle_text specifica il testo che verrà visualizzato in un elemento type: text con le dimensioni del carattere medie disponibili. Se è presente title_text, subtitle_text verrà visualizzato sotto.
subtitle_text: subtitle text
body_text
Il parametro body_text specifica il testo che verrà visualizzato in un elemento type: text con la dimensione del carattere più piccola disponibile. Questo parametro viene visualizzato per ultimo nel riquadro di testo. La pagina della documentazione Uso di Markdown nei riquadri Markdown fornisce una panoramica del Markdown che puoi utilizzare per formattare il testo o per aggiungere link e immagini a un riquadro di testo.
body_text: body text