Parametri del riquadro di testo per le dashboard LookML

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 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 layout: tile e layout: static
width (per gli elementi)	Definisce la larghezza di un elemento in unità di tile_size per le dashboard 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 layout: static
left	Definisce la posizione da sinistra a destra di un elemento in unità di tile_size per le dashboard layout: static
row	Definisce la posizione dall'alto verso il basso di un elemento in unità di righe per le dashboard layout: newspaper
col	Definisce la posizione da sinistra a destra di un elemento in unità di colonne per le dashboard 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 corpo del testo per un elemento della dashboard di type: text

Parametri base

Quando definisci un elemento della dashboard LookML di type: text, devi specificare i valori almeno per 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 dedicata ai 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 indicati nel parametro elements quando utilizzi le dashboard layout: grid o nel parametro group degli elementi secondari quando organizzi gli elementi in un gruppo di riquadri (type: group).

- 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 dedicata ai parametri della dashboard.

type può essere utilizzato anche nell'ambito di un join, come spiegato nella pagina della documentazione dedicata al parametro type (per i join).

type può essere utilizzato anche come parte di una dimensione, come descritto nella pagina della documentazione Tipi di dimensioni, filtri e parametri.

type può essere utilizzato anche come parte di una misura, descritta 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 | button | group

Per una panoramica dei diversi tipi di elementi della dashboard LookML, consulta la pagina della documentazione type (per le dashboard 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, descritta nella pagina della documentazione relativa ai 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 codice seguente 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 row, per le dashboard layout: newspaper.

Per impostazione predefinita, una dashboard con layout di giornale ha un'altezza degli elementi 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 in modo che sia alto 12 righe, ovvero il 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 nell'ambito di una dashboard, come descritto nella pagina della documentazione dedicata ai parametri della dashboard.

Il parametro width definisce la larghezza di un elemento, in unità di tile_size, per le 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 le dashboard layout: newspaper.

Una dashboard con layout di tipo giornale ha una larghezza predefinita di 24 colonne.

Ad esempio, il seguente codice imposta l'elemento su metà della 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 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 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 layout: static.

Ad esempio, il codice seguente 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 layout: newspaper, il parametro row definisce la riga su cui viene posizionato il bordo superiore di un elemento. Se l'elemento viene inserito in un gruppo di riquadri utilizzando il parametro group, row definisce la posizione della riga dell'elemento rispetto alla parte superiore del contenitore del gruppo (row: 0).

Una dashboard inizia con la riga 0 nella parte superiore. Una dashboard con layout di tipo 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) occuperebbero per impostazione predefinita le righe 0-5.

Ogni riga è alta 50 pixel, il che significa che l'altezza predefinita dell'elemento di 6 righe è di 300 pixel.

Ad esempio, il seguente codice imposta un elemento da inserire nella seconda riga di elementi della dashboard, supponendo che gli elementi siano impostati sull'altezza predefinita:

- dashboard: sales_overview
  layout: newspaper
  ...

  elements:
  - name: orders_by_date
    row: 6
    ...

col

Per le dashboard layout: newspaper, il parametro col definisce la colonna in cui è posizionato il bordo sinistro dell'elemento. Se l'elemento viene inserito in un gruppo di riquadri utilizzando il parametro group, col definisce la posizione della colonna dell'elemento rispetto al bordo sinistro del contenitore del gruppo (col: 0).

Le dashboard sono suddivise in 24 colonne. Una dashboard inizia con la colonna 0 a sinistra. Una dashboard con layout di tipo 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) occuperebbero per impostazione predefinita le colonne 0-7.

Ad esempio, il seguente codice imposta un elemento da inserire nella terza colonna di elementi della dashboard:

- dashboard: sales_overview
  layout: newspaper
  ...

  elements:
  - name: orders_by_date
    col: 16
    ...

Parametri di testo

Il LookML della dashboard generato dai riquadri di testo creati con l'opzione Testo nell'interfaccia utente di Looker non utilizzerà i parametri title_text o subtitle_text.

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 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 su 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 su 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 di testo fornisce una panoramica del linguaggio Markdown che puoi utilizzare per formattare il testo o per aggiungere link e immagini a un riquadro di testo.

body_text: body text