Questa pagina mostra come aggiungere e personalizzare un elemento della dashboard LookML di type: text
con i parametri della dashboard di LookML in un file dashboard.lkml
.
Per informazioni sull'aggiunta di riquadri di testo a una dashboard tramite l'interfaccia utente 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 le dashboard di layout: tile e layout: static |
|
width (per gli elementi) |
Definisce la larghezza di un elemento in unità di tile_size per le dashboard di layout: tile e layout: static |
|
top |
Definisce la posizione dall'alto verso il basso di un elemento in unità di tile_size per le dashboard di layout: static |
|
left |
Definisce la posizione da sinistra a destra di un elemento nelle unità di tile_size per le dashboard di layout: static |
|
row |
Definisce la posizione dall'alto verso il basso di un elemento in unità di righe per le dashboard di layout: newspaper |
|
col |
Definisce la posizione da sinistra a destra di un elemento in unità di colonne per le dashboard di layout: newspaper |
|
Parametri di testo | ||
title_text |
Specifica un titolo per un elemento della dashboard di type: text |
|
subtitle_text |
Specifica un sottotitolo per un elemento della 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 della dashboard LookML di type: text
, devi specificare dei valori per almeno i parametri name
e type
.
name
Questa sezione si riferisce al parametro
name
che fa parte di un elemento della dashboard.
name
può essere utilizzato anche come parte di un filtro della dashboard, descritto nella pagina della documentazione Parametri della dashboard.
Ogni dichiarazione name
crea un nuovo elemento della dashboard a cui assegna un nome. I nomi degli elementi devono essere univoci. A volte viene fatto riferimento ai nomi nel parametro elements
quando utilizzi le dashboard di layout: grid
.
- name: orders_by_date
type
Questa sezione si riferisce al parametro
type
che fa parte di un elemento della dashboard.
type
può essere utilizzato anche come parte di un filtro della dashboard, descritto nella pagina della documentazione Parametri della dashboard.
type
può essere utilizzato anche come parte di un join, descritto nella pagina della documentazione relativa al parametrotype
(per join).
type
può essere utilizzato anche come parte di una dimensione, descritto nella pagina della documentazione Tipi di dimensioni, filtri e parametri.
type
può essere utilizzato anche come parte di una misura, descritto nella pagina della documentazione Tipi di misurazioni.
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
Consulta la pagina della documentazione type
(per le dashboard di LookML) per una panoramica dei diversi tipi di elementi delle dashboard di LookML.
height
Questa sezione si riferisce al parametro
height
che fa parte di un elemento della dashboard.
height
può essere utilizzato anche come parte di una riga della dashboard, descritto nella pagina della documentazione Parametri della 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 le 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 le dashboard di layout: newspaper
.
Per impostazione predefinita, una dashboard con layout del giornale ha un'altezza dell'elemento di 6 righe o circa 300 pixel. L'altezza minima è di 1 riga per le dashboard con un parametro preferred viewer
impostato su dashboards-next
. L'altezza minima è di 2 righe per le dashboard con un parametro preferred viewer
impostato su dashboards
.
Ad esempio, il seguente codice imposta un elemento alto 12 righe o doppio rispetto agli 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
width
che fa parte di un elemento della dashboard.
width
può essere utilizzato anche come parte di una dashboard, descritto nella pagina della documentazione relativa ai parametri della dashboard.
Il parametro width
definisce la larghezza di un elemento, in unità di tile_size
, per le dashboard di layout: tile
e layout: static
.
Ad esempio, il seguente codice specifica tile_size: 100
e width: 4
, per cui l'elemento orders_by_date
ha una larghezza di 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 le dashboard di layout: newspaper
.
Per impostazione predefinita, una dashboard con layout del giornale ha una larghezza di 24 colonne.
Ad esempio, il seguente codice imposta l'elemento su metà larghezza della 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 le dashboard di layout: static
.
Ad esempio, il codice seguente specifica tile_size: 100
e top: 4
, posizionando il bordo superiore dell'elemento orders_by_date
a 400 pixel dalla parte superiore della 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 le dashboard di 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 le dashboard di layout: newspaper
, il parametro row
definisce la riga in cui si trova il bordo superiore di un elemento.
La dashboard inizia con la riga 0 nella parte superiore della dashboard. Per impostazione predefinita, una dashboard con layout del giornale ha un'altezza dell'elemento di 6 righe, il che significa che gli elementi della dashboard nella parte superiore di una dashboard (row: 0
) occupano le righe 0-5.
Ogni riga ha un'altezza di 50 pixel, il che significa che l'altezza predefinita dell'elemento di 6 righe è 300 pixel.
Ad esempio, il seguente codice imposta un elemento da impostare 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 le dashboard di layout: newspaper
, il parametro col
definisce la colonna su cui viene posizionato il bordo sinistro dell'elemento.
Le dashboard sono divise in 24 colonne. La dashboard inizia con la colonna 0, a sinistra della dashboard. Per impostazione predefinita, una dashboard con layout del giornale ha una larghezza degli elementi di 8 colonne, il che significa che gli elementi della dashboard a sinistra di una dashboard (col: 0
) occupano le colonne da 0 a 7 per impostazione predefinita.
Ad esempio, il seguente codice imposta un elemento da impostare nella terza colonna di elementi della dashboard:
- dashboard: sales_overview
layout: newspaper
...
elements:
- name: orders_by_date
col: 16
...
Parametri di testo
I parametri descritti in questa sezione possono essere utilizzati per aggiungere contenuti a un elemento della dashboard LookML di type: text
.
title_text
Il parametro title_text
specifica il testo che verrà visualizzato su un elemento type: text
nelle dimensioni carattere più grandi disponibili. È indicato nella parte superiore del riquadro.
title_text: title text
subtitle_text
Il parametro subtitle_text
consente di specificare il testo che verrà visualizzato in un elemento type: text
nelle dimensioni del carattere centrale disponibili. Se è presente title_text
, sotto verrà visualizzato subtitle_text
.
subtitle_text: subtitle text
body_text
Il parametro body_text
consente di specificare il testo che verrà visualizzato in un elemento type: text
con le dimensioni carattere più piccole disponibili. Questo parametro viene mostrato per ultimo nel riquadro di testo. La pagina della documentazione Utilizzo di Markdown nei riquadri di Markdown offre una panoramica di Markdown che puoi utilizzare per formattare il testo o aggiungere link e immagini in un riquadro di testo.
body_text: body text